Copyright © 2015-2023 World Wide Web Consortium. W3C® liability, trademark and permissive document license rules apply.
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.1 for use with the HTML host language. Documenting these mappings promotes interoperable exposure of roles, states, properties, and events implemented by accessibility APIs and helps to ensure that this information appears in a manner consistent with author intent.
The HTML-AAM is part of the WAI-ARIA suite described in the WAI-ARIA Overview.
This 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 technical reports index at https://www.w3.org/TR/.
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 a Working Draft using the Recommendation track.
Publication as a Working 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 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 which 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 2 November 2021 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.1 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 ([core-aam-1.2]) specification.
In some cases, often due to features of the HTML host language or the accessibility API in question, an element or attribute's mapping differs from the corresponding ARIA mappings specified in the [core-aam-1.2]. Where an HTML element or attribute does not have any default WAI-ARIA semantics, the applicable mapping for each platform accessibility API is defined by this specification.
This document also adapts the 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:
Accessibility APIs covered by this document are:
If user agent developers need to expose information using other accessibility APIs, it is recommended that they work closely with the developer of the platform where the API runs, and assistive technology developers on that platform.
For more information regarding accessibility APIs, refer to section 1.1 Accessibility APIs of the Core 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.
The classification of a section as normative or non-normative applies to the entire section and all sub-sections of that section.
Normative sections provide requirements that authors, user agents, and assistive technologies MUST follow for an implementation to conform to this specification.
Non-normative 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].
Where an HTML element or attribute has default WAI-ARIA semantics, it MUST be exposed 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].
display: none
. In these cases, the user agent SHOULD map such elements to the role of generic
.generic
role, user agents MUST NOT expose the aria-roledescription
property value in the accessibility tree unless the element has an explicit, conforming role
attribute value which [WAI-ARIA-1.2] does not prohibit the use of aria-roledescription
.label
element's for
attribute, or a descendant of a label
element, the labelable element's UIA LabeledBy
property points to the UIA element for the label
element.Text
Control Type are not generally represented as accessible objects in the accessibility tree, but are just part of the Text
Control Pattern implemented for the whole HTML document. However, if they have any aria-
attributes or an explicit tabindex
specified, elements mapped to the Text
Control Type will be represented as accessible objects in the accessibility tree.a
(represents a hyperlink)
[wai-aria-1.2] |
link role
|
---|---|
Computed Role | Use WAI-ARIA mapping |
MSAA + IAccessible2 | Use WAI-ARIA mapping |
UIA | Use WAI-ARIA mapping |
ATK | Use WAI-ARIA mapping |
AX | Use WAI-ARIA mapping |
Comments |
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 |
abbr
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role | html-abbr |
MSAA + IAccessible2 |
Roles:
ROLE_SYSTEM_TEXT ; IA2_ROLE_TEXT_FRAME
Object attributes:
"abbr" attribute on the containing
td if a single child, text content used as a value
|
UIA |
Control Type:
Text
|
ATK |
Role:
ATK_ROLE_STATIC
Object attributes:
"abbr" attribute on the containing
td if a single child, text content used as a value
|
AX |
AXRole:
AXGroup
AXSubrole:
(nil)
AXRoleDescription:
"group"
|
Comments |
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 |
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 |
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 |
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 |
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 |
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 |
audio
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role | html-audio |
MSAA + IAccessible2 |
Role:
ROLE_SYSTEM_GROUPING
|
UIA |
Control Type:
Group
Localized Control Type:
"audio"
Note: If the
controls attribute is present, UI controls (e.g., play, volume) are exposed as children of the audio element in the accessibility tree, and mapped as appropriate for the type of control (e.g., button or slider ).
Text objects associated with loading or error messages, and any UI control not currently displayed, MAY be present in the accessibility tree and marked as hidden or off-screen.
|
ATK |
Role:
ATK_ROLE_AUDIO
|
AX |
AXRole:
AXGroup
AXSubrole:
AXAudio
AXRoleDescription:
"audio playback"
Note: If the
controls attribute is present, UI controls (e.g., play, volume) are exposed as descendants of an accessible object with a role of toolbar , and mapped as appropriate for the type of control (e.g., button or slider ).
|
Comments |
[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 |
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. |
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 |
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. |
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. |
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 |
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 |
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. |
button
[wai-aria-1.2] |
button role
|
---|---|
Computed Role | Use WAI-ARIA mapping |
MSAA + IAccessible2 | Use WAI-ARIA mapping |
UIA | Use WAI-ARIA mapping |
ATK | Use WAI-ARIA mapping |
AX | Use WAI-ARIA mapping |
Comments |
A button 's mapping will change if the
aria-pressed or
aria-haspopup attributes are specified.
|
canvas
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role | html-canvas |
MSAA + IAccessible2 |
Roles:
ROLE_SYSTEM_GRAPHIC ; IA2_ROLE_CANVAS
|
UIA |
Control Type:
Image
Descendants of the
canvas element are mapped separately.
|
ATK |
Role:
ATK_ROLE_CANVAS
|
AX |
AXRole:
AXGroup
AXSubrole:
(nil)
AXRoleDescription:
""
|
Comments |
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 | If a descendant of a table , the first instance of a caption element will provide the table its accessible name. |
cite
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role | html-cite |
MSAA + IAccessible2 |
No accessible object. Styles used are mapped into text attributes on its text container.
|
UIA |
No accessible object. Styles used are exposed by UIA text attributes of the
TextRange Control Pattern implemented on a parent accessible object.
|
ATK |
No accessible object. Styles used are mapped into text attributes on its text container.
|
AX |
AXRole:
AXGroup
AXSubrole:
(nil)
AXRoleDescription:
"group"
|
Comments |
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 |
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 |
colgroup
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role | Not mapped |
MSAA + IAccessible2 |
Role:
ROLE_SYSTEM_GROUPING
|
UIA |
Control Type:
Group
Localized Control Type:
"colgroup"
|
ATK | Not mapped |
AX | Not mapped |
Comments |
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 |
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.
|
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 |
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 |
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 |
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 |
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.
|
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 |
dl
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role |
list
Note
Editorial Note: This value may change upon resolution of ARIA #1662.
|
MSAA + IAccessible2 |
Role:
ROLE_SYSTEM_LIST
States:
STATE_SYSTEM_READONLY
|
UIA |
Control Type:
List
|
ATK |
Role:
ATK_ROLE_DESCRIPTION_LIST
|
AX |
AXRole:
AXList
AXSubrole:
AXDefinitionList
AXRoleDescription:
"definition list"
|
Comments |
dt
[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 |
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 |
embed
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role | html-embed |
MSAA + IAccessible2 |
Roles:
ROLE_SYSTEM_CLIENT ; IA2_ROLE_EMBEDDED_OBJECT
States:
STATE_SYSTEM_UNAVAILABLE for windowless plugin
|
UIA |
Control Type:
Pane
|
ATK |
Role:
ATK_ROLE_EMBEDDED
|
AX | Depends on format of data file |
Comments |
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:
AXFieldset
AXDescription: value from child
legend subtree
|
Comments |
figcaption
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role | caption |
MSAA + IAccessible2 |
Roles:
ROLE_SYSTEM_TEXT ; IA2_ROLE_CAPTION
|
UIA |
Control Type:
Text
|
ATK |
Role:
ATK_ROLE_CAPTION
|
AX |
AXRole:
AXGroup
AXSubrole:
(nil)
AXRoleDescription:
"group"
|
Comments |
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
Accessible name derived from
figcaption according to the figure Element Accessible Name Computation
|
ATK |
Role: Use WAI-ARIA mapping
Name: related
figcaption content
|
AX |
AXRole: Use WAI-ARIA mapping
|
Comments |
footer
(scoped to the body
element)
[wai-aria-1.2] |
contentinfo role
|
---|---|
Computed Role | Use WAI-ARIA mapping |
MSAA + IAccessible2 | Use WAI-ARIA mapping |
UIA | Use WAI-ARIA mapping |
ATK | Use WAI-ARIA mapping |
AX | Use WAI-ARIA mapping |
Comments |
footer
(scoped to the main
element,
a sectioning content element)
[wai-aria-1.2] |
generic role
Note
Editorial Note: This value may change upon resolution of ARIA #1915.
|
---|---|
Computed Role | Use WAI-ARIA mapping |
MSAA + IAccessible2 | Use WAI-ARIA mapping |
UIA |
Control Type:
Group
Localized Control Type:
"footer"
|
ATK |
Role:
ATK_ROLE_FOOTER
|
AX | Use WAI-ARIA mapping |
Comments |
If a footer is not scoped to the body element,
do not expose the element as a contentinfo landmark.
|
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.
|
[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 |
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 |
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 |
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 |
header
(scoped to the main
element, or a sectioning content element)
[wai-aria-1.2] |
generic role
Note
Editorial Note: This value may change upon resolution of ARIA #1915.
|
---|---|
Computed Role | Use WAI-ARIA mapping |
MSAA + IAccessible2 | Use WAI-ARIA mapping |
UIA |
Control Type:
Group
Localized Control Type:
"header"
|
ATK |
Role:
ATK_ROLE_HEADER
|
AX | Use WAI-ARIA mapping |
Comments |
If a header is not scoped to the body element,
do not expose the element as a banner landmark.
|
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 heading element with the highest priority level
MAY be treated as the sole heading of the hgroup . All other heading elements MAY instead be exposed as if they
were p elements. See paragraph role on Core AAM.
|
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 |
html
[wai-aria-1.2] | document 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 |
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. |
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 |
AXRole:
AXWebArea
AXSubrole:
(nil)
AXRoleDescription:
"html content"
|
Comments |
img
[wai-aria-1.2] | 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 |
img
(alt
attribute value is an empty string, i.e. alt=""
or alt
with no value in the markup)
[wai-aria-1.2] | |
---|---|
Computed Role | Use WAI-ARIA mapping |
MSAA + IAccessible2 | Use WAI-ARIA mapping |
UIA | Use WAI-ARIA mapping |
ATK | Use WAI-ARIA mapping |
AX | Use WAI-ARIA mapping |
Comments |
input
(type
attribute in the
Button state)
[wai-aria-1.2] |
button role
|
---|---|
Computed Role | Use WAI-ARIA mapping |
MSAA + IAccessible2 | Use WAI-ARIA mapping |
UIA | Use WAI-ARIA mapping |
ATK | Use WAI-ARIA mapping |
AX | Use WAI-ARIA mapping |
Comments |
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 |
input
(type
attribute in the
Color state)
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role | html-input-color |
MSAA + IAccessible2 |
If implemented as a textbox:
Roles:
ROLE_SYSTEM_TEXT If implemented as a color picker:
Roles:
IA2_ROLE_COLOR_CHOOSER |
UIA |
If implemented as a textbox:
Control Type:
Edit Localized Control Type: "edit"
If implemented as a color picker:
Control Type:
button Localized Control Type: "color picker"
|
ATK |
If implemented as a button, use WAI-ARIA mapping for
button .
If implemented as a textbox, use WAI-ARIA mapping for
textbox .
|
AX |
If implemented as a textbox:
AXRole:
AXTextField AXSubrole:
(nil) AXRoleDescription:
"text field" If implemented as a color picker:
AXRole:
AXColorWell AXSubrole:
(nil) AXRoleDescription:
"color well" |
Comments |
If implemented as a color picker, any UI controls presented for selecting a color are exposed in the accessibility tree, associated with the
input element, and mapped as appropriate for the type of control (e.g. button or slider).
|
input
(type
attribute in the
Date state)
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role | html-input-date |
MSAA + IAccessible2 |
If implemented as a textbox:
Role:
ROLE_SYSTEM_TEXT
Object attributes:
text-input-type:date
If implemented as a date picker:
Role:
IA2_ROLE_DATE_EDITOR
|
UIA |
Depends on UI design of implementation. The UI in Windows 10 Edge, for example, is a composite of multiple spinners.
|
ATK |
Role:
ATK_ROLE_CALENDAR
|
AX |
AXRole:
AXDateField
AXSubrole:
(nil)
AXRoleDescription:
"date field"
|
Comments |
input
(type
attribute in the
Local Date and Time state)
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role |
Role:
IA2_ROLE_DATE_EDITOR
|
MSAA + IAccessible2 |
Depends on UI design of implementation. The UI in Windows 10 Edge, for Example, is a composite of multiple spinners.
|
UIA |
Role:
ATK_ROLE_CALENDAR
|
ATK |
AXRole:
AXTextField
AXSubrole:
(nil)
AXRoleDescription:
"text field"
|
AX |
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
Localized Control Type:
"email"
|
ATK | Use WAI-ARIA mapping |
AX | Use WAI-ARIA mapping |
Comments |
input
(type
attribute in the
File Upload state)
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role | html-input-file |
MSAA + IAccessible2 |
Implementation dependent. If represented by a container with a button a text label inside then:
Roles:
IA2_ROLE_TEXT_FRAME
Children:
ROLE_SYSTEM_PUSHBUTTON and IA2_ROLE_LABEL for a button and a text label elements.
|
UIA |
Can be rendered as a single button control, or as a button control with a text input field.
Button control:
Control Type:
Button
Text input field:
Control Type:
Edit
Localized Control Type:
"file"
|
ATK |
Role:
ATK_ROLE_STATIC
Children:
ATK_ROLE_PUSH_BUTTON when pressed ATK_ROLE_FILE_CHOOSER dialog shown
|
AX |
AXRole:
AXButton
AXSubrole:
AXFileUploadButton
AXRoleDescription:
file upload button
|
Comments |
[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 |
input
(type
attribute in the
Image Button state)
[wai-aria-1.2] | button role |
---|---|
Computed Role | Use WAI-ARIA mapping |
MSAA + IAccessible2 | Use WAI-ARIA mapping |
UIA | Use WAI-ARIA mapping |
ATK | Use WAI-ARIA mapping |
AX | Use WAI-ARIA mapping |
Comments |
input
(type
attribute in the
Month state)
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role | html-input-month |
MSAA + IAccessible2 |
Role:
IA2_ROLE_DATE_EDITOR
|
UIA |
Depends on UI design of implementation. The UI in Windows 10 Edge, for Example, is a composite of multiple spinners.
|
ATK |
Role:
ATK_ROLE_DATE_EDITOR
|
AX |
AXRole:
AXTextField
AXSubrole:
(nil)
AXRoleDescription:
"text field"
|
Comments |
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 |
If implemented as a spin button, use WAI-ARIA mapping for
spinbutton .If implemented as a text input:
Control Type:
Edit
Localized Control Type:
"number"
|
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 |
input
(type
attribute in the
Password state)
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role | html-input-password |
MSAA + IAccessible2 |
Role:
ROLE_SYSTEM_TEXT
States:
STATE_SYSTEM_PROTECTED ; IA2_STATE_SINGLE_LINE ; STATE_SYSTEM_READONLY if readonly, otherwise IA2_STATE_EDITABLE
|
UIA |
Control Type:
Edit
Localized Control Type:
"password"
Other properties: Set
isPassword to true
|
ATK |
Role:
ATK_ROLE_PASSWORD_TEXT
States:
ATK_STATE_SINGLE_LINE ; ATK_STATE_READ_ONLY if readonly, otherwise ATK_STATE_EDITABLE
|
AX |
AXRole:
AXTextField
AXSubrole:
AXSecureTextField
AXRoleDescription:
"secure text field"
|
Comments |
input
(type
attribute in the
Radio Button state)
[wai-aria-1.2] |
radio role, with the
aria-checked state set to "true" if the element's
checkedness is true, or "false" otherwise.
With aria-setsize value reflecting number of type=radio input elements within the
radio button group
and aria-posinset value reflecting the elements position within the radio button group.
|
---|---|
Computed Role | Use WAI-ARIA mapping |
MSAA + IAccessible2 | Use WAI-ARIA mapping |
UIA | Use WAI-ARIA mapping |
ATK | Use WAI-ARIA mapping |
AX | Use WAI-ARIA mapping |
Comments |
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 |
input
(type
attribute in the
Reset Button state)
[wai-aria-1.2] |
button role
|
---|---|
Computed Role | Use WAI-ARIA mapping |
MSAA + IAccessible2 | Use WAI-ARIA mapping |
UIA | Use WAI-ARIA mapping |
ATK | Use WAI-ARIA mapping |
AX | Use WAI-ARIA mapping |
Comments |
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 |
input
(type
attribute in the
Submit Button state)
[wai-aria-1.2] |
button role
|
---|---|
Computed Role | Use WAI-ARIA mapping |
MSAA + IAccessible2 | Use WAI-ARIA mapping |
UIA | Use WAI-ARIA mapping |
ATK | Use WAI-ARIA mapping |
AX | Use WAI-ARIA mapping |
Comments |
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
Localized Control Type:
"telephone"
|
ATK | Use WAI-ARIA mapping |
AX | Use WAI-ARIA mapping |
Comments |
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 |
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 |
input
(type
attribute in the
Time state)
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role | html-input-time |
MSAA + IAccessible2 |
Role:
ROLE_SYSTEM_SPINBUTTON if implemented as a simple widget; ROLE_SYSTEM_GROUPING with child controls mapped as appropriate if implemented as a complex widget
Object attributes:
text-input-type:time
|
UIA |
Depends on UI design of implementation. The UI in Windows 10 Edge, for Example, is a composite of multiple spinners.
|
ATK | |
AX |
AXRole:
AXTimeField
AXSubrole:
(nil)
AXRoleDescription:
"time field"
|
Comments |
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
Localized Control Type:
"url" |
ATK | Use WAI-ARIA mapping |
AX | Use WAI-ARIA mapping |
Comments |
input
(type
attribute in the
Week state)
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role | html-imput-week |
MSAA + IAccessible2 |
Role:
IA2_ROLE_DATE_EDITOR
Object attributes:
text-input-type:week
|
UIA |
Depends on UI design of implementation. The UI in Windows 10 Edge, for Example, is a composite of multiple spinners.
|
ATK |
Role:
ATK_ROLE_CALENDAR
|
AX |
AXRole:
AXTextField
AXSubrole:
(nil)
AXRoleDescription:
"text field"
|
Comments |
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 |
kbd
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role | html-kbd |
MSAA + IAccessible2 |
No accessible object.
Text attributes:
font-family:monospace on the text container
|
UIA |
No accessible object. Styles used are exposed by UIA text attribute identifiers of the
TextRange Control Pattern implemented on a parent accessible object.
|
ATK |
No accessible object. Mapped into "font-family:monospace" text attribute on its text container.
|
AX |
AXRole:
AXGroup
AXSubrole:
(nil)
AXRoleDescription:
"group"
|
Comments |
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:
Text
Relations:
When the
label element contains a labelable element, the LabeledBy property for
the element points to the UIA element for the label element.
When the
label element has a for attribute referencing a
labelable element, the LabeledBy property for the referenced element points to
the UIA element for the label element.
|
ATK |
Role:
ATK_ROLE_LABEL
Relations:
ATK_RELATION_LABEL_FOR for a child labelable element or
labelable element referred by for attribute.
Note, related labelable element provides ATK_RELATION_LABELLED_BY pointing to the label .
|
AX |
AXRole:
AXGroup
AXSubrole:
(nil)
AXRoleDescription:
"group"
|
Comments |
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:
AXGroup
AXSubrole:
(nil)
AXRoleDescription:
"group"
|
Comments |
li
[wai-aria-1.2] |
listitem role with
aria-setsize value reflecting number of
li elements within the parent ol , menu or ul
and aria-posinset
value reflecting the li elements position within the set.
|
---|---|
Computed Role | Use WAI-ARIA mapping |
MSAA + IAccessible2 | Use WAI-ARIA mapping |
UIA | Use WAI-ARIA mapping |
ATK | Use WAI-ARIA mapping |
AX | Use WAI-ARIA mapping |
Comments |
If li element is not a child of ol , menu or ul , or if the containing
list element is no longer exposed with a list role, then expose the li element with a generic role.
|
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 |
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 |
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 |
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 |
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.
|
menu
[wai-aria-1.2] | list role |
---|---|
Computed Role | Use WAI-ARIA mapping |
MSAA + IAccessible2 | Use WAI-ARIA mapping |
UIA | Use WAI-ARIA mapping |
ATK | Use WAI-ARIA mapping |
AX | Use WAI-ARIA mapping |
Comments |
The
menu element is a semantic alternative to the ul element.
It has no implemented mappings or behavior that reflect the semantics of the ARIA
menu role.
Note obsolete
menuitem element
and menu with type attribute.
|
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 |
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 |
nav
[wai-aria-1.2] | navigation role |
---|---|
Computed Role | Use WAI-ARIA mapping |
MSAA + IAccessible2 | Use WAI-ARIA mapping |
UIA | Use WAI-ARIA mapping |
ATK | Use WAI-ARIA mapping |
AX | Use WAI-ARIA mapping |
Comments |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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.
|
rp
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role | htmp-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 |
rt
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role | html-rt |
MSAA + IAccessible2 |
No accessible object. No child elements are exposed if
ruby is supported by the browser.
|
UIA |
No accessible object.
|
ATK |
No accessible object.
|
AX |
AXRole:
AXGroup
AXSubrole:
AXRubyText
AXRoleDescription:
"group"
|
Comments |
ruby
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role | html-ruby |
MSAA + IAccessible2 |
Role:
ROLE_SYSTEM_TEXT ; IA2_ROLE_TEXT_FRAME
|
UIA |
Control Type:
Text
Localized Control Type:
"ruby"
|
ATK |
Role:
ATK_ROLE_STATIC
|
AX |
AXRole:
AXGroup
AXSubrole:
AXRubyInline
AXRoleDescription:
"group"
|
Comments |
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 |
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 |
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 |
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 |
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 |
select
(with a multiple
attribute or
size
attribute having value greater than 1
)
[wai-aria-1.2] | listbox role |
---|---|
Computed Role | Use WAI-ARIA mapping |
MSAA + IAccessible2 | Use WAI-ARIA mapping |
UIA | Use WAI-ARIA mapping |
ATK | Use WAI-ARIA mapping |
AX | Use WAI-ARIA mapping |
Comments |
select
(with NO multiple
attribute
and NO size
attribute having value greater than 1
)
[wai-aria-1.2] | combobox role |
---|---|
Computed Role | Use WAI-ARIA mapping |
MSAA + IAccessible2 | Use WAI-ARIA mapping |
UIA | Use WAI-ARIA mapping |
ATK | Use WAI-ARIA mapping |
AX | Use WAI-ARIA mapping |
Comments |
slot
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role | Use WAI-ARIA mapping |
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
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. |
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 |
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 |
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 |
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.
|
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 |
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:
Button
Control Pattern:
ExpandCollapse
|
ATK |
Role:
ROLE_TOGGLE_BUTTON
Relations:
ATK_RELATION_DETAILS
|
AX |
AXRole:
AXDisclosureTriangle
AXSubrole:
(nil)
AXRoleDescription:
"disclosure triangle"
|
Comments |
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 |
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
|
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 |
Comments |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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. |
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 |
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 |
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. |
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 |
var
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role | html-var |
MSAA + IAccessible2 |
No accessible object. Styles used are mapped to text attributes on its text container.
|
UIA |
No accessible object. Styles used are exposed by UIA text attribute identifiers of the
TextRange Control Pattern implemented on a parent accessible object.
|
ATK |
No accessible object. Styles used are mapped to text attributes on its text container.
|
AX |
AXRole:
AXGroup
AXSubrole:
(nil)
AXRoleDescription:
"group"
|
Comments |
video
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role | html-video |
MSAA + IAccessible2 |
Role:
ROLE_SYSTEM_GROUPING
|
UIA |
Control Type:
Group
Localized Control Type:
"group"
Note: If the
controls attribute is present, UI controls (e.g., play, volume) are exposed as children of the video element in the accessibility tree, and mapped as appropriate for the type of control (e.g., button or slider ).
Text objects associated with loading or error messages, and any UI control not currently displayed, MAY be present in the accessibility tree and marked as hidden or off-screen.
|
ATK |
Role:
ATK_ROLE_VIDEO
|
AX |
AXRole:
AXGroup
AXSubrole:
AXVideo
AXRoleDescription:
"video playback"
Note: If the
controls attribute is present, UI controls (e.g., play, volume) are exposed as descendants of an accessible object with a role of toolbar , and mapped as appropriate for the type of control (e.g., button or slider ).
|
Comments |
wbr
[wai-aria-1.2] | No corresponding role |
---|---|
Computed Role | Not mapped |
MSAA + IAccessible2 |
If a line break is added, expose it with
IAccessibleText on the text container
|
UIA | Not mapped |
ATK |
A line break if added is exposed via Text interface on its text container
|
AX |
AXRole:
AXGroup
AXSubrole:
(nil)
AXRoleDescription:
"group"
|
Comments |
abbr
[
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 |
accept
[
input
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
accept-charset
[
form
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
accesskey
[
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 |
action
[
form
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
allow
[
iframe
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
allowfullscreen
[
iframe
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
alt
[
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 |
as
[
link
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
async
[
script
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
autocapitalize
[
HTML elements
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
autocomplete
[
form
][WAI-ARIA-1.2] |
Note
Note: the ARIA attribute and the HTML attribute have disparate features.
|
---|---|
MSAA + IAccessible2 |
States:
STATE_SUPPORTS_AUTOCOMPLETION on text form controls until the value is overridden by control
|
UIA | Not mapped |
ATK |
States:
ATK_STATE_SUPPORTS_AUTOCOMPLETION on text form controls until the value is overridden by control
|
AX | Not mapped |
Comments |
If the element includes both autocomplete and aria-autocomplete attributes with valid values,
User Agents MUST expose only the autocomplete attribute value. The aria-autocomplete attribute is
not valid on a form element.
|
autocomplete
[
input
, select
and textarea
][WAI-ARIA-1.2] |
Note
Note: the ARIA attribute and the HTML attribute have disparate features.
|
---|---|
MSAA + IAccessible2 |
States:
STATE_SUPPORTS_AUTOCOMPLETION
|
UIA | Not mapped |
ATK |
States:
ATK_STATE_SUPPORTS_AUTOCOMPLETION
|
AX | Not mapped |
Comments |
If the element includes both autocomplete and aria-autocomplete attributes with valid values,
User Agents MUST expose only the autocomplete attribute value.
|
autofocus
[
HTML elements
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
Similar to |
autoplay
[
audio
and video
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
blocking
[
link
;
script
;
style
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
charset
[
meta
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
checked
(if present) [
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.
|
checked
(if absent) [
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.
|
cite
[
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 |
class
[
HTML elements
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
color
[
link
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
cols
[
textarea
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | AXRangeForLine: <value> |
Comments | Not mapped |
colspan
[
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 |
content
[
meta
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
contenteditable
[
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:
TextEdit
Property:
AriaProperties.multiline:true
If 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:
AtkEditableText
If 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.
|
controls
[
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 |
coords
[
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 |
crossorigin
[
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 |
data
[
object
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
datetime
[
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 |
datetime
[
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 |
decoding
[
img
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
default
[
track
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
defer
[
script
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
dir
[
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 |
dir
[
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 |
dirname
[
input
and
textarea
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
disabled
[
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.
|
disabled
[
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 |
disabled
[
link
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
download
[
a
and area
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
draggable
[
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 |
enctype
[
form
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
enterkeyhint
[
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. |
fetchpriority
[
img
;
link
;
script
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
for
[
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 |
for
[
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 |
form
[
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 |
formaction
[
button
;
input
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
formenctype
[
button
;
input
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
formmethod
[
button
;
input
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
formnovalidate
[
button
;
input
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
formtarget
[
button
; input
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
headers
[
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 |
height
[
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 |
[WAI-ARIA-1.2] |
aria-hidden="true" if the element retains its user agent default styling of display: none . Otherwise, if no other method for hiding the content is used (e.g., visibility: hidden ) then it is not mapped.
|
---|---|
MSAA + IAccessible2 | Use WAI-ARIA mapping |
UIA | Use WAI-ARIA mapping |
ATK | Use WAI-ARIA mapping |
AX | Use WAI-ARIA mapping |
Comments |
high
[
meter
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | RangeValue.Maximum |
ATK | Not mapped |
AX | Not mapped |
Comments |
href
[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 |
href
[
link
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
hreflang
[
a
;
link
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
http-equiv
[
meta
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
id
[
HTML elements
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
inert
[
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. |
indeterminate [IDL]
[
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 theindeterminate [IDL] state. |
ismap
[
img
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
itemid
[
img
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
itemprop
[
img
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
itemref
[
img
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
itemscope
[
img
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
itemtype
[
img
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
kind
[
track
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
label
[
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 1.1 |
lang
[
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 |
list
[
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.
|
loop
[
audio
;
video
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
low
[
meter
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | RangeValue.Minimum |
ATK | Not mapped |
AX | Not mapped |
Comments |
max
[
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 |
max
[
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 |
maxlength
[
input
;
textarea
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
media
[
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 |
method
[
form
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
min
[
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 |
min
[
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 |
minlength
[
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 |
multiple
[
input
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
multiple
[
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 |
muted
[
audio
;
video
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
name
[
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 |
name
[
form
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
name
[
iframe
;
object
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
name
[
map
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
name
[
meta
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
name
[
slot
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
nomodule
[
script
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
nonce
[
HTML elements
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
novalidate
[
form
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
open
[
details
][WAI-ARIA-1.2] | aria-expanded ="true | false" |
---|---|
MSAA + IAccessible2 | STATE_SYSTEM_EXPANDED STATE_SYSTEM_COLLAPSED |
UIA |
ExpandCollapsePattern
|
ATK |
States:
ATK_STATE_COLLAPSED or ATK_STATE_EXPANDED depending
on the attribute value
|
AX | AXExpanded: YES|NO |
Comments | Set properties on the summary element. |
open
[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 |
optimum
[
meter
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
pattern
[
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 |
ping
[
a
and area
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
placeholder
[
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. |
playsinline
[
video
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
poster
[
video
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
preload
[
audio
and video
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
readonly
[
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. |
referrerpolicy
[
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 |
rel
[
a
;
area
;
link
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
required
[
input
;
select
;
textarea
][WAI-ARIA-1.2] | aria-required |
---|---|
MSAA + IAccessible2 | Use WAI-ARIA mapping |
UIA | Use WAI-ARIA mapping |
ATK | Use WAI-ARIA mapping |
AX | Use WAI-ARIA mapping |
Comments |
If the element includes both the required attribute and the aria-required attribute with a valid value, User Agents MUST expose only the required attribute value.
|
reversed
[
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 |
rows
[
textarea
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
rowspan
[
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 |
sandbox
[
iframe
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
scope
[
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 |
selected
[
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. |
shape
[
area
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
size
[
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.
|
sizes
[
link
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
sizes
[
img
;
source
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
slot
[
HTML elements
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
span
[
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 |
spellcheck
[
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 |
src
[
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 |
srcdoc
[
iframe
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
srclang
[
track
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
srcset
[
img
;
source
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not Mapped |
Comments |
start
[
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 |
step
[
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 |
style
[
HTML elements
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
tabindex
[
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 |
target
[
a
;
area
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
target
[
base
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
target
[
form
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
title
[
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.
|
title
[
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 |
title
[
link
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
title
[
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. |
translate
[
HTML elements
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
type
[
a
;
link
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
type
[
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 |
type
[
embed
;
object
;
script
;
source
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
type
[
input
][WAI-ARIA-1.2] | Refer to WAI-ARIA mappings for input types with defined ARIA roles. |
---|---|
MSAA + IAccessible2 | |
UIA | |
ATK | |
AX | |
Comments |
type
[
ol
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 |
Defines the list item marker, which has no accessible object, but is exposed as content in the accessible text of the associated list item.
Interfaces:
IAccessibleText2
|
UIA |
Defines the list item marker, which has no accessible object, but is exposed as content in the accessible text of the associated list item.
Control Pattern:
Text |
ATK |
Defines the list item marker, which has no accessible object, but is exposed as content in the accessible text of the associated list item.
Interfaces:
ATKText
|
AX |
Defines the list item marker, which is exposed as content in
AXValue , and rendered as an accessible object:
AXRole:
AXListMarker
AXSubrole:
(nil)
AXRoleDescription:
"list marker"
|
Comments |
Some platforms (IAccessible2, ATK, UIA) do not expose an accessible object for the list item marker, whether it was created and then pruned from the accessibility tree, or never created in the first place. Instead, they expose the list item marker as part of the associated list item's accessible text. In these cases, implementors need to consider such things as adjusting the offsets (e.g., for caret-moved events, text-selection events, etc.) for the updated list item text that now also contains the list item marker as content, rather than just taking the offsets unmodified from the list item renderer.
|
usemap
[
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. |
value
[
button
;
option
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
value
[
data
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
value
[
input
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 |
Associates the accessible value for entry type input elements
and accessible name for button type input elements
|
UIA |
Associates the accessible value for entry type input elements
and accessible name for button type input elements
|
ATK |
Associates the accessible value for entry type input elements
and accessible name for button type input elements
|
AX | AXValue: <value> |
Comments |
value
[
li
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 |
Exposed as first text node of
li 's accessible object.
|
UIA |
Expose the value of the
value attribute as the first text node in the list item.
If the value of the value attribute is an integer, set the UIA PositionInSet property to the integer value.
|
ATK |
Exposed as first text node of
li 's accessible object.
|
AX |
Exposed as
AXValue: <value> with accessible object:
AXRole:
AXListMarker
AXSubrole:
(nil)
AXRoleDescription:
list marker
|
Comments |
value
[
meter
;
progress
][WAI-ARIA-1.2] | aria-valuenow |
---|---|
MSAA + IAccessible2 |
Exposed as
IAccessibleValue::currentValue
|
UIA |
Exposed as
Value.Value
|
ATK |
Exposed as
atk_value_get_current_value
|
AX |
AXValue: <value>
|
Comments |
width
[
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 |
wrap
[
textarea
][WAI-ARIA-1.2] | Not mapped |
---|---|
MSAA + IAccessible2 | Not mapped |
UIA | Not mapped |
ATK | Not mapped |
AX | Not mapped |
Comments |
The terms accessible name and accessible description are properties provided in all accessibility APIs. The name of the properties may differ across APIs but they serve the same function: as a container for a short (name) or longer (description) string of text.
The text alternative computation is used to generate both the accessible name and accessible description. There are different rules provided for several different types of elements, nodes, and combinations of markup.
input type="text"
, input type="password"
, input type="number"
, input type="search"
, input type="tel"
, input type="email"
, input type="url"
and textarea
Element Accessible Name Computationaria-label
or an aria-labelledby
attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings.
label
element or elements accessible name(s) - if more than one label
is associated; concatenate by DOM order, delimited by spaces.
title
attribute.aria-label
or an aria-labelledby
attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings.
label
element(s) accessible name(s) - if more than one label
is associated; concatenate by DOM order, delimited by spaces.
alt
attribute.title
attribute.fieldset
element has an aria-label
or an aria-labelledby
attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings.
fieldset
element has a child that is a legend
element, then use the subtree of the first such element.
fieldset
element has a title
attribute, then use that attribute.
output
element has an aria-label
or an aria-labelledby
attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings.
label
element or elements accessible name(s) - if more than one label
is associated; concatenate by DOM order, delimited by spaces.title
attribute.aria-label
or an aria-labelledby
attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings.
label
element.title
attribute.summary
element, which is a direct child of the details
element, has an aria-label
or an aria-labelledby
attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings.
summary
element subtree.title
attribute.summary
element as a direct child of the details
element, the user agent should provide one with a subtree containing a localized string of the word "details".
summary
element as a direct child of the details
element, but none of the above yield a usable text string, there is no accessible name.
figure
element has an aria-label
or an aria-labelledby
attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings.
figure
element has a child that is a figcaption
element, then use the subtree of the first such element.
figure
element has a title
attribute, then use that attribute.
img
element has an aria-label
or an aria-labelledby
attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings.
alt
attribute, even if its value is the empty string.
img
with an alt
attribute whose value is the empty string is mapped to the
presentation
role. It has no accessible name.
alt
attribute use the title
attribute.table
element has an aria-label
or an aria-labelledby
attribute the accessible name is to be calculated using the algorithm defi