linuxa11y / iaccessible2 Goto Github PK

The "level" object attribute for IAccessible2 to specify the level of a heading is both mentioned in the Core Accessibility API Mappings specification and in the IAccessible2::groupPosition documentation.

Quoting from the latter (emphasis added):

This method is meant to describe the nature of an object's containment
structure. It's exposed by trees, tree grids, nested lists, nested
menus, but not headings, which uses the level object attribute.

However, the "level" object attribute for headings is currently not documented in the object attributes specification and should therefore be added (either explicitly, or alternatively by mentioning that the attributes as specified in the above-mentioned ARIA Core Accessibility API Mapping specification apply in general, if that's the case).

The spec does mention the "level" attribute for lists, but not for headings.

Being able to document this attribute might depend on issue #24 / PR #27.

Related issue/PR for NVDA:
nvaccess/nvda#15881
nvaccess/nvda#15882

Content sometimes needs to indicate a content insertion/deletion (can be proposed change to content or has already occurred). In HTML this is indicated with the <ins> and <del> tags. Also, ARIA 1.2 plans to add roles for this. This will be very useful for online collaborative word processors and editors, such as Google Docs.

Mick Curran suggested that this be a text attribute. For example: diff:del and diff:ins. It could also be a role.

I suggest going with Mick's recommendation unless there's a counter proposal.

IAccessibleText .textAttributes says:

    A string of attributes describing the text.  The attributes are described in the
    <a href="http://www.linuxfoundation.org/en/Accessibility/IAccessible2/TextAttributes">
    text attributes specification</a> on the %IAccessible2 web site."

However that page does not exist.

By using the search field, I did find text attribute info here:
https://wiki.linuxfoundation.org/accessibility/iaccessible2/textattributes?s[]=text&s[]=attributes

However, who knows when that page will die. Shouldn't everything in the IA2 spec be moved over here? There are probably other problems like this. Future engineers (and me, currently), need access to the spec.

The only place I could find where this is currently documented is here:
https://wiki.linuxfoundation.org/accessibility/iaccessible2/textattributes

Follow up from #11.

The IAccessible2 text attributes specification is currently hosted on the Linux Foundation wiki. We should move it into this repository. This will probably involve converting it to Markdown.

CC @aleventhal.

On the web, "description-from" has one one the following values:

• "aria-description"
• "aria-describedby"
• "ruby-annotation"
• "summary"
• "table-caption"
• "tooltip" (either via @title or aria-describedby + role="tooltip")
• "button-label" (when the name came from other markup such as aria-label)

@jcsteh, should Accessible2_3.idl be included in build tools? It doesn't exist in concatidl.sh.

@michaelDCurran, I'm trying to add the IAccessibleTextSelectionContainer interface into NVDA. There is a compile error. I want to synchronize NVDA scripts with that of this repository. However, I'm not sure if there is a change that needs to be made here.