| 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 Accessibility API Mappings 1.0
More details about this document
- This version:
- https://w3c.github.io/html-aam/
- Latest published version:
- https://www.w3.org/TR/html-aam-1.0/
- Latest editor's draft:
- https://w3c.github.io/html-aam/
- History:
- https://www.w3.org/standards/history/html-aam-1.0/
- Commit history
- Editors:
- Former editors:
- Feedback:
- GitHub w3c/html-aam (pull requests, new issue, open issues)
Copyright © 2015-2026 World Wide Web Consortium. W3C® liability, trademark and permissive document license rules apply.
Abstract
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 Accessibility API Mappings 1.2 and the Accessible Name and Description Computation 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.
Status of This Document
This section describes the status of this document at the time of its publication. A list of current W3C publications and the latest revision of this technical report can be found in the W3C standards and drafts index.
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 document was published by the Accessible Rich Internet Applications Working Group as an Editor's Draft.
Publication as an Editor's Draft does not imply endorsement by W3C and its Members.
This is a draft document and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to cite this document as other than a work in progress.
This document was produced by a group operating under the W3C Patent Policy. W3C maintains a public list of any patent disclosures made in connection with the deliverables of the group; that page also includes instructions for disclosing a patent. An individual who has actual knowledge of a patent that the individual believes contains Essential Claim(s) must disclose the information in accordance with section 6 of the W3C Patent Policy.
This document is governed by the 18 August 2025 W3C Process Document.
This section is non-normative.
This specification defines how HTML user agents respond to and expose role, state and property information provided for Web content. Unless indicated otherwise, an HTML element or attribute with default Accessible Rich Internet Applications (WAI-ARIA) 1.2 semantics must be exposed to the platform accessibility APIs according to the relevant WAI-ARIA mappings defined in the Core Accessibility API Mappings 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 Accessible Name and Description Computation 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:
- Accessible Name and Description Computation 1.2
- Core Accessibility API Mappings 1.2
- HTML Accessibility API Mappings 1.0 (this specification)
- MathML Accessibility API Mappings 1.0
- SVG Accessibility API Mappings
Accessibility APIs covered by this document are:
- MSAA with IAccessible2 1.3 [IAccessible2]
- User Interface Automation [UI-AUTOMATION]
- ATK - Accessibility Toolkit [ATK] and Assistive Technology Service Provider Interface [AT-SPI], referred to hereafter as "ATK/AT-SPI"
- macOS Accessibility Protocol [AXAPI]
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 Accessibility API Mappings 1.2.
As well as sections marked as non-normative, all authoring guidelines, diagrams, examples, and notes in this specification are non-normative. Everything else in this specification is normative.
The key words MAY, MUST, MUST NOT, and SHOULD in this document are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.
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 Accessibility API Mappings 1.2.
Where the host language is [HTML], user agents MUST conform to Conflicts between native markup semantics and WAI-ARIA in the Core Accessibility API Mappings 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 author has not specified a valid explicit WAI-ARIA role to the element, or the specified role is either
none,presentation, orgeneric; - the element either has no implicit WAI-ARIA role or platform role mappings, or it has an implicit
genericornonecomputed role; - and the author has specified attributes which require a minimum role mapping for the element.
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.
- User agents MUST map HTML elements with implicit WAI-ARIA role semantics to platform accessibility APIs according to the identified WAI-ARIA role mapping as defined in the [core-aam-1.2] specification.
-
"Not mapped" means the element does not need to be exposed via an accessibility API. This is usually because the element is not displayed as part of the user
interface. However, authors can force some of these elements to be rendered. For instance, by overriding user agent styles to render elements that would have been otherwise set to
display: none. In these cases, the user agent SHOULD map such elements to the role ofgeneric, unless other HTML features have been specified which would require a more specific minimum role to be exposed. -
Where an element is indicated as having "No corresponding (WAI-ARIA) role", or is mapped to the
genericrole, user agents MUST NOT expose thearia-roledescriptionproperty value in the accessibility tree unless the element has an explicit, conformingroleattribute value which [WAI-ARIA-1.2] does not prohibit the use ofaria-roledescription. - Some HTML elements expose implicit WAI-ARIA roles depending on whether they have been provided an accessible name. How an element participates in the computation of its own or another element's accessible name and/or accessible description is described in the Accessible Name and Description Computation section of this document.
-
When HTML elements do not have an exact or equivalent mapping to a valid, non-abstract WAI-ARIA role, a unique
computedrolestring has been specified to serve as the return value for interoperability testing purposes. For instance, user agents MAY expose thevideoelement with acomputedroleof "html-video". Authors MUST NOT use anyhtml-prefixed computed role string in the role attribute (such ashtml-video). User Agents MUST ignore any abstract or invalid role token.<video> <!-- computedrole returns 'html-video' --> <main role="html-video"> <!-- Author error. computed role returns 'main' --> -
IAccessible2:
- All elements with accessible objects SHOULD implement the IAccessible, IAccessible2 and IAccessible2_2 interfaces.
-
UIA:
-
When a labelable element is referenced by a
labelelement'sforattribute, or a descendant of alabelelement, the labelable element's UIALabeledByproperty points to the UIA element for thelabelelement. -
Elements mapped to the
TextControl Type are not generally represented as accessible objects in the accessibility tree, but are just part of theTextControl Pattern implemented for the whole HTML document. However, if they have anyaria-attributes or an explicittabindexspecified, elements mapped to theTextControl Type will be represented as accessible objects in the accessibility tree.
-
When a labelable element is referenced by a
-
AXAPI:
- User agents SHOULD return a user-presentable, localized string value for the Mac Accessibility AXRoleDescription.
| 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:
AXGroupAXSubrole:
(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 | 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:
GroupLocalized 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:
AXGroupAXSubrole:
AXAudioAXRoleDescription:
"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 |
canvas
|
|---|---|
| [wai-aria-1.2] | No corresponding role |
| Computed Role | html-canvas |
| MSAA + IAccessible2 |
Roles:
ROLE_SYSTEM_GRAPHIC; IA2_ROLE_CANVAS |
| UIA |
Control Type:
ImageDescendants of the
canvas element are mapped separately. |
| [ATK] |
Role:
ATK_ROLE_CANVAS |
| AX |
AXRole:
AXGroupAXSubrole:
(nil)AXRoleDescription:
"" |
| Comments |
| HTML Specification |
caption
|
|---|---|
| [wai-aria-1.2] | caption role |
| Computed Role | Use WAI-ARIA mapping |
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| 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
|
| AX |
Use WAI-ARIA mapping
|
| Comments |
Note If a |
| 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:
AXGroupAXSubrole:
(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:
GroupLocalized 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
Note 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
Note Editorial Note: This value may change upon resolution of ARIA #1662. |
| MSAA + IAccessible2 |
Role:
ROLE_SYSTEM_LISTStates:
STATE_SYSTEM_READONLY |
| UIA |
Control Type:
List |
| [ATK] |
Role:
ATK_ROLE_DESCRIPTION_LIST |
| AX |
AXRole:
AXListAXSubrole:
AXDefinitionListAXRoleDescription:
"definition list" |
| Comments |
| HTML Specification |
dt
|
|---|---|
| [wai-aria-1.2] | term role |
| Computed Role |
Use WAI-ARIA mapping
Note 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_OBJECTStates:
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
|
| UIA |
Role: Use WAI-ARIA mapping
|
| [ATK] |
Role: Use WAI-ARIA mapping
|
| AX |
Role: Use WAI-ARIA mapping
AXSubrole:
AXFieldsetAXDescription: value from the first instance of a rendered child
legend element |
| Comments |
Note If a |
| 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 |
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] | sectionheader role |
| Computed Role |
Use WAI-ARIA mapping
|
| MSAA + IAccessible2 |
Use WAI-ARIA mapping
|
| UIA |
Control Type:
GroupLocalized Control Type:
"header" |
| [ATK] |
Role:
ATK_ROLE_HEADER |
| AX |
Use WAI-ARIA mapping
|
| Comments |
User agents and assistive technology MAY not expose the sectionheader role if the element:
|
| 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 |
| 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 Note The |
| 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 |
Note ARIA 1.3 adds the |
3.5.57
img
(alt attribute value, when trimmed of whitespace, is the empty string, i.e., alt="", alt=" ", or alt with no value in the markup)
| HTML Specification |
img
(alt attribute value, when trimmed of whitespace, is the empty string, i.e., alt="", alt=" ",
or alt with no value in the markup)
|
|---|---|
| [wai-aria-1.2] |
none or
presentation
|
| 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 |
Note
If an |
| 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_TEXTIf implemented as a color picker:
Roles:
IA2_ROLE_COLOR_CHOOSER |
| UIA |
If implemented as a textbox:
Control Type:
EditLocalized Control Type: "edit"
If implemented as a color picker:
Control Type:
buttonLocalized 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:
AXTextFieldAXSubrole:
(nil)AXRoleDescription:
"text field"If implemented as a color picker:
AXRole:
AXColorWellAXSubrole:
(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_TEXTObject attributes:
text-input-type:dateIf 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:
AXDateFieldAXSubrole:
(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:
AXTextFieldAXSubrole:
(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_FRAMEChildren:
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:
ButtonText input field:
Control Type:
EditLocalized Control Type:
"file" |
| [ATK] |
Role:
ATK_ROLE_STATIC
Children:
ATK_ROLE_PUSH_BUTTON when pressed ATK_ROLE_FILE_CHOOSER dialog shown
|
| AX |
AXRole:
AXButtonAXSubrole:
AXFileUploadButtonAXRoleDescription:
file upload button |
| 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:
AXTextFieldAXSubrole:
(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_TEXTStates:
STATE_SYSTEM_PROTECTED; IA2_STATE_SINGLE_LINE; STATE_SYSTEM_READONLY if readonly, otherwise IA2_STATE_EDITABLE |
| UIA |
Control Type:
EditOther properties:
isPassword=true |
| [ATK] |
Role:
ATK_ROLE_PASSWORD_TEXTStates:
ATK_STATE_SINGLE_LINE; ATK_STATE_READ_ONLY if readonly, otherwise ATK_STATE_EDITABLE |
| AX |
AXRole:
AXTextFieldAXSubrole:
AXSecureTextFieldAXRoleDescription:
"secure text field" |
| 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 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 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 |
3.5.77 input (type attribute in the Text, Search, Telephone, URL, or E-mail states with a suggestions source element)
| 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:
AXTimeFieldAXSubrole:
(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_EDITORObject 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:
AXTextFieldAXSubrole:
(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:
AXGroupAXSubrole:
(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:
AXGroupAXSubrole:
(nil)AXRoleDescription:
"group" |
| Comments |
Note
If a |
| HTML Specification |
legend
|
|---|---|
| [wai-aria-1.2] | No corresponding role |
| Computed Role | html-legend |
| MSAA + IAccessible2 |
Roles:
ROLE_SYSTEM_STATICTEXT; IA2_ROLE_LABEL |
| 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 |
| AX |
AXRole:
AXGroupAXSubrole:
(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 an accessibility child of an 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 |
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 |
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:
AXGroupAXSubrole:
AXRubyTextAXRoleDescription:
"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:
TextLocalized Control Type:
"ruby" |
| [ATK] |
Role:
ATK_ROLE_STATIC |
| AX |
AXRole:
AXGroupAXSubrole:
AXRubyInlineAXRoleDescription:
"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 |
3.5.115
select (rendered as a list box)
| HTML Specification |
select
(rendered as a list box)
|
|---|---|
| [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 |
3.5.116
select (rendered as a drop-down box)
| HTML Specification |
select
(rendered as a drop-down box)
|
|---|---|
| [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
Otherwise, if it is not the first child of its type of a parent |
| MSAA + IAccessible2 |
Role:
ROLE_SYSTEM_PUSHBUTTON
States:
STATE_SYSTEM_EXPANDED / STATE_SYSTEM_COLLAPSED
Actions:
expand / collapse |
| UIA |
Control Type:
ButtonControl Pattern:
ExpandCollapse |
| [ATK] |
Role:
ROLE_TOGGLE_BUTTONRelations:
ATK_RELATION_DETAILS |
| AX |
AXRole:
AXDisclosureTriangleAXSubrole:
(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 (see HTML summary element).
|
| 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 Accessibility API Mappings. See also Graphics Accessibility API Role Mappings |
| HTML Specification |
table
|
|---|---|
| [wai-aria-1.2] | table 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
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 |
3.5.134 th (is not a column header, row header, column group header or row group header, and ancestor table element has table role)
| 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 |
3.5.135
th (is not a column header, row header, column group header or row group header, and ancestor table element has grid or treegrid role)
| 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:
AXGroupAXSubrole:
(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:
GroupLocalized 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:
AXGroupAXSubrole:
AXVideoAXRoleDescription:
"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:
AXGroupAXSubrole:
(nil)AXRoleDescription:
"group" |
| Comments |
- User agents MUST map HTML attributes with default WAI-ARIA state and property semantics to platform accessibility APIs according to the identified WAI-ARIA state and property mapping as defined in the [core-aam-1.2] specification.
- A '?' in a cell indicates the data has yet to be provided.
- "Not mapped" (Not Applicable) means the attribute does not need to be exposed via an accessibility API. This is usually because the attribute is not displayed as part of the user interface.
- All elements having an accessible object in IAccessible2 mapping are supposed to implement IAccessible, IAccessible2 and IAccessible2_2 interfaces.
- User interaction with certain HTML elements will set an element's dirty value flag. These elements, as identified in [HTML], could have attributes that represent the default value or state of the element. When the dirty flag is set, that default value or state does not necessarily determine the value or state of the element or corresponding accessible node.
| 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
Note: the Note
When used on a |
| HTML Specification | autocomplete |
|---|---|
| Element(s) |
input, select and textarea
|
| [WAI-ARIA-1.2] |
If specified Otherwise, Note
Note: the |
| 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
Otherwise, if the form control has an |
| 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:
If the associated element is hidden:
If the associated element is an accessibility ancestor of the element with the If the associated element is not a valid |
| 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
Note A button that represents a submit button or is in the reset state with a 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 |
Note A button that represents a submit button or is in the reset state with a 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 The specified |
| 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
States:
IA2_STATE_EDITABLE and IA2_STATE_MULTI_LINE
Interfaces:
IAccessibleEditableText
If the element is in the If the element is in the |
| 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
Control Pattern:
TextEditProperty:
AriaProperties.multiline:trueIf the element is in the If the element is in the |
| [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
States:
ATK_STATE_EDITABLE and ATK_STATE_MULTI_LINE
Interfaces:
AtkEditableTextIf the element is in the If the element is in the |
| 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 If the element has both the |
| 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 | 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 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_EXPANDEDSTATE_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
Authors can reveal a |
| 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: |
| AX | TBD |
| Comments |
User agents MUST NOT expose a details relation between a
If specified on an element with an implicit role of Note
There are no unique mappings for the different |
| 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:
If the associated element is hidden:
If the associated element is an accessibility ancestor of the element with the If the associated element is not a valid |
| 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
Note A button that represents a submit button with a 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
If an element is required, user agents MUST NOT expose the element with an initial invalid state ( Until these conditions are met, user agents MUST expose the elements as ( |
| 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] | |
| 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 | |
| UIA |
Not mapped
|
| [ATK] | |
| 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:
AXListMarkerAXSubrole:
(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 |
Note The |
| 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:
AXListMarkerAXSubrole:
(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 |
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.
4.1.1
input type="text", input type="password", input type="number", input type="search", input type="tel", input type="email", input type="url" and textarea Elements Accessible
Name Computation
-
If the control has an
aria-labelor anaria-labelledbyattribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings. -
If the accessible name is still empty: use the text equivalent computation of
the associated
labelelement's subtree - if more than onelabelis associated; concatenate their subtrees by DOM order, delimited by spaces.If the control is encapsulated by its
labelelement, exclude the control's author specified or user-entered value from its computed accessible name. - If the accessible name is still empty: use the value of the control's
titleattribute. - If the accessible name is still empty: use the value of the control's placeholder attribute.
- Otherwise, use the value of the element's
aria-placeholderattribute. - If none of the above yield a usable text string there is no accessible name.
-
If the control has an
aria-labelor anaria-labelledbyattribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings. -
If the accessible name is still empty: use the text equivalent computation of
the associated
labelelement's subtree - if more than onelabelis associated; concatenate their subtrees by DOM order, delimited by spaces.If the control is encapsulated by its
labelelement, and the control has analtattribute, then exclude the attribute's value from the control's computed accessible name. -
If the accessible name is still empty: use the value of the control's
altattribute if present and its value, when trimmed of whitespace, is not the empty string. -
If the accessible name is still empty: use the value of the control's
titleattribute if present and its value is not the empty string. -
Otherwise, if the previous steps do not yield a usable text string: use the implementation defined string respective
to the input type (an
inputin theimagestate represents a submit button). For instance, a localized string of the word "submit" or the words "Submit Query". - If none of the above yield a usable text string there is no accessible name.
-
If the
fieldsetelement has anaria-labelor anaria-labelledbyattribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings. -
If the accessible name is still empty, then: if the
fieldsetelement has a child that is alegendelement, then use the subtree of the first such element. - If the accessible name is still empty, then:, if the
fieldsetelement has atitleattribute, then use that attribute. - Otherwise, there is no accessible name.
-
If the
outputelement has anaria-labelor anaria-labelledbyattribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings. -
Otherwise use the associated
labelelement or elements accessible name(s) - if more than onelabelis associated; concatenate by DOM order, delimited by spaces. - Otherwise use
titleattribute. - If none of the above yield a usable text string there is no accessible name.
-
If the control has an
aria-labelor anaria-labelledbyattribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings. - Otherwise use
labelelement. - Otherwise use
titleattribute. - If none of the above yield a usable text string there is no accessible name.
-
If the first
summaryelement, which is a direct child of thedetailselement, has anaria-labelor anaria-labelledbyattribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings. - Otherwise use
summaryelement subtree. - Otherwise use
titleattribute. - If there is no
summaryelement as a direct child of thedetailselement, the user agent SHOULD provide one with a subtree containing a localized string of the word "details". -
If there is a
summaryelement as a direct child of thedetailselement, but none of the above yield a usable text string, there is no accessible name.
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.
-
If the
figureelement has anaria-labelor anaria-labelledbyattribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings. - Otherwise, use the
titleattribute. - If none of the above yield a usable text string there is no accessible name.
-
If the
imgelement has anaria-labelor anaria-labelledbyattribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings. -
If the accessible name is still empty: use
altattribute, even if its value, when trimmed of whitespace, is the empty string.NoteAnimgwith analtattribute whose value, when trimmed of whitespace, is the empty string is mapped to thepresentationrole. It has no accessible name. - If the accessible name is still empty and there is no
altattribute, use thetitleattribute. -
If the accessible name is still empty and there are no
altortitleattributes, and theimgis a descendant of afigureelement with a childfigcaptionbut no other non-whitespace flow content descendants, then use the text equivalent computation of thefigcaptionelement's subtree. - Otherwise there is no accessible name.
-
If the
tableelement has anaria-labelor anaria-labelledbyattribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings. -
If the accessible name is still empty, then: if the
tableelement has a child that is acaptionelement, then use the subtree of the first such element. - If the accessible name is still empty, then: if the
tableelement has atitleattribute, then use that attribute. - Otherwise, there is no accessible name.
-
If the element has an
aria-labelor anaria-labelledbyattribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings. - Otherwise use the
titleattribute. - If none of the above yield a usable text string there is no accessible name.
-
If the
aelement has anaria-labelor anaria-labelledbyattribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings. - Otherwise use
aelement subtree. - Otherwise use the
titleattribute. - If none of the above yield a usable text string there is no accessible name.
-
If the
areaelement has anaria-labelor anaria-labelledbyattribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings. - Otherwise use
areaelement'saltattribute. - Otherwise use the
titleattribute. - If none of the above yield a usable text string there is no accessible name.
-
If the element has an
aria-labelor anaria-labelledbyattribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings. - Otherwise use the
titleattribute. - If none of the above yield a usable text string there is no accessible name.
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.
-
If the element has an
aria-labelor anaria-labelledbyattribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings. - Otherwise use the
titleattribute. - If none of the above yield a usable text string 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
-
If the element has an
aria-labelor anaria-labelledbyattribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings. - Otherwise use the
titleattribute. - If none of the above yield a usable text string there is no accessible name.
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.
-
If the element has an
aria-describedbyoraria-descriptionattribute refer to the computation conditions defined in Accessible Name and Description: Computation and API Mappings. -
Otherwise, if the accessible description is still empty, and the element is:
-
a
tableelement which has a childcaptionelement, use the text equivalent computation of the subtree of the firstcaptionelement if it was not used as the accessible name. -
a
summaryelement, use the text equivalent computation of its subtree if it was not used as the accessible name. -
an
inputelement whosetypeattribute is thebutton,submitorresetstate, and it has avalueattribute, then use the flat string of the attribute if it was not used as the accessible name.
-
a
- Otherwise, use the flat string of the
titleattribute if it was not used as the accessible name for the element. - If none of the above are applicable, there is no accessible 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.
A.1.1 Substantive changes since moving to the Accessible Rich Internet Applications Working Group (03-Nov-2019)
- 2-April-2025: Add
commandandcommandforattribute mappings. See GitHub ARIA PR 2354. - 11-July-2024: User Agents ignore
aria-hidden=trueonbodyandhtmlelements. See GitHub PR 516. - 06-June-2024: Add concept of Minimum Role. See GitHub PR 454.
- 06-June-2024: Add
popover,popovertargetandpopovertargetactionmappings. See GitHub PR 481. - 09-Oct-2023: Acknowledge use of
hrelement withinselectelement. See GitHub PR 504. - 03-Oct-2023: Update image mappings to reference the primary synonym roles (
imageandnone). See GitHub PR 498. - 03-Oct-2023: Clarify when to expose required field as invalid. See GitHub PR 429.
- 06-Jun-2023: Add computed roles for all HTML elements. See GitHub PR 465.
- 28-Mar-2023: Add
inertattribute mapping. See GitHub PR 410. - 24-Mar-2023: Add
searchelement and its mappings. See GitHub PR 355. - 08-Mar-2023: Update
hgroupelement to be mapped torole=group. See GitHub PR 398. - 08-Mar-2023: Clarify naming algorithm for
outputelement. See GitHub PR 402. - 12-Dec-2022: Revise mapping for
selement to berole=deletion. See GitHub PR 442. - 28-Nov-2022: Simplify accessible description computation section. See GitHub PR 444.
- 19-Jul-2022: Update
addresselement to be mapped torole=group. See GitHub PR 420. - 03-Apr-2022: Update
asidemappings based on its nesting context. See GitHub PR 350. -
06-Mar-2022: Update the following elements to map to the
genericrole:a no href,footernot scoped tobody,headernot scoped tobody,samp,span. See GitHub PR 364. - 06-Feb-2022: Update
markto point to Core AAM mapping for the role. See GitHub Issue 316. -
02-Nov-2021: Updating
blockquote,caption,code,del,em,ins,meter,paragraph,strong,sub,supandtimeto ARIA 1.2 mappings in Core AAM. Fixbodymapping togeneric, andhtmlmapping todocument. Fixhgroupmapping togeneric. Updatedetailsto map togroupwith additional information specific to ATK, UIA. See GitHub issue #348 - 12-May-2021: Add FACES references to attributes table -
readonly,name,form,disabled. See Issue 257. - 12-Dec-2019: Adds
hgroup,slot, autonomous custom element and form associated custom element. See GitHub issue #189. -
26-Nov-2019: Updates mappings for
disabled,scope,spellcheck,tabindexto point to WAI-ARIA. Adds AXpattern,reversed,rows,size,span,src,start,step,typeattribute mappings. Addsmin-length,ping,playsinline,referrerpolicy,sizes,srcset,data[value]attribute mappings. See GitHub pull request #245.
Substantive changes since moving to the Web Application Working Group (formerly Web Platform WG) (01-Oct-2016)
-
30-Sept-2019: Remove mappings for
rbandrtcelements as they are marked as obsolete in HTML. See GitHub issue #115 and pull request #253. -
23-Sept-2019: Update attribute mappings for
high,low,max,min, andmeterandprogress'svalueattribute. See GitHub pull request #244. - 18-Sept-2019: Update
markelement's UIALocalizedControlTypeand AXAXRoleDescription. See GitHub issue #236. -
18-Sept-2019: Update ATK mappings for
summaryanddetailselements. See GitHub issue #142 and GitHub issue #147. - 18-Sept-2019: Update MSAA mappings for
subandsup. See GitHub pull request #252. -
11-Sept-2019: Update mapping for
menuto match HTML Living Standard. Remove element and attribute mappings that are not applicable tomenuandmenuitem. Update mapping ofmenutorole="list". See GitHub issue #188. - 10-July-2019: Further updated mappings for
insanddelelements. See GitHub pull request #219. - 13-June-2019: Update mappings for
insanddelelements. See GitHub issue #141. - 10-June-2019: Update ATK mappings for
headerandfooterwhen not scoped to thebody. See GitHub issue #129. -
21-May-2019: Update AXAPI mappings for
mapelement. Add accessible name and description computation forarea. See GitHub issue #176. - 11-Apr-2019: Update UIA mappings for
subandsupelements. See Pull request #177. - 20-Mar-2019: Updated IA2 mappings for
supandsubelements. See GitHub issue #174. - 26-Feb-2019: Updated mappings for the
addresselement. See GitHub issue #170. -
19-Feb-2019: Added
placeholderattribute to accessible name computation for variousinputelements. See GitHub issue #167. -
07-Feb-2018: Added entries for the
rbandrtcelements, and updated AXAPI mappings for therb,rtandrubyelements. See GitHub issue #115. - 07-Feb-2018: Updated mappings for the
svgelement. See GitHub issue #43. - 07-Feb-2018: Updated AXAPI mappings for the
delandinselements, and thedatetimeattribute. -
07-Feb-2018: Aligned mappings with CORE-AAM as appropriate for
headerandfooterwhen scoped tobody,aside, andoutput. See GitHub issue #119. - 07-Feb-2018: Updated ATK and AX mappings for the
multipleattribute oninputelement. See GitHub issue #96. - 07-Feb-2018: Updated ATK mappings for the
subandsupelements. See GitHub issue #121. - 07-Feb-2018: Updated mappings for the
bodyelement. See GitHub issue #117. - 01-Feb-2018: Updated IA2 mapping for the
meterelement. See GitHub issue #2. - 29-Jan-2018: Updated heading mapping to reflect implementations. See GitHub issue #116.
- 23-Jan-2018: Added note regarding effect of some CSS properties. See GitHub issue #234.
- 23-Jan-2018: Updated mappings for the
addresselement. See GitHub issue #33. - 23-Jan-2018: Updated mappings for the
dtelement. See GitHub issue #78. - 23-Jan-2018: Updated AXAPI mappings for the
markelement. - 08-Jan-2018: Updated mappings for the
inputelement with thetypeattribute in the Color state. See GitHub issue #48. -
06-Jan-2018: Updated IA2 mappings for the
pre,q, andrubyelements, and themultipleattribute for theinputelement. See GitHub issue #94. - 18-Dec-2017: Rewrote first paragraph in Introduction to better reflect the relationship between the HTML-AAM and CORE-AAM specifications. See GitHub issue #66.
- 18-Dec-2017: Updated
readonlyattribute to usearia-readonly="true"WAI-ARIA mappings. See GitHub issue #93. - 08-Dec-2017: Changed AXAPI mapping for the
canvaselement fromAXImagetoAXGroup. - 01-Dec-2017: Updated mappings for the
dfnelement. See GitHub issue #6. - 30-Nov-2017: Updated mappings for the
meterelement. See GitHub issue #2. - 24-Nov-2017: Updated mappings for the
audioandvideoelements. See GitHub issue #80. - 23-Nov-2017: Updated
figureelement mappings to reflect the WAI-ARIAfigurerole mappings. -
23-Nov-2017: Updated mappings for the
formelement based on presence of accessible name. See GitHub issue #106. -
23-Nov-2017: Removed the accessible name computation requirement to ignore an
imgelement'stitleattribute when the element'saltattribute is empty. See GitHub issue #99. -
23-Nov-2017: Added note to not expose
aria-roledescriptionunless element also a conformingroleattribute value. See GitHub issue #98. - 09-Aug-2017: Updated mappings for the
typeattribute on theolelement. See GitHub issue #91. - 25-July-2017: Updated UIA mappings for multiple elements and attributes. See GitHub issue #95 and GitHub pull request #101.
-
02-June-2017: Updated AXAPI mappings for
titleattribute onabbrelement, andabbrattribute onthelement. See GitHub issue #16. - 31-May-2017: Updated mappings for
hiddenattribute. See GitHub issue #38. - 24-May-2017: Updated mappings for
selectedattribute. See GitHub issue #92. - 01-May-2017: Updated AXAPI mapping for
timeelement. See GitHub issue #88. - 27-Apr-2017: Updated UIA mappings for
langanddirattributes. See GitHub issue #19. -
19-Apr-2017: Updated mapping for
colspanandrowspanattributes. See GitHub issue #56 and issue #57. - 03-Apr-2017: Updated mapping for
sectionelement. See GitHub issue #79. - 23-Dec-2016: No mapping for
datalistelement if not linked withinputelement. See GitHub issue #26. - 23-Dec-2016: Updated IA2 mapping for
listattribute. See GitHub issue #21. - 22-Dec-2016: Sync mappings for
footerandheaderelements. See GitHub issue #59. - 22-Dec-2016: Updated IA2 mapping for
input@type='date'attribute. See GitHub issue #61. - 22-Dec-2016: Updated IA2 mapping for
input@type='file'element. See GitHub issue #62. - 22-Dec-2016: Updated IA2 mapping for
summaryelement. See GitHub issue #64. -
14-Dec-2016: Updated wording distinguishing when
headerandfooterelements are or are not ARIA landmarks. See GitHub issue #65. -
07-Dec-2016: Modified
aria-multiselectablemapping fordatalistto reflect listbox selection model. See GitHub issue #71. - 07-Dec-2016: Mappings for the
multipleattribute oninputandselectelements. See GitHub issue #72. - 27-Nov-2016: Added implementation rules for the
checked,contenteditable,disabled, andindeterminateattributes. - 21-Nov-2016: Removed
placeholderattribute from accessible description computation for variousinputelements.
This section is non-normative.
The following people contributed to the development of this document.
- Adam Page
- Alex Lloyd
- Alexander Surkov
- Bogdan Brinza
- Carolyn MacLeod
- Dan Clark
- Denis Ah-Kang
- Dominique Hazael-Massieux
- einSelbst
- James Craig
- James Nurthen
- Jason Kiss
- joanmarie
- Johanna
- Jon Gunderson
- Léonie Watson
- Marcos Cáceres
- Melanie Richards
- Nick Schonning
- Peter Krautzberger
- Philippe Le Hegaret
- Simon Pieters
- Steve Faulkner
- Valerie Young
- Vikas Parashar
- Xiaoqian Wu
- Yummy_Bacon5
- Yves Lafon
- Rahim Abdi (Apple Inc.)
- NAVYA AGARWAL (Adobe)
- Joey Arhar (Google LLC)
- Benjamin Beaudry (Microsoft Corporation)
- Curt Bellew (Oracle Corporation)
- Zoë Bijl (W3C Invited Experts)
- Gautier Chomel (EDRLab)
- Aleksandar Cindrikj (Netcetera)
- Keith Cirkel (Mozilla Foundation)
- Daniel Clark (Microsoft Corporation)
- Sydney Coleman (Google LLC)
- James Craig (Apple Inc.)
- Chris Cuellar (Bocoup)
- Diego Della Rossa (UsableNet)
- Joanmarie Diggs (Igalia)
- Tamsin Ewing (W3C)
- Mayuri Faldu (Navy Federal Credit Union)
- Betsy Fanning (PDF Association)
- Steve Faulkner (TetraLogical Services Ltd)
- Patrick Foster (axes4 GmbH)
- Jane Fulton (Cisco)
- Bryan Garaventa (W3C Invited Experts)
- Matt Garrish (DAISY Consortium)
- Doug Geoffray (Microsoft Corporation)
- Ariella Gilmore (IBM Corporation)
- Taylore Givens (Microsoft Corporation)
- David Grogan (Google LLC)
- Shirisha Gubba (Google LLC)
- Jon Gunderson (University of Illinois)
- Oliver Habersetzer (SAP SE)
- Theo Hale (W3C Invited Experts)
- Sunny Hardasani (Adobe)
- Matthew Hardy (Adobe)
- Chris Harrelson (Google LLC)
- Sarah Higley (Microsoft Corporation)
- Hans Hillen (TPGi)
- takumi hiramatsu (Cybozu)
- Stanley Hon (Microsoft Corporation)
- Michael Jackson (Microsoft Corporation)
- John Jansen (Microsoft Corporation)
- Jilin Jiang (Ant Group Co., Ltd.)
- Duff Johnson (PDF Association)
- Summer Jones (Thomson Reuters Corp.)
- Yuki Kamahori (Cybozu)
- William Kilian (Kilian Codes LLC)
- Matthew King (W3C Invited Experts)
- Zachary Kinsey (TargetStream Technologies)
- Daisuke Kobayashi (Cybozu)
- Peter Krautzberger (krautzource UG)
- Nina Krauß (SAP SE)
- JaEun Jemma Ku (University of Illinois)
- Steven Lambert (Deque Systems, Inc.)
- Joe Lamyman (TetraLogical Services Ltd)
- Christopher Land (Oracle Corporation)
- Charles LaPierre (Benetech)
- Patrick Lauke (TetraLogical Services Ltd)
- Philip Lazarevic (Level Access)
- Leo Lee (Microsoft Corporation)
- Brett Lewis (TPGi)
- Alison Maher (Microsoft Corporation)
- Gurpreet Kaur Mangera (Rakuten Group, Inc.)
- Mark McCarthy (University of Illinois)
- Katie McDermott (See Me Please)
- Eduardo Meza Etienne (Navy Federal Credit Union)
- Clay Miller (Microsoft Corporation)
- Hirotaka Minamida (Cybozu)
- Daniel Montalvo (W3C)
- Baldino Morelli (UsableNet)
- Jacques Newman (Microsoft Corporation)
- James Nurthen (Evinced Inc.)
- Scott O'Hara (Microsoft Corporation)
- Lola Odelola (W3C Invited Experts)
- Neil Osman (Evinced Inc.)
- Yusuke Oyama (Cybozu)
- Adam Page (Hilton)
- Michael Pennisi (Bocoup)
- Giacomo Petri (UsableNet)
- Noah Praskins (TPGi)
- Lucas Radaelli (Google LLC)
- Paul Rayius (PDFix-US)
- Mark Rogers (Powermapper Software)
- Adrian Roselli (W3C Invited Experts)
- Marco Sabidussi (UsableNet)
- Trisha Salas (Level Access)
- Stefan Schnabel (SAP SE)
- Harris Schneiderman (Deque Systems, Inc.)
- Raymond Schwartz (Navy Federal Credit Union)
- Davis Shaver (The Washington Post)
- Cynthia Shelly (W3C Invited Experts)
- Tzviya Siegman (W3C)
- Avneesh Singh (DAISY Consortium)
- Michael[tm] Smith (sideshowbarker) (W3C)
- Francis Storr (Intel Corporation)
- Nobukiyo Sugisaki (Cybozu)
- Melanie Sumner (IBM Corporation)
- Alexander Surkov (Igalia)
- James Teh (Mozilla Foundation)
- Roman Toda (Foxit software)
- David Tseng (Google LLC)
- Cybozu W3C (Cybozu)
This publication has been funded in part with U.S. Federal funds from the Department of Education, National Institute on Disability, Independent Living, and Rehabilitation Research (NIDILRR), initially under contract number ED-OSE-10-C-0067, then under contract number HHSP23301500054C, and now under HHS75P00120P00168. The content of this publication does not necessarily reflect the views or policies of the U.S. Department of Education, nor does mention of trade names, commercial products, or organizations imply endorsement by the U.S. Government.
- [accname-1.2]
- Accessible Name and Description Computation 1.2. Bryan Garaventa; Melanie Sumner. W3C. 29 May 2026. W3C Working Draft. URL: https://www.w3.org/TR/accname-1.2/
- [core-aam-1.2]
- Core Accessibility API Mappings 1.2. Valerie Young; Cynthia Shelly. W3C. 2 July 2026. CRD. URL: https://www.w3.org/TR/core-aam-1.2/
- [HTML]
- HTML Standard. Anne van Kesteren; Domenic Denicola; Dominic Farolino; Ian Hickson; Philip Jägenstedt; Simon Pieters. WHATWG. Living Standard. URL: https://html.spec.whatwg.org/multipage/
- [infra]
- Infra Standard. Anne van Kesteren; Domenic Denicola. WHATWG. Living Standard. URL: https://infra.spec.whatwg.org/
- [RFC2119]
- Key words for use in RFCs to Indicate Requirement Levels. S. Bradner. IETF. March 1997. Best Current Practice. URL: https://www.rfc-editor.org/info/rfc2119/
- [RFC8174]
- Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words. B. Leiba. IETF. May 2017. Best Current Practice. URL: https://www.rfc-editor.org/info/rfc8174/
- [svg-aam-1.0]
- SVG Accessibility API Mappings. Cynthia Shelly; Mark Rogers. W3C. 27 July 2026. W3C Working Draft. URL: https://www.w3.org/TR/svg-aam-1.0/
- [WAI-ARIA]
- Accessible Rich Internet Applications (WAI-ARIA) 1.0. James Craig; Michael Cooper et al. W3C. 20 March 2014. W3C Recommendation. URL: https://www.w3.org/TR/wai-aria/
- [WAI-ARIA-1.2]
- Accessible Rich Internet Applications (WAI-ARIA) 1.2. Joanmarie Diggs; James Nurthen; Michael Cooper; Carolyn MacLeod. W3C. 6 June 2023. W3C Recommendation. URL: https://www.w3.org/TR/wai-aria-1.2/
- [AT-SPI]
- Assistive Technology Service Provider Interface. The GNOME Project. URL: https://gnome.pages.gitlab.gnome.org/at-spi2-core/libatspi/
- [ATK]
- ATK - Accessibility Toolkit. The GNOME Project. URL: https://developer.gnome.org/atk/stable/
- [AXAPI]
- The NSAccessibility Protocol for macOS. Apple, Inc. URL: https://developer.apple.com/documentation/appkit/nsaccessibility
- [dom]
- DOM Standard. Anne van Kesteren. WHATWG. Living Standard. URL: https://dom.spec.whatwg.org/
- [HTML5]
- HTML5. Ian Hickson; Robin Berjon; Steve Faulkner; Travis Leithead; Erika Doyle Navara; Theresa O'Connor; Silvia Pfeiffer. W3C. 27 March 2018. W3C Recommendation. URL: https://www.w3.org/TR/html5/
- [IAccessible2]
- IAccessible2. Linux Foundation. URL: https://wiki.linuxfoundation.org/accessibility/iaccessible2/
- [UI-AUTOMATION]
- UI Automation. Microsoft Corporation. URL: https://docs.microsoft.com/en-us/windows/win32/winauto/ui-automation-specification
