HTML Accessibility API Mappings (HTML-AAM) defines how user agents map HTML [[HTML]] elements and attributes to platform accessibility application programming interfaces (APIs). It leverages and extends the [[[core-aam-1.2]]] and the [[[accname-1.2]]] for use with the HTML host language. Documenting these mappings promotes interoperable exposure of roles, states, properties, and events implemented by accessibility APIs and helps to ensure that this information appears in a manner consistent with author intent.
The HTML-AAM is part of the WAI-ARIA suite described in the WAI-ARIA Overview.
This document is subject to change without notice.
This document was initially developed by and with the approval of the HTML Accessibility Taskforce, a joint task force of the Protocols and Formats Working Group and the HTML Working Group. Work continued with the successor groups Accessible Rich Internet Applications Working Group and the Web Applications Working Group. This document is now maintained solely by the Accessible Rich Internet Applications Working Group.
This specification defines how HTML user agents respond to and expose [=role=], [=state=] and [=ARIA/property=] information provided for Web content. Unless indicated otherwise, an HTML element or attribute with default [[[wai-aria-1.2]]] semantics must be exposed to the platform accessibility APIs according to the relevant WAI-ARIA mappings defined in the [[[core-aam-1.2]]] specification.
In some cases, often due to features of the HTML host language or the accessibility API in question, an element or attribute's mapping differs from the corresponding ARIA mappings specified in the [[core-aam-1.2]]. Where an HTML element or attribute does not have any default WAI-ARIA semantics, the applicable mapping for each platform accessibility API is defined by this specification.
This document also adapts the [[[accname-1.2]]] specification for deriving the accessible names and accessible descriptions of [[HTML]] elements, and provides accessible implementation examples for specific HTML elements and features.
Users often access HTML content using assistive technologies that rely on platform accessibility API to obtain and interact with information from the page. This document is part of the following suite of accessibility API mapping specifications for content rendered by user agents:
Accessibility APIs covered by this document are:
If user agent developers need to expose information using other accessibility APIs, it is recommended that they work closely with the developer of the platform where the API runs, and assistive technology developers on that platform.
For more information regarding accessibility APIs, refer to section 1.1 Accessibility APIs of the [[[core-aam-1.2]]].
Normative sections provide requirements that user agents and assistive technologies MUST follow for an implementation to conform to this specification.
Non-normative (informative) sections provide information useful to understanding the specification. Such sections may contain examples of recommended practice, but it is not required to follow such recommendations in order to conform to this specification.
There are currently no deprecated requirements.
WAI-ARIA support was first introduced to HTML in [[HTML5]].
User Agents MUST expose HTML elements or attributes with default WAI-ARIA semantics to the platform accessibility APIs in a way that conforms to General rules for exposing WAI-ARIA semantics in the [[[core-aam-1.2]]].
Where the host language is [[HTML]], user agents MUST conform to Conflicts between native markup semantics and WAI-ARIA in the [[[core-aam-1.2]]].
HTML can include features that are not supported by accessibility APIs at the time of publication. There is not a one to one relationship between all features and platform accessibility APIs. When HTML roles, states and properties do not directly map to an accessibility API, and there is a method in the API to expose a text string, user agents MUST expose the undefined role, states and properties via that method.
For HTML elements or attributes with default WAI-ARIA semantics, user agents MUST conform to Exposing attributes that do not directly map to accessibility API properties in the [[core-aam-1.2]].
A minimum role is the equivalent WAI-ARIA role an element will map to if the element does not have a more specific implicit role or platform role mappings, e.g., a non-generic role. This can help ensure that users of assistive technologies get the best possible experience for commonly-used and valid HTML markup where otherwise a role would not be exposed.
A minimum role is provided when all of the following conditions are true:
The HTML Attribute State and Property Mappings section identifies the specific global attributes which would require an element map to a minimum role.
When these conditions are met, user agents MUST expose an object using the mappings defined in CORE-AAM for the specified minimum role. If the element has multiple attributes specified which require a minimum role be returned as the computed role for the element, prioritize the more specific role in the ARIA taxonomy.
<video> <!-- computedrole returns 'html-video' --> <main role="html-video"> <!-- Author error. computed role returns 'main' -->
| HTML Specification | `a` (represents a hyperlink) |
|---|---|
| [[wai-aria-1.2]] | `link` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `a` (no `href` attribute) |
|---|---|
| [[wai-aria-1.2]] | `generic` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `abbr` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | `html-abbr` |
| MSAA + IAccessible2 |
Roles: `ROLE_SYSTEM_TEXT`; `IA2_ROLE_TEXT_FRAME`
Object attributes:
"abbr" attribute on the containing `td` if a single child, text content used as a value
|
| UIA |
Control Type: `Text`
|
| [[ATK]] |
Role: `ATK_ROLE_STATIC`
Object attributes:
"abbr" attribute on the containing `td` if a single child, text content used as a value
|
| AX |
AXRole: `AXGroup`
AXSubrole: `(nil)`
AXRoleDescription: `"group"`
|
| Comments |
| HTML Specification | `address` |
|---|---|
| [[wai-aria-1.2]] | `group` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `area` (represents a hyperlink) |
|---|---|
| [[wai-aria-1.2]] | `link` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `area` (no `href` attribute) |
|---|---|
| [[wai-aria-1.2]] | `generic` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments | User agents MAY still expose an `a` element lacking the `href` attribute with a `link` role in the event an author specifies interactive behavior for the element. For example, if using an event handler attribute. |
| HTML Specification | `article` |
|---|---|
| [[wai-aria-1.2]] | `article` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `aside` (scoped to the `body` or `main` element) |
|---|---|
| [[wai-aria-1.2]] | `complementary` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `aside` (scoped to a sectioning content element) |
|---|---|
| [[wai-aria-1.2]] | `complementary` role if the `aside` element has an accessible name. Otherwise, `generic` role. |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `audio` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | `html-audio` |
| MSAA + IAccessible2 |
Role: `ROLE_SYSTEM_GROUPING`
|
| UIA |
Control Type: `Group`
Localized Control Type: `"audio"`
Note: If the `controls` attribute is present, UI controls (e.g., play, volume) are exposed as children of the
`audio` element in the accessibility tree, and mapped as appropriate for the type of control (e.g.,
`button` or `slider`).
User agents MAY include the following in the accessibility tree and mark them as hidden or off-screen:
|
| [[ATK]] |
Role: `ATK_ROLE_AUDIO`
|
| AX |
AXRole: `AXGroup`
AXSubrole: `AXAudio`
AXRoleDescription: `"audio playback"`
Note: If the `controls` attribute is present, UI controls (e.g., play, volume) are exposed as descendants of an
accessible object with a role of `toolbar`, and mapped as appropriate for the type of control (e.g.,
`button` or `slider`).
|
| Comments |
| HTML Specification | autonomous custom element |
|---|---|
| [[wai-aria-1.2]] | If the author assigned a conforming ARIA role using the `role` attribute, map to that role. Otherwise, the `generic` role. |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `b` |
|---|---|
| [[wai-aria-1.2]] | `generic` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments | Exposed by platform specific bold font weight text styles. |
| HTML Specification | `base` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | Not mapped |
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `bdi` |
|---|---|
| [[wai-aria-1.2]] | `generic` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments | IA2/ATK: May affect on "writing-mode" text attribute on its text container. |
| HTML Specification | `bdo` |
|---|---|
| [[wai-aria-1.2]] | `generic` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments | IA2/ATK: Exposed as "writing-mode" text attribute on its text container. |
| HTML Specification | `blockquote` |
|---|---|
| [[wai-aria-1.2]] | `blockquote` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `body` |
|---|---|
| [[wai-aria-1.2]] | `generic` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments | User agents MUST ignore the `aria-hidden` attribute if specified on the `body` element. |
| HTML Specification | `br` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | Not mapped |
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments | May be exposed as '\n' character by the platform interface. |
| HTML Specification | `button` |
|---|---|
| [[wai-aria-1.2]] | `button` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments | A `button`'s mapping will change if the `aria-pressed` or `aria-haspopup` attributes are specified. |
| HTML Specification | `canvas` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | `html-canvas` |
| MSAA + IAccessible2 |
Roles: `ROLE_SYSTEM_GRAPHIC`; `IA2_ROLE_CANVAS`
|
| UIA |
Control Type: `Image`
Descendants of the `canvas` element are mapped separately.
|
| [[ATK]] |
Role: `ATK_ROLE_CANVAS`
|
| AX |
AXRole: `AXGroup`
AXSubrole: `(nil)`
AXRoleDescription: `""`
|
| Comments |
| HTML Specification | `caption` |
|---|---|
| [[wai-aria-1.2]] | `caption` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
Relations:
`IA2_RELATION_LABEL_FOR` with parent `table`
|
| UIA |
Use WAI-ARIA mapping
Other properties:
The `LabeledBy` property for the parent `table` element points to the UIA element for the `caption` element.
|
| [[ATK]] |
Use WAI-ARIA mapping
Relations:
`ATK_RELATION_LABEL_FOR` with parent `table`
|
| AX |
Use WAI-ARIA mapping
Relations:
`ATK_RELATION_LABEL_FOR` with parent `table`
|
| Comments |
If a `caption` element is [=element/hidden=] from the accessibility tree, then it will not provide an accessible name to its parent `table` element. |
| HTML Specification | `cite` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | `html-cite` |
| MSAA + IAccessible2 |
No accessible object. Styles used are mapped into text attributes on its text container.
|
| UIA |
No accessible object. Styles used are exposed by UIA text attributes of the `TextRange` Control Pattern implemented on a parent accessible object.
|
| [[ATK]] |
No accessible object. Styles used are mapped into text attributes on its text container.
|
| AX |
AXRole: `AXGroup`
AXSubrole: `(nil)`
AXRoleDescription: `"group"`
|
| Comments |
| HTML Specification | `code` |
|---|---|
| [[wai-aria-1.2]] | `code` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `col` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | Not mapped |
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `colgroup` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | Not mapped |
| MSAA + IAccessible2 |
Role: `ROLE_SYSTEM_GROUPING`
|
| UIA |
Control Type: `Group`
Localized Control Type: `"colgroup"`
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `data` |
|---|---|
| [[wai-aria-1.2]] | `generic` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `datalist` (represents pre-defined options for `input` element) |
|---|---|
| [[wai-aria-1.2]] | `listbox` role, with the `aria-multiselectable` property set to "true" if the `datalist`'s selection model allows multiple `option` elements to be selected at a time, and "false" otherwise |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments | If `datalist` is not linked to a proper `input` element, then `datalist` element is not mapped to accessibility APIs. |
| HTML Specification | `dd` |
|---|---|
| [[wai-aria-1.2]] | `definition` role |
| Computed Role |
Use WAI-ARIA mapping
Editorial Note: This value may change upon resolution of ARIA #1662.
|
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `del` |
|---|---|
| [[wai-aria-1.2]] | `deletion` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `details` |
|---|---|
| [[wai-aria-1.2]] | `group` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
Localized Control Type: `"details"`
|
| [[ATK]] |
Use WAI-ARIA mapping
Relations: `"ATK_RELATION_DETAILS_FOR"`
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `dfn` |
|---|---|
| [[wai-aria-1.2]] | `term` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `dialog` |
|---|---|
| [[wai-aria-1.2]] | `dialog` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments | See also the `dialog` element's `open` attribute. |
| HTML Specification | `dir` |
|---|---|
| [[wai-aria-1.2]] | `list` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| ATK |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments | The `dir` element is marked as obsolete in HTML, and is not to be used by authors. |
| HTML Specification | `div` |
|---|---|
| [[wai-aria-1.2]] | `generic` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `dl` |
|---|---|
| [[wai-aria-1.2]] | `list` role |
| Computed Role |
list
Editorial Note: This value may change upon resolution of ARIA #1662.
|
| MSAA + IAccessible2 |
Role: `ROLE_SYSTEM_LIST`
States: `STATE_SYSTEM_READONLY`
|
| UIA |
Control Type: `List`
|
| [[ATK]] |
Role: `ATK_ROLE_DESCRIPTION_LIST`
|
| AX |
AXRole: `AXList`
AXSubrole: `AXDefinitionList`
AXRoleDescription: `"definition list"`
|
| Comments |
| HTML Specification | `dt` |
|---|---|
| [[wai-aria-1.2]] | `term` role |
| Computed Role |
Use WAI-ARIA mapping
Editorial Note: This value may change upon resolution of ARIA #1662.
|
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `em` |
|---|---|
| [[wai-aria-1.2]] | `emphasis` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `embed` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | `html-embed` |
| MSAA + IAccessible2 |
Roles: `ROLE_SYSTEM_CLIENT`; `IA2_ROLE_EMBEDDED_OBJECT`
States: `STATE_SYSTEM_UNAVAILABLE` for windowless plugin
|
| UIA |
Control Type: `Pane`
|
| [[ATK]] |
Role: `ATK_ROLE_EMBEDDED`
|
| AX | Depends on format of data file |
| Comments |
| HTML Specification | `fieldset` |
|---|---|
| [[wai-aria-1.2]] | `group` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Role: Use WAI-ARIA mapping
Relations: `IA2_RELATION_LABELLED_BY` with the first instance of a rendered child `legend` element
|
| UIA |
Role: Use WAI-ARIA mapping
|
| [[ATK]] |
Role: Use WAI-ARIA mapping
Relations: `ATK_RELATION_LABELLED_BY` with first instance of a rendered child `legend` element
|
| AX |
Role: Use WAI-ARIA mapping
AXSubrole: `AXFieldset`
AXDescription: value from the first instance of a rendered child `legend` element
|
| Comments |
If a `legend` element is [=element/hidden=] from the accessibility tree, then it will not provide an accessible name to its parent `fieldset` element. |
| HTML Specification | `figcaption` |
|---|---|
| [[wai-aria-1.2]] | `caption` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Role: Use WAI-ARIA mapping
|
| UIA |
Role: Use WAI-ARIA mapping
|
| [[ATK]] |
Role: Use WAI-ARIA mapping
|
| AX |
Role: Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `figure` |
|---|---|
| [[wai-aria-1.2]] | `figure` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Role: Use WAI-ARIA mapping
|
| UIA |
Role: Use WAI-ARIA mapping
|
| [[ATK]] |
Role: Use WAI-ARIA mapping
|
| AX |
AXRole: Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `footer` (scoped to the `body` element) |
|---|---|
| [[wai-aria-1.2]] | `contentinfo` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `footer` (scoped to the `main` element, or a sectioning content element) |
|---|---|
| [[wai-aria-1.2]] | `generic` role |
| Computed Role |
Use WAI-ARIA mapping
Editorial Note: This value may change upon resolution of ARIA #1915.
|
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Control Type: `Group`
Localized Control Type: `"footer"`
|
| [[ATK]] |
Role: `ATK_ROLE_FOOTER`
|
| AX |
Use WAI-ARIA mapping
|
| Comments | If a `footer` is not scoped to the `body` element, do not expose the element as a `contentinfo` landmark. |
| HTML Specification | `form` |
|---|---|
| [[wai-aria-1.2]] | `form` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
If a `form` has no accessible name:
Role: `ATK_ROLE_FORM`
|
| AX |
Use WAI-ARIA mapping
|
| Comments | If a `form` has no accessible name, do not expose the element as a landmark. |
| HTML Specification | form-associated custom element |
|---|---|
| [[wai-aria-1.2]] | If the author assigned a conforming ARIA role using the `role` attribute, map to that role. Otherwise, the `generic` role. |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `h1`, `h2`, `h3`, `h4`, `h5`, and `h6` |
|---|---|
| [[wai-aria-1.2]] | `heading` role, with the `aria-level` property set to the number in the element's tag name. |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `head` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | Not Mapped |
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `header` (scoped to the `body` element) |
|---|---|
| [[wai-aria-1.2]] | `banner` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `header` (scoped to the `main` element, or a sectioning content element) |
|---|---|
| [[wai-aria-1.2]] | `generic` role |
| Computed Role |
Use WAI-ARIA mapping
Editorial Note: This value may change upon resolution of ARIA #1915.
|
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Control Type: `Group`
Localized Control Type: `"header"`
|
| [[ATK]] |
Role: `ATK_ROLE_HEADER`
|
| AX |
Use WAI-ARIA mapping
|
| Comments | If a `header` is not scoped to the `body` element, do not expose the element as a `banner` landmark. |
| HTML Specification | `hgroup` |
|---|---|
| [[wai-aria-1.2]] | `group` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments | If an `hgroup` contains multiple heading elements, then the user agent MAY treat the heading element with the highest priority level as the sole heading of the `hgroup`. The user agent MAY expose all other heading elements as if they were `p` elements. See `paragraph` role on Core AAM. |
| HTML Specification | `hr` |
|---|---|
| [[wai-aria-1.2]] | `separator` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
If an `hr` element is a descendant of a `select` element, user agents MAY expose the element with a role of `none`. |
| HTML Specification | `html` |
|---|---|
| [[wai-aria-1.2]] | `generic` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
User agents MUST ignore the `aria-hidden` attribute if specified on the `html` element. The `document` role of a web page is not exposed by the `html` element, but rather from a parent `document node` created by the user agent. |
| HTML Specification | `i` |
|---|---|
| [[wai-aria-1.2]] | `generic` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments | Exposed by platform specific italic text styles. |
| HTML Specification | `iframe` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | `html-iframe` |
| MSAA + IAccessible2 |
Role: `IA2_ROLE_INTERNAL_FRAME`
|
| UIA |
Control Type: `Pane`
|
| [[ATK]] |
Role: `ATK_ROLE_INTERNAL_FRAME`
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `img` |
|---|---|
| [[wai-aria-1.2]] | `image` or `img` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
ARIA 1.3 adds the `image` role as the preferred synonym to the ARIA 1.0 `img` role. The expected computed role for named `img` elements is now "image". |
| HTML Specification | `img` (`alt` attribute value, when trimmed of [=ascii whitespace|whitespace=], is the empty string, i.e., `alt=""`, `alt=" "`, or `alt` with no value in the markup) |
|---|---|
| [[wai-aria-1.2]] | |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
If an `img` has an empty `alt`, but has been provided an accessible name via another valid naming mechanism per the naming steps of this specification, user agents will expose the element with its implicit `image` role. |
| HTML Specification | `input` (`type` attribute in the Button state) |
|---|---|
| [[wai-aria-1.2]] | `button` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `input` (`type` attribute in the Checkbox state) |
|---|---|
| [[wai-aria-1.2]] | `checkbox` role, with the `aria-checked` state set to "mixed" if the element's `indeterminate` IDL attribute is true, or "true" if the element's checkedness is true, or "false" otherwise |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `input` (`type` attribute in the Color state) |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | `html-input-color` |
| MSAA + IAccessible2 |
If implemented as a textbox:
Roles: `ROLE_SYSTEM_TEXT`
If implemented as a color picker:
Roles: `IA2_ROLE_COLOR_CHOOSER`
|
| UIA |
If implemented as a textbox:
Control Type: `Edit`
Localized Control Type: "edit"
If implemented as a color picker:
Control Type: `button`
Localized Control Type: "color picker"
|
| [[ATK]] |
If implemented as a button, use WAI-ARIA mapping for `button`.
If implemented as a textbox, use WAI-ARIA mapping for `textbox`.
|
| AX |
If implemented as a textbox:
AXRole: `AXTextField`
AXSubrole: `(nil)`
AXRoleDescription: `"text field"`
If implemented as a color picker:
AXRole: `AXColorWell`
AXSubrole: `(nil)`
AXRoleDescription: `"color well"`
|
| Comments |
If implemented as a color picker, any UI controls presented for selecting a color are exposed in the accessibility tree, associated with the `input` element,
and mapped as appropriate for the type of control (e.g., button or slider).
|
| HTML Specification | `input` (`type` attribute in the Date state) |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | `html-input-date` |
| MSAA + IAccessible2 |
If implemented as a textbox:
Role: `ROLE_SYSTEM_TEXT`
Object attributes: `text-input-type:date`
If implemented as a date picker:
Role: `IA2_ROLE_DATE_EDITOR`
|
| UIA |
Depends on UI design of implementation. The UI in Windows 10 Edge, for example, is a composite of multiple spinners.
|
| [[ATK]] |
Role: `ATK_ROLE_CALENDAR`
|
| AX |
AXRole: `AXDateField`
AXSubrole: `(nil)`
AXRoleDescription: `"date field"`
|
| Comments |
| HTML Specification | `input` (`type` attribute in the Local Date and Time state) |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | `html-input-datetime-local` |
| MSAA + IAccessible2 |
Role: `IA2_ROLE_DATE_EDITOR`
|
| UIA |
Depends on UI design of implementation. The UI in Windows 10 Edge, for Example, is a composite of multiple spinners.
|
| [[ATK]] |
Role: `ATK_ROLE_CALENDAR`
|
| AX |
AXRole: `AXTextField`
AXSubrole: `(nil)`
AXRoleDescription: `"text field"`
|
| Comments |
| HTML Specification | `input` (`type` attribute in the E-mail state with no suggestions source element) |
|---|---|
| [[wai-aria-1.2]] | `textbox` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
Object attributes: `text-input-type:email`
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `input` (`type` attribute in the File Upload state) |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | `html-input-file` |
| MSAA + IAccessible2 |
Implementation dependent. If represented by a container with a button a text label inside then:
Roles: `IA2_ROLE_TEXT_FRAME`
Children: `ROLE_SYSTEM_PUSHBUTTON` and `IA2_ROLE_LABEL` for a button and a text label elements.
|
| UIA |
Can be rendered as a single button control, or as a button control with a text input field.
Button control:
Control Type: `Button`
Text input field:
Control Type: `Edit`
Localized Control Type: `"file"`
|
| [[ATK]] |
Role: `ATK_ROLE_STATIC`
Children:
`ATK_ROLE_PUSH_BUTTON` when pressed `ATK_ROLE_FILE_CHOOSER` dialog shown
|
| AX |
AXRole: `AXButton`
AXSubrole: `AXFileUploadButton`
AXRoleDescription: `file upload button`
|
| Comments |
| HTML Specification | `input` (`type` attribute in the Hidden state) |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | Not mapped |
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `input` (`type` attribute in the Image Button state) |
|---|---|
| [[wai-aria-1.2]] | `button` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `input` (`type` attribute in the Month state) |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | `html-input-month` |
| MSAA + IAccessible2 |
Role: `IA2_ROLE_DATE_EDITOR`
|
| UIA |
Depends on UI design of implementation. The UI in Windows 10 Edge, for Example, is a composite of multiple spinners.
|
| [[ATK]] |
Role: `ATK_ROLE_DATE_EDITOR`
|
| AX |
AXRole: `AXTextField`
AXSubrole: `(nil)`
AXRoleDescription: `"text field"`
|
| Comments |
| HTML Specification | `input` (`type` attribute in the Number state) |
|---|---|
| [[wai-aria-1.2]] | `spinbutton` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
If implemented as a spin button, use WAI-ARIA mapping for
`spinbutton`.
If implemented as a text input, use WAI-ARIA mapping for
`textbox`.
Object attributes: `text-input-type:number`
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
If implemented as a spin button, use WAI-ARIA mapping for `spinbutton`.
If implemented as a text input, use WAI-ARIA mapping for `textbox`.
Object attributes: `text-input-type:number`
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `input` (`type` attribute in the Password state) |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | `html-input-password` |
| MSAA + IAccessible2 |
Role: `ROLE_SYSTEM_TEXT`
States: `STATE_SYSTEM_PROTECTED`; `IA2_STATE_SINGLE_LINE`; `STATE_SYSTEM_READONLY` if readonly, otherwise `IA2_STATE_EDITABLE`
|
| UIA |
Control Type: `Edit`
Other properties: `isPassword=true`
|
| [[ATK]] |
Role: `ATK_ROLE_PASSWORD_TEXT`
States: `ATK_STATE_SINGLE_LINE`; `ATK_STATE_READ_ONLY` if readonly, otherwise `ATK_STATE_EDITABLE`
|
| AX |
AXRole: `AXTextField`
AXSubrole: `AXSecureTextField`
AXRoleDescription: `"secure text field"`
|
| Comments |
| HTML Specification | `input` (`type` attribute in the Radio Button state) |
|---|---|
| [[wai-aria-1.2]] | `radio` role, with the `aria-checked` state set to "true" if the element's checkedness is true, or "false" otherwise. With `aria-setsize` value reflecting number of `type=radio input` elements within the radio button group and `aria-posinset` value reflecting the elements position within the radio button group. |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `input` (`type` attribute in the Range state) |
|---|---|
| [[wai-aria-1.2]] | `slider` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `input` (`type` attribute in the Reset Button state) |
|---|---|
| [[wai-aria-1.2]] | `button` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `input` (`type` attribute in the Search state with no suggestions source element) |
|---|---|
| [[wai-aria-1.2]] | `searchbox` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `input` (`type` attribute in the Submit Button state) |
|---|---|
| [[wai-aria-1.2]] | `button` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `input` (`type` attribute in the Telephone state with no suggestions source element) |
|---|---|
| [[wai-aria-1.2]] | `textbox` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
Object attributes: `text-input-type:telephone`
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `input` (`type` attribute in the Text state with no suggestions source element) |
|---|---|
| [[wai-aria-1.2]] | `textbox` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `input` (`type` attribute in the Text, Search, Telephone, URL, or E-mail states with a suggestions source element) |
|---|---|
| [[wai-aria-1.2]] | `combobox` role, with the `aria-controls` property set to the same value as the `list` attribute |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
Object attributes: `text-input-type:``as per input type`
|
| UIA |
Use WAI-ARIA mapping
Other properties: `ControllerFor` points to the suggestions source element
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `input` (`type` attribute in the Time state) |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | `html-input-time` |
| MSAA + IAccessible2 |
Role: `ROLE_SYSTEM_SPINBUTTON` if implemented as a simple widget; `ROLE_SYSTEM_GROUPING` with child controls mapped as appropriate if
implemented as a complex widget
Object attributes: `text-input-type:time`
|
| UIA |
Depends on UI design of implementation. The UI in Windows 10 Edge, for Example, is a composite of multiple spinners.
|
| [[ATK]] | |
| AX |
AXRole: `AXTimeField`
AXSubrole: `(nil)`
AXRoleDescription: `"time field"`
|
| Comments |
| HTML Specification | `input` (`type` attribute in the URL state with no suggestions source element) |
|---|---|
| [[wai-aria-1.2]] | `textbox` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
Object attributes: `text-input-type:url`
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `input` (`type` attribute in the Week state) |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | `html-input-week` |
| MSAA + IAccessible2 |
Role: `IA2_ROLE_DATE_EDITOR`
Object attributes: `text-input-type:week`
|
| UIA |
Depends on UI design of implementation. The UI in Windows 10 Edge, for Example, is a composite of multiple spinners.
|
| [[ATK]] |
Role: `ATK_ROLE_CALENDAR`
|
| AX |
AXRole: `AXTextField`
AXSubrole: `(nil)`
AXRoleDescription: `"text field"`
|
| Comments |
| HTML Specification | `ins` |
|---|---|
| [[wai-aria-1.2]] | `insertion` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `kbd` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | `html-kbd` |
| MSAA + IAccessible2 |
No accessible object.
Text attributes: `font-family:monospace` on the text container
|
| UIA |
No accessible object. Styles used are exposed by UIA text attribute identifiers of the `TextRange` Control Pattern implemented on a parent accessible object.
|
| [[ATK]] |
No accessible object. Mapped into "font-family:monospace" text attribute on its text container.
|
| AX |
AXRole: `AXGroup`
AXSubrole: `(nil)`
AXRoleDescription: `"group"`
|
| Comments |
| HTML Specification | `label` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | `html-label` |
| MSAA + IAccessible2 |
Roles: `ROLE_SYSTEM_STATICTEXT`; `IA2_ROLE_LABEL`
Relations:
`IA2_RELATION_LABEL_FOR` with a labelable element that is child to the `label` or referred to by the `label` element's
`for` attribute. The associated labelable element has `IA2_RELATION_LABELLED_BY` pointing to the `label`.
|
| UIA |
Control Type: `Group`
Relations:
When the `label` element contains a labelable element, the `LabeledBy` property for the element points to the UIA element for the
`label` element.
When the `label` element has a `for` attribute referencing a labelable element, the `LabeledBy`
property for the referenced element points to the UIA element for the `label` element.
|
| [[ATK]] |
Role: `ATK_ROLE_LABEL`
Relations:
`ATK_RELATION_LABEL_FOR` for a child labelable element or labelable element referred by
`for` attribute. Note, related labelable element provides `ATK_RELATION_LABELLED_BY` pointing to the `label`.
|
| AX |
AXRole: `AXGroup`
AXSubrole: `(nil)`
AXRoleDescription: `"group"`
|
| Comments |
If a `label` element is [=element/hidden=] from the accessibility tree, then it will not provide an accessible name to the labelable element it is associated with. |
| HTML Specification | `legend` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | `html-legend` |
| MSAA + IAccessible2 |
Roles: `ROLE_SYSTEM_STATICTEXT`; `IA2_ROLE_LABEL`
Relations: `IA2_RELATION_LABEL_FOR` with the parent `fieldset`
|
| UIA |
Control Type: `Text`
Other properties:
The `LabeledBy` property for the parent
`fieldset` points to the UIA element for the `legend` element.
|
| [[ATK]] |
Role: `ATK_ROLE_LABEL`
Relations:
`ATK_RELATION_LABEL_FOR` with parent `fieldset` element
|
| AX |
AXRole: `AXGroup`
AXSubrole: `(nil)`
AXRoleDescription: `"group"`
|
| Comments |
| HTML Specification | `li` |
|---|---|
| [[wai-aria-1.2]] | `listitem` role with `aria-setsize` value reflecting number of `li` elements within the parent `ol`, `menu` or `ul` and `aria-posinset` value reflecting the `li` elements position within the set. |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments | If `li` element is not a child of `ol` , `menu` or `ul`, or if the containing list element is no longer exposed with a `list` role, then expose the `li` element with a `generic` role. |
| HTML Specification | `link` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | Not mapped |
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `main` |
|---|---|
| [[wai-aria-1.2]] | `main` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `map` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | `html-map` |
| MSAA + IAccessible2 |
Not mapped if used as an image map. Otherwise,
Role: `IA2_ROLE_TEXT_FRAME`
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped if used as an image map, otherwise:
Role: `ATK_ROLE_STATIC`
|
| AX |
Role: `AXImageMap` if used as an image map. Otherwise,
Role: `AXGroup` if associated with an `img` with no `alt`. Otherwise, not mapped if not associated with an `img`. |
| Comments |
| HTML Specification | `mark` |
|---|---|
| [[wai-aria-1.2]] | `mark` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `math` |
|---|---|
| [[wai-aria-1.2]] | See comments |
| Computed Role | See comments |
| MSAA + IAccessible2 | See comments |
| UIA | See comments |
| [[ATK]] | See comments |
| AX | See comments |
| Comments | Mapping for `math` is defined by MathML AAM 1.0. |
| HTML Specification | `menu` |
|---|---|
| [[wai-aria-1.2]] | `list` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
The `menu` element is a semantic alternative to the `ul` element. It has no implemented mappings or behavior that reflect the semantics
of the ARIA `menu` role.
Note obsolete `menuitem` element and `menu` with `type` attribute.
|
| HTML Specification | `meta` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | Not mapped |
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `meter` |
|---|---|
| [[wai-aria-1.2]] | `meter` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `nav` |
|---|---|
| [[wai-aria-1.2]] | `navigation` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `noscript` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | Not mapped |
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `object` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | `html-object` |
| MSAA + IAccessible2 |
Depends on format of data file. If it contains a plugin then,
Role: `IA2_ROLE_EMBEDDED_OBJECT`
States:
`STATE_SYSTEM_UNAVAILABLE` for windowless plugin
|
| UIA |
Depends on format of data file.
|
| [[ATK]] |
Depends on format of data file. If contains a plugin then
Role:
`ATK_ROLE_EMBEDDED`
|
| AX | Depends on format of data file. |
| Comments |
| HTML Specification | `ol` |
|---|---|
| [[wai-aria-1.2]] | `list` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `optgroup` |
|---|---|
| [[wai-aria-1.2]] | `group` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `option` (in a list of options or represents a suggestion in a `datalist`) |
|---|---|
| [[wai-aria-1.2]] | `option` role, with the `aria-selected` state set to "true" if the element's selectedness is true, or "false" otherwise. |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `output` |
|---|---|
| [[wai-aria-1.2]] | `status` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
Relations: `IA2_RELATION_LABELLED_BY` with associated `label` element
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
Relations: `ATK_RELATION_LABELLED_BY` with associated `label` element
|
| AX |
Use WAI-ARIA mapping
|
| Comments | `AXDescription`: value from associated `label` element subtree. |
| undefined |
| HTML Specification | `p` |
|---|---|
| [[wai-aria-1.2]] | `paragraph` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `param` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | Not mapped |
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments | `param` is obsolete in HTML |
| HTML Specification | `picture` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | Not mapped |
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `pre` |
|---|---|
| [[wai-aria-1.2]] | `generic` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `progress` |
|---|---|
| [[wai-aria-1.2]] | `progressbar` role, with, if the progress bar is determinate, the `aria-valuemax` property set to the maximum value of the progress bar, the `aria-valuemin` property set to zero, and the `aria-valuenow` property set to the current value of the progress bar |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `q` |
|---|---|
| [[wai-aria-1.2]] | `generic` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments | `::before` and `::after` CSS pseudo content is used by platforms to render the element's quotation marks. |
| HTML Specification | `rp` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | html-rp |
| MSAA + IAccessible2 |
No accessible object. No child elements are exposed if
`ruby` is supported by the browser.
|
| UIA |
No accessible object.
|
| [[ATK]] |
No accessible object. No child elements are exposed if `ruby` is supported by the browser.
|
| AX | Not mapped |
| Comments |
| HTML Specification | `rt` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | html-rt |
| MSAA + IAccessible2 |
No accessible object. No child elements are exposed if
`ruby` is supported by the browser.
|
| UIA |
No accessible object.
|
| [[ATK]] |
No accessible object.
|
| AX |
AXRole: `AXGroup`
AXSubrole: `AXRubyText`
AXRoleDescription: `"group"`
|
| Comments |
| HTML Specification | `ruby` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | html-ruby |
| MSAA + IAccessible2 |
Role: `ROLE_SYSTEM_TEXT`; `IA2_ROLE_TEXT_FRAME`
|
| UIA |
Control Type: `Text`
Localized Control Type: `"ruby"`
|
| [[ATK]] |
Role: `ATK_ROLE_STATIC`
|
| AX |
AXRole: `AXGroup`
AXSubrole: `AXRubyInline`
AXRoleDescription: `"group"`
|
| Comments |
| HTML Specification | `s` |
|---|---|
| [[wai-aria-1.2]] | `deletion` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `samp` |
|---|---|
| [[wai-aria-1.2]] | `generic` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `script` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | Not mapped |
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `search` |
|---|---|
| [[wai-aria-1.2]] | `search` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `section` |
|---|---|
| [[wai-aria-1.2]] | `region` role if the `section` element has an accessible name. Otherwise, the `generic` role. |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `select` (with a `multiple` attribute or `size` attribute having value greater than `1`) |
|---|---|
| [[wai-aria-1.2]] | `listbox` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `select` (with NO `multiple` attribute and NO `size` attribute having value greater than `1`) |
|---|---|
| [[wai-aria-1.2]] | `combobox` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `slot` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | Not mapped |
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `small` |
|---|---|
| [[wai-aria-1.2]] | `generic` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments | Exposed by platform specific font size styles. |
| HTML Specification | `source` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | Not mapped |
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `span` |
|---|---|
| [[wai-aria-1.2]] | `generic` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `strong` |
|---|---|
| [[wai-aria-1.2]] | `strong` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `style` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | Not mapped |
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
Note: There are instances where CSS properties can affect what is exposed by accessibility APIs. For instance, `display: none` or `visibility: hidden` will remove an element
from the accessibility tree and hide its presence from assistive technologies.
|
| HTML Specification | `sub` |
|---|---|
| [[wai-aria-1.2]] | `subscript` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `summary` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role |
If the element is the first child of its type within a parent `details` element: `html-summary` Otherwise, if it is not the first child of its type of a parent `details` element, or it is not a child of a `details` element: `generic` role |
| MSAA + IAccessible2 |
Role: `ROLE_SYSTEM_PUSHBUTTON`
States:
`STATE_SYSTEM_EXPANDED` / `STATE_SYSTEM_COLLAPSED`
Actions: `expand` / `collapse`
|
| UIA |
Control Type: `Button`
Control Pattern: `ExpandCollapse`
|
| [[ATK]] |
Role: `ROLE_TOGGLE_BUTTON`
Relations: `ATK_RELATION_DETAILS`
|
| AX |
AXRole: `AXDisclosureTriangle`
AXSubrole: `(nil)`
AXRoleDescription: `"disclosure triangle"`
|
| Comments | If a `summary` element is not a child of a `details` element, or it is not the first `summary` element of a parent `details`, then user agents MUST expose the `summary` element with a `generic` role. |
| HTML Specification | `sup` |
|---|---|
| [[wai-aria-1.2]] | `superscript` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `svg` |
|---|---|
| [[wai-aria-1.2]] | See comments |
| Computed Role | See comments |
| MSAA + IAccessible2 | See comments |
| UIA | See comments |
| [[ATK]] | See comments |
| AX | See comments |
| Comments | Mapping for `svg` is defined by [[[svg-aam-1.0]]]. See also Graphics Accessibility API Role Mappings |
| HTML Specification | `table` |
|---|---|
| [[wai-aria-1.2]] | `table` role |
| Computed Role | To compute the role given table element `element`:
|
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
Relations: `IA2_RELATION_LABELLED_BY` with first instance of a rendered child `caption` element
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
Relations: `ATK_RELATION_LABELLED_BY` with first instance of a rendered child `caption` element
|
| AX |
Use WAI-ARIA mapping
AXDescription: value from the first instance of a rendered child `caption` element
|
| Comments |
| HTML Specification | `tbody` |
|---|---|
| [[wai-aria-1.2]] | `rowgroup` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 | Use WAI-ARIA mapping |
| UIA | Use WAI-ARIA mapping |
| [[ATK]] | Use WAI-ARIA mapping |
| AX | Use WAI-ARIA mapping |
| Comments |
| HTML Specification | `td` (ancestor `table` element has `table` role) |
|---|---|
| [[wai-aria-1.2]] | `cell` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `td` (ancestor `table` element has `grid` or `treegrid` role) |
|---|---|
| [[wai-aria-1.2]] | `gridcell` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `template` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | Not mapped |
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `textarea` |
|---|---|
| [[wai-aria-1.2]] | `textbox` role, with the `aria-multiline` property set to "true" |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `tfoot` |
|---|---|
| [[wai-aria-1.2]] | `rowgroup` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `th` (is not a column header, row header, column group header or row group header, and ancestor `table` element has `table` role) |
|---|---|
| [[wai-aria-1.2]] | `cell` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `th` (is not a column header, row header, column group header or row group header, and ancestor `table` element has `grid` or `treegrid` role) |
|---|---|
| [[wai-aria-1.2]] | `gridcell` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `th` (is a column header or column group header) |
|---|---|
| [[wai-aria-1.2]] | `columnheader` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `th` (is a row header or row group header) |
|---|---|
| [[wai-aria-1.2]] | `rowheader` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `thead` |
|---|---|
| [[wai-aria-1.2]] | `rowgroup` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `time` |
|---|---|
| [[wai-aria-1.2]] | `time` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `title` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | Not mapped |
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments | A `title` element provides the accessible name for its document. |
| HTML Specification | `tr` |
|---|---|
| [[wai-aria-1.2]] | `row` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `track` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | Not mapped |
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `u` |
|---|---|
| [[wai-aria-1.2]] | `generic` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments | Exposed by platform specific underline text styles. |
| HTML Specification | `ul` |
|---|---|
| [[wai-aria-1.2]] | `list` role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `var` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | `html-var` |
| MSAA + IAccessible2 |
No accessible object. Styles used are mapped to text attributes on its text container.
|
| UIA |
No accessible object. Styles used are exposed by UIA text attribute identifiers of the `TextRange` Control Pattern implemented on a parent accessible object.
|
| [[ATK]] |
No accessible object. Styles used are mapped to text attributes on its text container.
|
| AX |
AXRole: `AXGroup`
AXSubrole: `(nil)`
AXRoleDescription: `"group"`
|
| Comments |
| HTML Specification | `video` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | `html-video` |
| MSAA + IAccessible2 |
Role: `ROLE_SYSTEM_GROUPING`
|
| UIA |
Control Type: `Group`
Localized Control Type: `"group"`
Note: If the `controls` attribute is present, UI controls (e.g., play, volume) are exposed as children of the
`video` element in the accessibility tree, and mapped as appropriate for the type of control (e.g.,
`button` or `slider`).
User agents MAY include the following in the accessibility tree and mark them as hidden or off-screen:
|
| [[ATK]] |
Role: `ATK_ROLE_VIDEO`
|
| AX |
AXRole: `AXGroup`
AXSubrole: `AXVideo`
AXRoleDescription: `"video playback"`
Note: If the `controls` attribute is present, UI controls (e.g., play, volume) are exposed as descendants of an
accessible object with a role of `toolbar`, and mapped as appropriate for the type of control (e.g.,
`button` or `slider`).
|
| Comments |
| HTML Specification | `wbr` |
|---|---|
| [[wai-aria-1.2]] | No corresponding role |
| Computed Role | Not mapped |
| MSAA + IAccessible2 |
If a line break is added, expose it with `IAccessibleText` on the text container
|
| UIA |
Not mapped
|
| [[ATK]] |
A line break if added is exposed via Text interface on its text container
|
| AX |
AXRole: `AXGroup`
AXSubrole: `(nil)`
AXRoleDescription: `"group"`
|
| Comments |
| HTML Specification | `abbr` |
|---|---|
| Element(s) | `th` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Object attributes:
"abbr" until child `abbr` element is provided
|
| UIA |
Not mapped
|
| [[ATK]] |
Object attributes:
"abbr" until child `abbr` element is provided
|
| AX | `AXDescription: <value>` |
| Comments |
| HTML Specification | `accept` |
|---|---|
| Element(s) | `input` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `accept-charset` |
|---|---|
| Element(s) | `form` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `accesskey` |
|---|---|
| Element(s) | `HTML elements` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
A key binding accessible by
`accKeyboardShortcut`
and `IAccessibleAction::keyBinding`
|
| UIA |
Properties: `AccessKey: <value>`
|
| [[ATK]] |
`atk_action_get_keybinding`
|
| AX | `AXAccessKey: <value>` |
| Comments |
| HTML Specification | `action` |
|---|---|
| Element(s) | `form` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `allow` |
|---|---|
| Element(s) | `iframe` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `allowfullscreen` |
|---|---|
| Element(s) | `iframe` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `alt` |
|---|---|
| Element(s) | `area`; `img`; `input` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 | Used for accessible name, exposed via `accName` |
| UIA |
Properties:
`Name`
|
| [[ATK]] |
Used for accessible name, exposed via `atk_object_get_name`
|
| AX | `AXDescription: <value>` |
| Comments |
| HTML Specification | `as` |
|---|---|
| Element(s) | `link` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `async` |
|---|---|
| Element(s) | `script` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `autocapitalize` |
|---|---|
| Element(s) | HTML elements |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `autocomplete` |
|---|---|
| Element(s) | `form` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
Note: the `aria-autocomplete` attribute and the HTML `autocomplete` attribute have disparate features. The `aria-autocomplete` attribute is not supported on the HTML `form` element or elements with an explicit ARIA `form` role. When used on a `form` element, the `autocomplete` attribute identifies whether form controls owned by the form will have their autofill field name set to "`on`" or "`off`" by default. See `autocomplete` for `input`, `select`, `textarea` for control mappings. |
| HTML Specification | `autocomplete` |
|---|---|
| Element(s) | `input`, `select` and `textarea` |
| [[WAI-ARIA-1.2]] |
If specified `autocomplete=off` or the control is owned by a `form` with `autocomplete=off` - `aria-autocomplete=none` Otherwise, `aria-autocomplete` Note: the `aria-autocomplete` attribute and the HTML `autocomplete` attribute have disparate features, but they overlap as mechanisms for user agents to expose the control's support for autocompletion. |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
If the form control has been specified as both `autocomplete=off` (whether due to explicit use of the attribute, or from inheriting the `off` state from a parent `form` element with `autocomplete=off`) and with an `aria-autocomplete` attribute with a valid value, user agents MUST expose only the `aria-autocomplete` attribute value. Otherwise, if the form control has an `autocomplete` attribute specified with a valid token value, and an `aria-autocomplete` attribute, then user agents MUST expose only the `autocomplete` attribute value. |
| HTML Specification | `autofocus` |
|---|---|
| Element(s) | HTML elements |
| [[WAI-ARIA-1.2]] | Not mapped |
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments | Provides a minimum role of `group`. |
| HTML Specification | `autoplay` |
|---|---|
| Element(s) | `audio` and `video` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `blocking` |
|---|---|
| Element(s) | `link`; `script`; `style` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `charset` |
|---|---|
| Element(s) | `meta` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `checked` (if present) |
|---|---|
| Element(s) | `input` `type=checkbox` or `type=radio` |
| [[WAI-ARIA-1.2]] | `aria-checked`="true" |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA | Property: `Toggle.ToggleState: On (1)` |
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX | `AXValue: 1` |
| Comments | If an `input` element in the `checkbox` or `radio` state includes both the `checked` attribute and the `aria-checked` attribute with a valid value, User Agents MUST expose only the `checked` attribute value. |
| HTML Specification | `checked` (if absent) |
|---|---|
| Element(s) | `input` `type=checkbox` or `type=radio` |
| [[WAI-ARIA-1.2]] | `aria-checked`="false" |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA | Property: `Toggle.ToggleState: Off (0)` |
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX | `AXValue: 0` |
| Comments | An `input` element in the `checkbox` or `radio` state without a `checked` attribute has an implicit "false" state. User Agents MUST ignore an `aria-checked` attribute which conflicts with the native element's implicit checked state. |
| HTML Specification | `cite` |
|---|---|
| Element(s) | `blockquote`; `del` and `ins`; `q` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX | `AXURL: <value>` |
| Comments |
| HTML Specification | `class` |
|---|---|
| Element(s) | HTML elements |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Object attributes: `class: <value>`
|
| UIA |
Property: `UIA_ClassNamePropertyId`
|
| [[ATK]] |
Object attributes: `class: <value>`
|
| AX |
Property: `AXDOMClassList`
|
| Comments |
| HTML Specification | `color` |
|---|---|
| Element(s) | `link` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `cols` |
|---|---|
| Element(s) | `textarea` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX | `AXRangeForLine: <value>` |
| Comments |
Not mapped
|
| HTML Specification | `colspan` |
|---|---|
| Element(s) | `td` and `th` |
| [[WAI-ARIA-1.2]] | `aria-colspan` |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `command` |
|---|---|
| Element(s) | `button` (`command` in the Toggle popover state Show popover state and Hide popover state) |
| [[WAI-ARIA-1.2]] |
If the associated element is displayed as a popover: `aria-expanded=true` If the associated element is hidden: `aria-expanded=false` If the associated element is an accessibility ancestor of the element with the `command` attribute or is not present in the DOM: `aria-expanded=undefined` If the associated element is not a valid `popover` element: no `aria-expanded` mapping. |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
Object attributes: `details-roles:popover`
|
| UIA |
Use WAI-ARIA mapping
|
| ATK |
Use WAI-ARIA mapping
Object attributes: `details-roles:popover`
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
User Agents MUST expose an `aria-details` relationship with the associated element (identified via the specified `commandfor` attribute) except under the following conditions:
A button that represents a submit button or is in the reset state with a [=button/form owner=] cannot invoke a command. |
| HTML Specification | `command` |
|---|---|
| Element(s) | `button` (`command` in the Close state) and Show Modal state) |
| [[WAI-ARIA-1.2]] |
A `command` attribute in the `close` and `show-modal` states provide no additional accessibility mappings to the `button` element.
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| ATK |
Not mapped
|
| AX |
Not mapped
|
| Comments |
A button that represents a submit button or is in the reset state with a [=button/form owner=] cannot invoke a command. |
| HTML Specification | `commandfor` |
|---|---|
| Element(s) | `button` |
| [[WAI-ARIA-1.2]] |
See comments
|
| MSAA + IAccessible2 |
See comments
|
| UIA |
See comments
|
| ATK |
See comments
|
| AX |
See comments
|
| Comments |
The `commandfor` attribute identifies the associated element for the `button` element. The specified `command` state will determine if a relationship mapping needs to be exposed between the `button` and its programmatically associated element. |
| HTML Specification | `content` |
|---|---|
| Element(s) | `meta` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `contenteditable` |
|---|---|
| Element(s) | HTML elements |
| [[WAI-ARIA-1.2]] | Not mapped |
| MSAA + IAccessible2 |
If the element is in the editable state, the following mappings apply to the element and every nested accessible object with the exception of those which have been specified in the `false` state.
States:
`IA2_STATE_EDITABLE` and `IA2_STATE_MULTI_LINE`
Interfaces:
`IAccessibleEditableText`
If the element is in the `false` state: not mapped. If the element is in the `inherit` state: match the editable state of its parent element. |
| UIA |
If the element is in the editable state, the following mappings apply to the element and every nested accessible object with the exception of those which have been specified in the `false` state. Control Pattern: `TextEdit`
Property: `AriaProperties.multiline:true`
If the element is in the `false` state: not mapped. If the element is in the `inherit` state: match the editable state of its parent element. |
| [[ATK]] |
If the element is in the editable state, the following mappings apply to the element and every nested accessible object with the exception of those which have been specified in the `false` state.
States:
`ATK_STATE_EDITABLE` and `ATK_STATE_MULTI_LINE`
Interfaces: `AtkEditableText`
If the element is in the `false` state: not mapped. If the element is in the `inherit` state: match the editable state of its parent element. |
| AX |
Role:
AXTextArea
Use WAI-ARIA mapping
|
| Comments | If the element is set to `contenteditable` and `aria-readonly="true"`, User Agents MUST expose only the `contenteditable` state. |
| HTML Specification | `controls` |
|---|---|
| Element(s) | `audio` and `video` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX | Controls exposed as `AXToolbar` |
| Comments |
| HTML Specification | `coords` |
|---|---|
| Element(s) | `area` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Defines an accessible object's dimensions (`IAccessible::accLocation`)
|
| UIA |
Defines an accessible object's dimensions (`BoundingRectangle`)
|
| [[ATK]] |
Defines an accessible object's dimensions, exposed via `atk_component_get_position` and `atk_component_get_size`
|
| AX |
Defines an accessible object's dimensions, exposed via `Frame` property
|
| Comments |
| HTML Specification | `crossorigin` |
|---|---|
| Element(s) | `audio`; `img`; `link`; `script`; `video` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `data` |
|---|---|
| Element(s) | `object` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `datetime` |
|---|---|
| Element(s) | `del` and `ins` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Object attributes: `datetime: <value>`
|
| UIA |
Not mapped
|
| [[ATK]] |
Object attributes: `datetime: <value>`
|
| AX | `AXDateTimeValue: <value>` |
| Comments |
| HTML Specification | `datetime` |
|---|---|
| Element(s) | `time` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Object attributes: `datetime: <value>`
|
| UIA |
Properties: `FullDescription: <value>`
|
| [[ATK]] |
Object attributes: `datetime: <value>`
|
| AX | `AXDateTimeValue: <value>` |
| Comments |
| HTML Specification | `decoding` |
|---|---|
| Element(s) | `img` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `default` |
|---|---|
| Element(s) | `track` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `defer` |
|---|---|
| Element(s) | `script` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `dir` |
|---|---|
| Element(s) | HTML elements |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Exposed as "writing-mode" text attribute on the text container.
|
| UIA |
Exposed by `TextFlowDirections` attribute of the `TextRange` Control Pattern implemented on a parent accessible object.
|
| [[ATK]] |
Exposed as "writing-mode" text attribute on the text container.
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `dir` |
|---|---|
| Element(s) | `bdo` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Exposed as "writing-mode" text attribute on the text container.
|
| UIA |
Exposed by `TextFlowDirections` attribute of the `TextRange` Control Pattern implemented on a parent accessible object.
|
| [[ATK]] |
Exposed as "writing-mode" text attribute on the text container.
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `dirname` |
|---|---|
| Element(s) | `input` and `textarea` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `disabled` |
|---|---|
| Element(s) | `button`; `input`; `optgroup`; `option`; `select`; `textarea`; form-associated custom element |
| [[WAI-ARIA-1.2]] | `aria-disabled="true"` |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments | If the element has both the `disabled` attribute and the `aria-disabled` attribute with a valid value, User Agents MUST expose only the `disabled` attribute value. |
| HTML Specification | `disabled` |
|---|---|
| Element(s) | `fieldset` |
| [[WAI-ARIA-1.2]] | `aria-disabled="true"` |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
Form controls within a valid [^legend^] child element of a `fieldset` with a `disabled` attribute do not become disabled. If the element has both the `disabled` attribute and the `aria-disabled` attribute with a valid value, User Agents MUST expose only the `disabled` attribute value. |
| HTML Specification | `disabled` |
|---|---|
| Element(s) | `link` |
| [[WAI-ARIA-1.2]] | Not mapped |
| MSAA + IAccessible2 | Not mapped |
| UIA | Not mapped |
| [[ATK]] | Not mapped |
| AX | Not mapped |
| Comments |
| HTML Specification | `download` |
|---|---|
| Element(s) | `a` and `area` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `draggable` |
|---|---|
| Element(s) | HTML elements |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Object attributes: draggable:true
|
| UIA |
Not mapped
|
| [[ATK]] |
Object attributes: draggable:true
|
| AX |
Not mapped
|
| Comments | Provides a minimum role of `group`. |
| HTML Specification | `enctype` |
|---|---|
| Element(s) | `form` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `enterkeyhint` |
|---|---|
| Element(s) | HTML elements |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments | Modifies the action label (or icon) to present for the enter key on virtual keyboards. |
| HTML Specification | `fetchpriority` |
|---|---|
| Element(s) | `img`; `link`; `script` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `for` |
|---|---|
| Element(s) | `label` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Used for accessible name
Relations:
`IA2_RELATION_LABEL_FOR` and `IA2_RELATION_LABEL_BY` relations between
`label` and referred labelable element
|
| UIA |
Used for accessible name
When the `label` element has a `for` attribute referencing another labelable element, the `LabeledBy` property for the referenced
element points to the UIA element for the `label` element.
|
| [[ATK]] |
Used for accessible name
Relations:
`ATK_RELATION_LABEL_FOR` and `ATK_RELATION_LABEL_BY` relations between
`label` and referred labelable element
|
| AX |
Used for accessible name
|
| Comments |
| HTML Specification | `for` |
|---|---|
| Element(s) | `output` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Relations:
`IA2_RELATION_CONTROLLED_BY` with an element pointed by the attribute. Paired element exposes `IA2_RELATION_CONTROLLER_FOR` relation.
|
| UIA |
Not mapped
|
| [[ATK]] |
Relations:
`ATK_RELATION_CONTROLLED_BY` with an element pointed by the attribute. Paired element exposes `ATK_RELATION_CONTROLLER_FOR` relation.
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `form` |
|---|---|
| Element(s) | `button`; `fieldset`; `input`; `label`; `object`; `output`; `select`; `textarea`; form-associated custom element |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `formaction` |
|---|---|
| Element(s) | `button`; `input` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `formenctype` |
|---|---|
| Element(s) | `button`; `input` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `formmethod` |
|---|---|
| Element(s) | `button`; `input` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `formnovalidate` |
|---|---|
| Element(s) | `button`; `input` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `formtarget` |
|---|---|
| Element(s) | `button`; `input` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `headers` |
|---|---|
| Element(s) | `td`; `th` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Links the cell to its header cells. Exposed via `IAccessibleTableCell::rowHeaderCells` and `IAccessibleTableCell::columnHeaderCells`.
|
| UIA |
Links the cell to its header cells. Exposed via `Table.ItemColumnHeaderItems` and `Table.ItemRowHeaderItems`.
|
| [[ATK]] |
Links the cell to its row and column header cells (note, only one row and one column header cells can be exposed because of API
restrictions). See `atk_table_get_row_header` and `atk_table_get_column_header`.
|
| AX | Expose via `AXColumnHeaderUIElements` and `AXRowHeaderUIElements` |
| Comments |
| HTML Specification | `height` |
|---|---|
| Element(s) | `canvas`; `embed`; `iframe`; `img`; `input`; `object`; `source` (in `picture`); `video` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Defines an accessible object's height (`IAccessible::accLocation`)
|
| UIA |
Defines an accessible object's height (`BoundingRectangle`)
|
| [[ATK]] |
Defines an accessible object's height (`atk_component_get_size`)
|
| AX |
Defines an accessible object's height (`AXSize` property)
|
| Comments |
| HTML Specification | `hidden` |
|---|---|
| Element(s) | HTML elements |
| [[WAI-ARIA-1.2]] | `aria-hidden="true"` if the element retains its user agent default styling of `display: none`. Otherwise, if no other method for hiding the content is used (e.g., `visibility: hidden`) then it is not mapped. |
| MSAA + IAccessible2 | Use WAI-ARIA mapping |
| UIA | Use WAI-ARIA mapping |
| [[ATK]] | Use WAI-ARIA mapping |
| AX | Use WAI-ARIA mapping |
| Comments |
| HTML Specification | `high` |
|---|---|
| Element(s) | `meter` |
| [[WAI-ARIA-1.2]] | Not mapped |
| MSAA + IAccessible2 |
Not mapped
|
| UIA | `RangeValue.Maximum` |
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `href` |
|---|---|
| Element(s) | `a`; `area` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 | |
| UIA | Creates a link accessible object. For details, refer to `a` and `area` element mappings. The value of the `href` attribute is stored in the `Value.Value` UIA property. |
| [[ATK]] | |
| AX | `AXURL: <value>` |
| Comments |
| HTML Specification | `href` |
|---|---|
| Element(s) | `link` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `hreflang` |
|---|---|
| Element(s) | `a`; `link` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `http-equiv` |
|---|---|
| Element(s) | `meta` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `id` |
|---|---|
| Element(s) | HTML elements |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Object attributes: `id: <value>`
|
| UIA |
Property: `UIA_AutomationIdPropertyId`
|
| [[ATK]] |
Object attributes: `id: <value>`
|
| AX |
Property: `AXDOMIdentifier`
|
| Comments |
| HTML Specification | `inert` |
|---|---|
| Element(s) | HTML elements |
| [[WAI-ARIA-1.2]] | Not Mapped |
| MSAA + IAccessible2 | See comments |
| UIA | See comments |
| [[ATK]] | See comments |
| AX | See comments |
| Comments |
Nodes that are inert are not exposed to an accessibility API. Note: an inert node can have descendants that are not inert. For example, a modal dialog can escape an inert subtree. |
| HTML Specification | `indeterminate [IDL]` |
|---|---|
| Element(s) | HTML elements; `input` |
| [[WAI-ARIA-1.2]] | `aria-checked` (state)="mixed" |
| MSAA + IAccessible2 | Use WAI-ARIA mapping |
| UIA | Use WAI-ARIA mapping |
| [[ATK]] | Use WAI-ARIA mapping |
| AX | Use WAI-ARIA mapping |
| Comments | If the element has the `indeterminate [IDL]` set and the `aria-checked` attribute set, User Agents MUST expose only the `indeterminate [IDL]` state. |
| HTML Specification | `ismap` |
|---|---|
| Element(s) | `img` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `itemid` |
|---|---|
| Element(s) | `img` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `itemprop` |
|---|---|
| Element(s) | `img` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `itemref` |
|---|---|
| Element(s) | `img` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `itemscope` |
|---|---|
| Element(s) | `img` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `itemtype` |
|---|---|
| Element(s) | `img` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `kind` |
|---|---|
| Element(s) | `track` |
| [[WAI-ARIA-1.2]] | Not mapped |
| MSAA + IAccessible2 | Not mapped |
| UIA | Not mapped |
| [[ATK]] | Not mapped |
| AX | Not mapped |
| Comments |
| HTML Specification | `label` |
|---|---|
| Element(s) | `optgroup`; `option`; `track` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Associates the accessible name
|
| UIA | The target element of the `label` attribute has a `LabeledBy` property pointing to the element with the `label` attribute. Participates in name computation. |
| [[ATK]] |
Associates the accessible name
|
| AX | `AXTitle`: `<value>` |
| Comments | See Also: Accessible Name and Description: Computation and API Mappings |
| HTML Specification | `lang` |
|---|---|
| Element(s) | HTML elements |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Exposed as "language" text attribute on the text container
|
| UIA |
The value of the `lang` attribute is exposed as a locale identifier by `Culture` property of the UIA element representing the HTML element, and by `Culture` attribute of the
`TextRange` Control Pattern implemented on a parent accessible object.
|
| [[ATK]] |
Exposed as "language" text attribute on the text container
|
| AX | `AXLanguage: <value>` |
| Comments |
| HTML Specification | `list` |
|---|---|
| Element(s) | `input` |
| [[WAI-ARIA-1.2]] | `aria-controls` |
| MSAA + IAccessible2 |
`IA2_RELATION_CONTROLLER_FOR` point to the `datalist` element referred to by the IDREF value of the `list` attribute.
|
| UIA |
`ControllerFor` point to the `datalist` element referred to by the IDREF value of the `list` attribute.
|
| [[ATK]] |
`ATK_RELATION_CONTROLLER_FOR` point to the `datalist` element referred to by the IDREF value of the `list` attribute.
|
| AX |
Property: `AXLinkedUIElements`: point to the `datalist` element referred to by the IDREF value of the `list` attribute.
|
| Comments | Refer to `datalist` and `input` element mappings. |
| HTML Specification | `loop` |
|---|---|
| Element(s) | `audio`; `video` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `low` |
|---|---|
| Element(s) | `meter` |
| [[WAI-ARIA-1.2]] | Not mapped |
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
`RangeValue.Minimum`
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `max` |
|---|---|
| Element(s) | `input` |
| [[WAI-ARIA-1.2]] | `aria-valuemax` |
| MSAA + IAccessible2 |
Exposed as `IAccessibleValue::maximumValue` if the element implements the interface
|
| UIA | `RangeValue.Maximum` |
| [[ATK]] |
Exposed as `atk_value_get_maximum_value` if the element implements the `AtkValue` interface
|
| AX | `AXMaxValue: <value>` |
| Comments |
| HTML Specification | `max` |
|---|---|
| Element(s) | `meter`; `progress` |
| [[WAI-ARIA-1.2]] | `aria-valuemax` |
| MSAA + IAccessible2 |
Exposed as `IAccessibleValue::maximumValue` if the element implements the interface
|
| UIA | `RangeValue.Maximum` |
| [[ATK]] |
Exposed as `atk_value_get_maximum_value` if the element implements the `AtkValue` interface
|
| AX | `AXMaxValue: <value>` |
| Comments |
| HTML Specification | `maxlength` |
|---|---|
| Element(s) | `input`; `textarea` |
| [[WAI-ARIA-1.2]] | Not mapped |
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `media` |
|---|---|
| Element(s) | `link`; `meta`; `source` (in `picture`); `style` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `method` |
|---|---|
| Element(s) | `form` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `min` |
|---|---|
| Element(s) | `input` |
| [[WAI-ARIA-1.2]] | `aria-valuemin` |
| MSAA + IAccessible2 |
Exposed as `IAccessibleValue::minimumValue` if the element implements the interface
|
| UIA | `RangeValue.Minimum` |
| [[ATK]] |
Exposed as `atk_value_get_minimum_value` if the element implements the `AtkValue` interface
|
| AX | `AXMinValue: <value>` |
| Comments |
| HTML Specification | `min` |
|---|---|
| Element(s) | `meter` |
| [[WAI-ARIA-1.2]] | `aria-valuemin` |
| MSAA + IAccessible2 |
Exposed as `IAccessibleValue::minimumValue` if the element implements the interface
|
| UIA | `RangeValue.Minimum` |
| [[ATK]] |
Exposed as `atk_value_get_minimum_value` if the element implements the `AtkValue` interface
|
| AX | `AXMinValue: <value>` |
| Comments |
| HTML Specification | `minlength` |
|---|---|
| Element(s) | `input`; `textarea` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
States:
`IA2_STATE_INVALID_ENTRY` if value doesn't meet the designated minimum length value.
|
| UIA |
States:
`IsDataValidForForm` if value doesn't meet the designated minimum length value.
|
| [[ATK]] |
States:
`ATK_STATE_INVALID_ENTRY` if value doesn't meet the designated minimum length value.
|
| AX |
Property:
`AXInvalid`: `true` if value doesn't meet the designated minimum length value.
|
| Comments |
| HTML Specification | `multiple` |
|---|---|
| Element(s) | `input` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `multiple` |
|---|---|
| Element(s) | `select` |
| [[WAI-ARIA-1.2]] | `aria-multiselectable="true"` |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `muted` |
|---|---|
| Element(s) | `audio`; `video` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `name` |
|---|---|
| Element(s) | `button`; `fieldset`; `input`; `output`; `select`; `textarea`; form-associated custom element |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `name` |
|---|---|
| Element(s) | `form` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `name` |
|---|---|
| Element(s) | `iframe`; `object` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `name` |
|---|---|
| Element(s) | `map` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `name` |
|---|---|
| Element(s) | `meta` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `name` |
|---|---|
| Element(s) | `slot` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `nomodule` |
|---|---|
| Element(s) | `script` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `nonce` |
|---|---|
| Element(s) | HTML elements |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `novalidate` |
|---|---|
| Element(s) | `form` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `open` |
|---|---|
| Element(s) | `details` |
| [[WAI-ARIA-1.2]] | `aria-expanded`="true | false" |
| MSAA + IAccessible2 | `STATE_SYSTEM_EXPANDED` `STATE_SYSTEM_COLLAPSED` |
| UIA | `ExpandCollapsePattern` |
| [[ATK]] |
States:
`ATK_STATE_COLLAPSED` or `ATK_STATE_EXPANDED` depending on the attribute value
|
| AX | `AXExpanded: YES|NO` |
| Comments | Set properties on the `summary` element. |
| HTML Specification | `open` |
|---|---|
| Element(s) | `dialog` |
| [[WAI-ARIA-1.2]] |
If the `open` attribute is set via the `showModal()` method then `aria-modal="true"` and
`aria-hidden="false"`.
Otherwise, if the `open` attribute is set via the `show()` method, or explicitly specified by an author, then
`aria-modal="false"` and `aria-hidden="false"`.
|
| MSAA + IAccessible2 | Use WAI-ARIA mapping |
| UIA | Use WAI-ARIA mapping |
| [[ATK]] | Use WAI-ARIA mapping |
| AX | Use WAI-ARIA mapping |
| Comments |
The `open` attribute's value is irrelevant. When the `open` attribute is not specified the default user agent styling for a `dialog` is `display: none`. Authors can reveal a `dialog` through the style layer by modifying its `display` property. If revealed this way then the `dialog` is `aria-modal="false"` and `aria-hidden="false"`. |
| HTML Specification | `optimum` |
|---|---|
| Element(s) | `meter` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `pattern` |
|---|---|
| Element(s) | `input` |
| [[WAI-ARIA-1.2]] |
If the value doesn't match the pattern: `aria-invalid="true"`; Otherwise,
`aria-invalid="false"`
|
| MSAA + IAccessible2 | Use WAI-ARIA mapping |
| UIA | Use WAI-ARIA mapping |
| [[ATK]] | Use WAI-ARIA mapping |
| AX | Use WAI-ARIA mapping |
| Comments |
| HTML Specification | `ping` |
|---|---|
| Element(s) | `a` and `area` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `placeholder` |
|---|---|
| Element(s) | `input`; `textarea` |
| [[WAI-ARIA-1.2]] | `aria-placeholder` |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
When the `placeholder` and `aria-placeholder` attributes are both present, and the `placeholder` attribute's value is non-empty, user agents MUST expose the value of the
`placeholder` attribute, and ignore `aria-placeholder`. If the `placeholder` attribute's value is empty, then user agents MUST expose the value of the `aria-placeholder` attribute.
|
| HTML Specification | `playsinline` |
|---|---|
| Element(s) | `video` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `popover` |
|---|---|
| Element(s) | HTML elements |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 | Relations: `IA2_RELATION_DETAILS_FOR` points to invoking element. See Comments. |
| UIA | A details relation is made with the invoking element, if an invoking element exists which meets the conditions for necessitating a details relationship. See Comments. |
| [[ATK]] |
Relations: `RELATION_DETAILS_FOR` points to invoking element. See Comments. |
| AX | TBD |
| Comments |
User agents MUST NOT expose a details relation between a `popover` and its invoking element under the following conditions:
If specified on an element with an implicit role of `generic`, then the element's role instead maps to `group` for all `popover` states. There are no unique mappings for the different `popover` states. Any accessibility mapping changes for the popover element would be the responsibility of the author. e.g., using different base HTML elements, attributes, or ARIA attributes to make such changes. |
| HTML Specification | `popovertarget` |
|---|---|
| Element(s) | `button`; `input type=button, image, reset, submit` |
| [[WAI-ARIA-1.2]] |
If the associated element is displayed as a popover: `aria-expanded=true` If the associated element is hidden: `aria-expanded=false` If the associated element is an accessibility ancestor of the element with the `command` attribute or is not present in the DOM: `aria-expanded=undefined` If the associated element is not a valid `popover` element: no `aria-expanded` mapping. |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
Object attributes: `details-roles:popover`
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
Object attributes: `details-roles:popover`
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
User Agents MUST expose an `aria-details` relation with the associated popover element except under the following conditions:
A button that represents a submit button with a [=button/form owner=] cannot invoke a popover. |
| HTML Specification | `popovertargetaction` |
|---|---|
| Element(s) | `button`; `input type=button, image, reset, submit` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments | The value of this attribute can impact the mappings of its related `popovertarget` attribute. |
| HTML Specification | `poster` |
|---|---|
| Element(s) | `video` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `preload` |
|---|---|
| Element(s) | `audio` and `video` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `readonly` |
|---|---|
| Element(s) | `input`; `textarea`; form-associated custom elements |
| [[WAI-ARIA-1.2]] | `aria-readonly="true"` |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments | If the element includes both the `readonly` attribute and the `aria-readonly` attribute with a valid value, User Agents MUST expose only the `readonly` attribute value. |
| HTML Specification | `referrerpolicy` |
|---|---|
| Element(s) | `a`; `area`; `iframe`; `img`; `link`; `script` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `rel` |
|---|---|
| Element(s) | `a`; `area`; `link` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `required` |
|---|---|
| Element(s) | `input`; `select`; `textarea` |
| [[WAI-ARIA-1.2]] | `aria-required` |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
If the element includes both the `required` attribute and the `aria-required` attribute with a valid value, User Agents MUST expose only the `required` attribute value. If an element is required, user agents MUST NOT expose the element with an intitial invalid state (`aria-invalid="true"`). The user agent SHOULD expose the invalid state only after 1) a user has purposefully interacted with a required element, or attempted to submit a form and 2) the element, or elements, do not meet constraint validation. Until these conditions are met, user agents MUST expose the elements as (`aria-invalid="false"`). |
| HTML Specification | `reversed` |
|---|---|
| Element(s) | `ol` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Reverses the numerical or alphabetical order of the child list item markers.
|
| UIA |
Reverses the numerical or alphabetical order of the child list item markers.
|
| [[ATK]] |
Reverses the numerical or alphabetical order of the child list item markers.
|
| AX |
Reverses the numerical or alphabetical order of the child list item markers.
|
| Comments |
| HTML Specification | `rows` |
|---|---|
| Element(s) | `textarea` |
| [[WAI-ARIA-1.2]] | Not mapped |
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `rowspan` |
|---|---|
| Element(s) | `td`; `th` |
| [[WAI-ARIA-1.2]] | `aria-rowspan` |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `sandbox` |
|---|---|
| Element(s) | `iframe` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `scope` |
|---|---|
| Element(s) | `th` |
| [[WAI-ARIA-1.2]] |
If `scope="row"` then map `th` to `rowheader`
If `scope="col"` then map `th` to `columnheader`
|
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `selected` |
|---|---|
| Element(s) | `option` |
| [[WAI-ARIA-1.2]] | `aria-selected="true"` |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments | If the element includes both the `selected` attribute and the `aria-selected` attribute with a valid value, User Agents MUST expose only the `selected` attribute value. |
| HTML Specification | `shape` |
|---|---|
| Element(s) | `area` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `size` |
|---|---|
| Element(s) | `input`; `select` |
| [[WAI-ARIA-1.2]] |
Not mapped for `input` elements.
If greater than 1, then creates a listbox accessible object. Refer to `select` element for details.
|
| MSAA + IAccessible2 |
Not mapped for `input` elements.
For `select` element use WAI-ARIA mapping.
|
| UIA |
Not mapped for `input` elements.
For `select` element use WAI-ARIA mapping.
|
| [[ATK]] |
Not mapped for `input` elements.
For `select` element use WAI-ARIA mapping.
|
| AX |
Not mapped for `input` elements.
For `select` element use WAI-ARIA mapping.
|
| Comments | For `input` elements that allow the `size` attribute, the attribute will modify their default width. A width provided by CSS will negate the effects of the `size` attribute on these `input` elements. |
| HTML Specification | `sizes` |
|---|---|
| Element(s) | `link` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `sizes` |
|---|---|
| Element(s) | `img`; `source` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `slot` |
|---|---|
| Element(s) | HTML elements |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `span` |
|---|---|
| Element(s) | `col`; `colgroup` |
| [[WAI-ARIA-1.2]] | Not mapped |
| MSAA + IAccessible2 |
Exposed as `IAccessibleTableCell::columnExtent` on all cells at the column
|
| UIA |
Exposed as `GridItem.ColumnSpan` on all cells at the column
|
| [[ATK]] |
Exposed via `atk_table_get_column_extent_at`
|
| AX |
`AXColumnIndexRange.length: <value>`
|
| Comments |
| HTML Specification | `spellcheck` |
|---|---|
| Element(s) | HTML elements |
| [[WAI-ARIA-1.2]] | `aria-invalid="spelling"` or `grammar` |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `src` |
|---|---|
| Element(s) | `audio`; `embed`; `iframe`; `img`; `input`; `script`; `source` (in `audio` or `video`); `track`; `video` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Object attributes:
`src` on `img` only
|
| UIA |
Not mapped
|
| [[ATK]] |
Object attributes:
`src` on `img` only
|
| AX | `AXURL: <value>` on `img` and `input type="image"` |
| Comments |
| HTML Specification | `srcdoc` |
|---|---|
| Element(s) | `iframe` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `srclang` |
|---|---|
| Element(s) | `track` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `srcset` |
|---|---|
| Element(s) | `img`; `source` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not Mapped
|
| Comments |
| HTML Specification | `start` |
|---|---|
| Element(s) | `ol` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Changes the first number of the child list item accessible objects to match the `start` attribute's value.
|
| UIA |
Changes the first number of the child list item accessible objects to match the `start` attribute's value.
|
| [[ATK]] |
Changes the first number of the child list item accessible objects to match the `start` attribute's value.
|
| AX |
Changes the first number of the child list item accessible objects to match the `start` attribute's value.
|
| Comments |
| HTML Specification | `step` |
|---|---|
| Element(s) | `input` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA | If the `input` is in the `Range` state, set both `RangeValue.SmallChange` and `RangeValue.LargeChange` to the value of `step`. |
| [[ATK]] |
Exposed as `atk_value_get_minimum_increment` if the element implements the `AtkValue` interface.
|
| AX | Not mapped |
| Comments |
| HTML Specification | `style` |
|---|---|
| Element(s) | HTML elements |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `tabindex` |
|---|---|
| Element(s) | HTML elements |
| [[WAI-ARIA-1.2]] | See Focus States and Events Table |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `target` |
|---|---|
| Element(s) | `a`; `area` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `target` |
|---|---|
| Element(s) | `base` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `target` |
|---|---|
| Element(s) | `form` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `title` |
|---|---|
| Element(s) | HTML elements |
| [[WAI-ARIA-1.2]] |
Either the accessible name, or the accessible description, or Not
mapped (see Comments).
|
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
The Accessible Name and Description Computation section specifies if the `title` attribute will be mapped and, if so,
through what [[WAI-ARIA]] property.
|
| HTML Specification | `title` |
|---|---|
| Element(s) | `abbr`; `dfn` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Associates the accessible name
|
| UIA |
Associates the accessible name
|
| [[ATK]] |
Associates the accessible name
|
| AX | `AXExpandedTextValue: <value>` |
| Comments |
| HTML Specification | `title` |
|---|---|
| Element(s) | `link` |
| [[WAI-ARIA-1.2]] | Not mapped |
| MSAA + IAccessible2 | Not mapped |
| UIA | Not mapped |
| [[ATK]] | Not mapped |
| AX | Not mapped |
| Comments |
| HTML Specification | `title` |
|---|---|
| Element(s) | `link`; `style` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments | Provides the name for the CSS style sheet. |
| HTML Specification | `translate` |
|---|---|
| Element(s) | HTML elements |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `type` |
|---|---|
| Element(s) | `a`; `link` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `type` |
|---|---|
| Element(s) | `button` |
| [[WAI-ARIA-1.2]] | Not mapped |
| MSAA + IAccessible2 |
`submit` type may be a default button in the form.
|
| UIA |
`submit` type may be a default button in the form.
|
| [[ATK]] |
`submit` type may be a default button in the form.
|
| AX |
`submit` type may be a default button in the form.
|
| Comments |
| HTML Specification | `type` |
|---|---|
| Element(s) | `embed`; `object`; `script`; `source` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `type` |
|---|---|
| Element(s) | `input` |
| [[WAI-ARIA-1.2]] | Refer to WAI-ARIA mappings for input types with defined ARIA roles. |
| MSAA + IAccessible2 | |
| UIA | |
| [[ATK]] | |
| AX | |
| Comments |
| HTML Specification | `type` |
|---|---|
| Element(s) | `ol` |
| [[WAI-ARIA-1.2]] | Not mapped |
| MSAA + IAccessible2 |
Defines the list item marker, which has no accessible object, but is exposed as content in the accessible text of the associated list item.
Interfaces: `IAccessibleText2`
|
| UIA |
Defines the list item marker, which has no accessible object, but is exposed as content in the accessible text of the associated list item.
Control Pattern: `Text`
|
| [[ATK]] |
Defines the list item marker, which has no accessible object, but is exposed as content in the accessible text of the associated list item.
Interfaces: `ATKText`
|
| AX |
Defines the list item marker, which is exposed as content in `AXValue`, and rendered as an accessible object:
AXRole: `AXListMarker`
AXSubrole: `(nil)`
AXRoleDescription: `"list marker"`
|
| Comments |
Some platforms (IAccessible2, ATK, UIA) do not expose an accessible object for the list item marker, whether it was created and then pruned from the
accessibility tree, or never created in the first place. Instead, they expose the list item marker as part of the associated list item's accessible text. In
these cases, implementors need to consider such things as adjusting the offsets (e.g., for caret-moved events, text-selection events, etc.) for the updated list item text that now
also contains the list item marker as content, rather than just taking the offsets unmodified from the list item renderer.
|
| HTML Specification | `usemap` |
|---|---|
| Element(s) | `img` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Responsible for image map creation.
|
| UIA |
Responsible for image map creation.
|
| [[ATK]] |
Responsible for image map creation.
|
| AX |
Responsible for image map creation.
|
| Comments | Refer to `img` element. |
| HTML Specification | `value` |
|---|---|
| Element(s) | `button`; `option` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `value` |
|---|---|
| Element(s) | `data` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
| HTML Specification | `value` |
|---|---|
| Element(s) | `input`; `input type=date`; `input type=datetime-local`; `input type=email`; `input type=month`; `input type=number`; `input type=password`; `input type=range` `input type=search`; `input type=tel`; `input type=text`; `input type=url`; `input type=week`; |
| [[WAI-ARIA-1.2]] | `aria-valuenow` |
| MSAA + IAccessible2 | Use WAI-ARIA mapping |
| UIA | Use WAI-ARIA mapping |
| [[ATK]] | Use WAI-ARIA mapping |
| AX | Use WAI-ARIA mapping |
| Comments |
| HTML Specification | `value` |
|---|---|
| Element(s) | `input type=button`; `input type=reset`; `input type=submit` |
| [[WAI-ARIA-1.2]] | Contributes to the accessible name of the `input` |
| MSAA + IAccessible2 | See comments |
| UIA | See comments |
| ATK | See comments |
| AX | See comments |
| Comments | If specified, the value of the attribute will be the host language label used in the accessible name computation for `input` elements in the `button`, `reset` and `submit` states. |
| HTML Specification | `value` |
|---|---|
| Element(s) | `input type=checkbox`; `input type=hidden`; `input type=radio` |
| [[WAI-ARIA-1.2]] | Not mapped |
| MSAA + IAccessible2 | Not mapped |
| UIA | Not mapped |
| ATK | Not mapped |
| AX | Not mapped |
| Comments |
The `value` attribute of these `input` states is not directly communicated to users. |
| HTML Specification | `value` |
|---|---|
| Element(s) | `input type=color` |
| [[WAI-ARIA-1.2]] | `aria-valuenow` & `aria-valuetext` |
| MSAA + IAccessible2 | Use WAI-ARIA mapping |
| UIA | Use WAI-ARIA mapping |
| ATK | Use WAI-ARIA mapping |
| AX | Use WAI-ARIA mapping |
| Comments | User agents MAY use the exact text value of the `value` attribute, or a localized variation of the specified text to present a human friendly representation of the color value. |
| HTML Specification | `value` |
|---|---|
| Element(s) | `input type=image` |
| [[WAI-ARIA-1.2]] | Contributes to the accessible name of the `input` |
| MSAA + IAccessible2 | See comments |
| UIA | See comments |
| ATK | See comments |
| AX | See comments |
| Comments | If specified, and the `input` in the `image` state has no `alt` attribute specified, then the value of the attribute will be the host language label used in the accessible name computation, and will render as text if the image source is broken. Otherwise, the attribute is ignored. |
| HTML Specification | `value` |
|---|---|
| Element(s) | `li` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Exposed as first text node of `li`'s accessible object.
|
| UIA |
Expose the value of the `value` attribute as the first text node in the list item. If the value of the `value` attribute is an integer, set the UIA `PositionInSet` property to the
integer value.
|
| [[ATK]] |
Exposed as first text node of `li`'s accessible object.
|
| AX |
Exposed as `AXValue: <value>` with accessible object:
AXRole: `AXListMarker`
AXSubrole: `(nil)`
AXRoleDescription: `list marker`
|
| Comments |
| HTML Specification | `value` |
|---|---|
| Element(s) | `meter`; `progress` |
| [[WAI-ARIA-1.2]] | `aria-valuenow` |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Use WAI-ARIA mapping
|
| [[ATK]] |
Use WAI-ARIA mapping
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
| HTML Specification | `width` |
|---|---|
| Element(s) | `canvas`; `embed`; `iframe`; `img`; `input`; `object`; `source` (in `picture`); `video` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Defines an accessible object's width (`IAccessible::accLocation`)
|
| UIA |
Defines an accessible object's width (`BoundingRectangle`)
|
| [[ATK]] |
Defines an accessible object's width (`atk_component_get_size`)
|
| AX |
AXSize: w=n
|
| Comments |
| HTML Specification | `wrap` |
|---|---|
| Element(s) | `textarea` |
| [[WAI-ARIA-1.2]] |
Not mapped
|
| MSAA + IAccessible2 |
Not mapped
|
| UIA |
Not mapped
|
| [[ATK]] |
Not mapped
|
| AX |
Not mapped
|
| Comments |
The terms accessible name and accessible description are properties provided in all accessibility APIs. The name of the properties may differ across APIs but they serve the same function: as a container for a short (name) or longer (description) string of text.
The text alternative computation is used to generate both the accessible name and accessible description. There are different rules provided for several different types of elements, nodes, and combinations of markup.
User Agents notify assistive technology when relevant accessibility information changes, sometimes by destroying and recreating the accessibility object, or sometimes by notifying of changes to the object per the specified name change event mappings and description change event mappings.
If the control is encapsulated by its `label` element, exclude the control's author specified or user-entered value from its computed accessible name.
If the control is encapsulated by its `label` element, and the control has an author specified `value` or the lack of a `value` has produced an implementation defined string to render, then exclude either from the control's computed accessible name.
If the control is encapsulated by its `label` element, and the control has an `alt` attribute, then exclude the attribute's value from the control's computed accessible name.
If the `button` element is encapsulated by its `label` element, ignore the `button` element's subtree from its computed accessible name.
legend element, then use the subtree of the first such element.
A `figcaption` provides additional information related to its parent `figure` element. A `figcaption` does not take part in the accessible name or accessible description computation, unless explicitly referenced by an author.
caption element, then use the subtree of the first such element.
The document referenced by the `src` of the `iframe` element gets its name from that document's `title` element, like any other document. If there is no `title` provided, there is no accessible name.
`abbr`, `b`, `bdi`, `bdo`, `br`, `cite`, `code`, `dfn`, `em`, `i`, `kbd`, `mark`, `q`, `rp`, `rt`, `ruby`, `s`, `samp`, `small`, `strong`, `sub` and `sup`, `time`, `u`, `var`, `wbr`
Authors MAY provide an accessible description for any HTML element that is a valid child of the `body` element. The following list represents the order of precedence for user agents to compute the accessible description of an element. As defined by Accessible Name and Description Computation: Description Computation , user agents MUST use the first applicable description source, even if its use results in an empty description.
In accordance with Web Platform Design Principles, this specification provides no programmatic interface to determine if information is being used by Assistive Technologies. However, this specification does allow an author to present different information to users of Assistive Technologies from the information available to users who do not use Assistive Technologies. This is possible using many features of the ARIA and CORE-AAM specifications, just as this is possible using many other parts of the web technology stack. This content disparity could be abused to perform active fingerprinting of users of Assistive Technologies.
This specification introduces no new security considerations.
Review the commit history of this document on GitHub.
The following people contributed to the development of this document.