HTML Accessibility API Mappings (HTML-AAM) defines how user agents map HTML 5.1 [[!HTML51]] elements and attributes to platform accessibility application programming interfaces (APIs). It leverages and extends the Core Accessibility API Mappings 1.1 [[!CORE-AAM]] and the Accessible Name and Description: Computation and API Mappings 1.1 [[!ACCNAME-AAM]] for use with the HTML 5.1 host language. Documenting these mappings promotes interoperable exposure of roles, states, properties, and events implemented by accessibility APIs and helps to ensure that this information appears in a manner consistent with author intent.

The HTML-AAM is part of the WAI-ARIA suite described in the WAI-ARIA Overview.

This document is subject to change without notice.

You can file a bug on this specification

This document was 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.

Introduction

Like the Core Accessibility API Mappings specification, this document defines how HTML user agents must respond to keyboard focus, as well as role, state and property information provided for Web content. Where an HTML element or attribute has default Accessible Rich Internet Applications (WAI-ARIA) 1.1 [[!WAI-ARIA]] semantics, it must be exposed to the platform accessibility APIs according to the relevant WAI-ARIA mappings defined in the Core Accessibility API Mappings specification. Where an HTML element or attribute does not have 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 and API Mappings [[!ACCNAME-AAM]] for deriving the accessible names and accessible descriptions of HTML 5.1 [[!HTML51]] elements, and provides accessible implementation examples for specific HTML 5.1 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

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 [[!CORE-AAM]].

These RFC2119 key words are formatted in uppercase and contained in a strong element with class="rfc2119". When these key words are used, but do not share this format, they do not convey any formal conformance requirements in the RFC2119 sense, and are merely explanatory, i.e., informative. As much as possible, such usage is avoided in this specification.

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.

Important Terms

Mapping HTML to Accessibility APIs

General Rules for Exposing WAI-ARIA Semantics

WAI-ARIA support was first introduced to HTML in HTML5 [[!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 [[!CORE-AAM]].

Conflicts Between Native Markup Semantics and WAI-ARIA

Where the host language is HTML 5.1 [[!HTML51]], user agents MUST conform to Conflicts between native markup semantics and WAI-ARIA in the Core Accessibility API Mappings [[!CORE-AAM]].

Exposing HTML Features That Do Not Directly Map to Accessibility APIs

HTML may have 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 Accessibility API Mappings [[!CORE-AAM]].

Other Accessibility Implementations

Use of MSAA VARIANT by Some User Agents

In MSAA, the value of an accessible object's Role property is retrieved with the IAccessible::get_accRole method. This method returns a VARIANT that is limited to a finite number of integer role constants insufficient for describing the role of every HTML element, especially new elements introduced by HTML5. To address this limitation, some user agents, e.g., Firefox and Chrome in cooperation with some screen readers, have elected to expose certain roles by returning a string value (BSTR) in that VARIANT in a way that is not described by the MSAA specification.

For example, Firefox returns the element's tag name as a BSTR for the following: abbr, address, aside, blockquote, canvas, caption, dd, div, figcaption, footer, form, h1h6, header, iframe, input type="file", main, menu, nav, output, p, pre, q, section, time.

Similarly, Chrome returns the element's tag name for: blockquote, div, dl, figcaption, form, h1-h6, menu, meter, p, pre.

Use of the DOM by Some Assistive Technologies

to do

HTML Element Role Mappings

Notes:

  • HTML elements with default WAI-ARIA role semantics must be mapped to platform accessibility APIs according to those WAI-ARIA roles' mappings as defined in the Core Accessibility API Mappings [[!CORE-AAM]] specification.
  • A '?' in a cell indicates the data has yet to be provided.
  • "Not mapped" (Not Applicable) means the element does not need to be exposed via an accessibility API. This is usually because the element is not displayed as part of the user interface.
  • User agents should return a user-presentable, localized string value for the Mac Accessibility AXRoleDescription.
  • All elements having an accessible object in IAccessible2 mapping are supposed to implement IAccessible, IAccessible2 and IAccessible2_2 interfaces.
Mappings of HTML elements to platform accessibility APIs: ARIA, MSAA + UIA Express, MSAA + IAccessible2, UIA, ATK, and AX
Element WAI-ARIA MSAA + UIA Express MSAA + IAccessible2 UIA ATK AX
a (represents a hyperlink) link role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
a (represents a hyperlink and parent is a menu) menuitem role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
a (no href attribute) No corresponding role
Role: ROLE_SYSTEM_TEXT
Use MSAA or UIA guidance
Role: IA2_ROLE_TEXT_FRAME
Interfaces: IAccessibleHyperlink; IAccessibleText2; IAccessibleHypertext2;
Control Type: Text
Role: ATK_ROLE_STATIC
Interfaces: AtkText; AtkHypertext
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
abbr No corresponding role
Role: ROLE_SYSTEM_TEXT
Use MSAA or UIA guidance
Role: IA2_ROLE_TEXT_FRAME
Object attributes: "abbr" attribute on the containing td if a single child, text content used as a value
Interfaces: IAccessibleText2; IAccessibleHypertext2;
Control Type: Text
Role: ATK_ROLE_STATIC
Object attributes: "abbr" attribute on the containing td if a single child, text content used as a value
Interfaces: AtkText; AtkHypertext
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
address No corresponding role
Role: ROLE_SYSTEM_TEXT
Use MSAA or UIA guidance
Role: IA2_ROLE_TEXT_FRAME
Interfaces: IAccessibleText2; IAccessibleHypertext2;
Control Type: Text
Role: ATK_ROLE_SECTION
Interfaces: AtkText; AtkHypertext
AXRole: AXGroup
AXSubrole: AXLandmarkContentInfo
AXRoleDescription: "content information"
Note: recommend AXRoleDescription of "address" to disambiguate from "contentinfo" landmark role. Refer to WebKit bug 83989
area (represents a hyperlink) link role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
area (no href attribute) No corresponding role
Role: ROLE_SYSTEM_TEXT
Use MSAA or UIA guidance
Role: IA2_ROLE_SHAPE
Control Type: Text
Role: ATK_ROLE_STATIC
Not mapped
article article role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
aside complementary role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Control Type: Group
Localized Control Type: "aside" (all lower-case)
Landmark Type: Custom
Localized Landmark Type: "complementary" (all lower-case)
Use WAI-ARIA mapping
Use WAI-ARIA mapping
audio No corresponding role
Role: ROLE_SYSTEM_GROUPING
Role: ROLE_SYSTEM_GROUPING
Control Type: Group
Localized Control Type: "audio"
If the controls attribute is present, each control is a child in the UIA tree, and mapped as button, slider, etc. as appropriate for the type of control.
Role: ATK_ROLE_AUDIO
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
Note: UI controls within the audio element exposed as AXToolbar.
b No corresponding role
No accessible object. Exposed by UIA_FontWeightAttributeId of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Exposed as "font-weight" text attribute on the text container. The value depends on the platform.
No accessible object. Exposed by UIA_FontWeightAttributeId of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Exposed as "font-weight" text attribute on the text container. The value depends on the platform.
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
base No corresponding role
Not mapped
Not mapped
Not mapped
Not mapped
Not mapped
bdi No corresponding role ?
No accessible object. May affect on "writing-mode" text attribute on its text container.
?
No accessible object. May affect on "writing-mode" text attribute on its text container.
bdo No corresponding role
Role: ROLE_SYSTEM_TEXT
Use MSAA or UIA guidance
No accessible object. Exposed as "writing-mode" text attribute on its text container.
Control Type: Text
No accessible object. Exposed as "writing-mode" text attribute on its text container.
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
blockquote No corresponding role
Role: ROLE_SYSTEM_GROUPING
Use MSAA or UIA guidance
Role: IA2_ROLE_SECTION
Interfaces: IAccessibleText2; IAccessibleHypertext2;
Control Type: Group
Localized Control Type: "blockquote"
Role: ATK_ROLE_BLOCK_QUOTE
Interfaces: AtkText; AtkHypertext
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
body document role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
br No corresponding role
Role: ROLE_SYSTEM_WHITESPACE
Role: ROLE_SYSTEM_WHITESPACE
Not mapped
No accessible object. Exposed as '\n' character via AtkText interface on the text container.
Not mapped
button button role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
canvas No corresponding role
Role: ROLE_SYSTEM_GRAPHIC
Use MSAA or UIA guidance
Role: IA2_ROLE_CANVAS
Control Type: Image
NOTE: subdom elements will be mapped separately.
Role: ATK_ROLE_CANVAS
AXRole: AXImage
AXSubrole: (nil)
AXRoleDescription: "image"
caption No corresponding role
Role: ROLE_SYSTEM_TEXT
States: STATE_SYSTEM_READONLY
Use MSAA or UIA guidance
Role: IA2_ROLE_CAPTION
Relations: IA2_RELATION_LABEL_FOR with parent table
Interfaces: IAccessibleText2; IAccessibleHypertext2;
Control Type: Text
Properties: UIA_LabeledByPropertyId on the parent table pointing to the UIA element for the caption element
Role: ATK_ROLE_CAPTION
Relations: ATK_RELATION_LABEL_FOR with parent table
Interfaces: AtkText; AtkHypertext
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
cite No corresponding role
No accessible object. Styles used are exposed by UIA text attribute identifiers of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Styles used are mapped into text attributes on its text container.
No accessible object. Styles used are exposed by UIA text attribute identifiers of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Styles used are mapped into text attributes on its text container.
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
code No corresponding role
No accessible object. Styles used are exposed by UIA text attribute identifiers of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Styles used are mapped into text attributes on its text container.
No accessible object. Styles used are exposed by UIA text attribute identifiers of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Styles used are mapped into text attributes on its text container.
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
col No corresponding role
Not mapped
Not mapped
Not mapped
Not mapped
Not mapped
colgroup No corresponding role
Role: ROLE_SYSTEM_GROUPING
TODO:  look in more detail at UIA table implemenation
Not mapped
?TODO:  look in more detail at UIA table implementation
Not mapped
Not mapped
Command: an element that defines a command, whose Type facet is "checkbox", and that is a descendant of a menu element whose type attribute is in the toolbar state menuitemcheckbox role, with the aria-checked state set to "true" if the command's Checked State facet is true, and "false" otherwise
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Command: an element that defines a command, whose Type facet is "command", and that is a descendant of a menu element whose type attribute is in the toolbar state menuitem role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Command: an element that defines a command, whose Type facet is "radio", and that is a descendant of a menu element whose type attribute is in the toolbar state menuitemradio role, with the aria-checked state set to "true" if the command's Checked State facet is true, and "false" otherwise
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
data
Not mapped
Not mapped
Not mapped
Not mapped
Not mapped
datalist listbox role, with the aria-multiselectable property set to "false"
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
dd definition role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
del No corresponding role
No accessible object. Styles used are exposed by UIA text attribute identifiers of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Styles used are mapped into text attributes on its text container.
No accessible object. Styles used are exposed by UIA text attribute identifiers of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Styles used are mapped into text attributes on its text container.
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
details None
Role: ROLE_SYSTEM_GROUPING
Role: ROLE_SYSTEM_GROUPING
Control Type: Group ??window??
Role: ATK_ROLE_PANEL
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
dfn No corresponding role
No accessible object. Styles used are exposed by UIA text attribute identifiers of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Styles used are exposed by text attributes on its text container.
Control Type: Group
Localized Control Type: "definition"
Styles used are exposed by UIA text attribute identifiers of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Styles used are exposed by text attributes on its text container.
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
dialog dialog role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
div No corresponding role
Role: ROLE_SYSTEM_GROUPING
May not have an accessible object if has no semantic meaning. Otherwise
Role: IA2_ROLE_SECTION
Interfaces: IAccessibleText2; IAccessibleHypertext2;
Control Type: Group
May not have an accessible object if has no semantic meaning. Otherwise
Role: ATK_ROLE_SECTION
Interfaces: AtkText; AtkHypertext
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
dl No corresponding role
Role: ROLE_SYSTEM_LIST
States: STATE_SYSTEM_READONLY
Use MSAA or UIA guidance
Role: ROLE_SYSTEM_LIST
States: STATE_SYSTEM_READONLY
Control Type: List
Role: ATK_ROLE_DESCRIPTION_LIST
AXRole: AXList
AXSubrole: AXDefinitionList
AXRoleDescription: "definition list"
dt No corresponding role
Role: ROLE_SYSTEM_LISTITEM
States: STATE_SYSTEM_READONLY
Role: ROLE_SYSTEM_LISTITEM
States: STATE_SYSTEM_READONLY
Interfaces: IAccessibleText2; IAccessibleHypertext2;
Control Type: ListItem
Role: ATK_ROLE_DESCRIPTION_TERM
Interfaces: AtkText; AtkHypertext
AXRole: AXGroup
AXSubrole: AXTerm
AXRoleDescription: "term"
em No corresponding role
No accessible object. Styles used are exposed by UIA text attribute identifiers of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Styles used are mapped into text attributes on its text container
No accessible object. Styles used are exposed by UIA text attribute identifiers of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Styles used are mapped into text attributes on its text container
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
embed No corresponding role
Role: ROLE_SYSTEM_CLIENT
Role: IA2_ROLE_EMBEDDED_OBJECT
States: STATE_SYSTEM_UNAVAILABLE for windowless plugin
Control Type: ?Pane? Window?
Role: ATK_ROLE_EMBEDDED
Depends on format of data file
fieldset No corresponding role
Role: ROLE_SYSTEM_GROUPING
Use MSAA or UIA guidance
Role: ROLE_SYSTEM_GROUPING
Relations: IA2_RELATION_LABELLED_BY with child legend element
Control Type: Group
Role: ATK_ROLE_PANEL
Relations: ATK_RELATION_LABELLED_BY with child legend element
AXRole: AXGroup
AXSubrole: AXFieldset
AXRoleDescription: "group"
AXDescription: value from child legend subtree
figcaption No corresponding role
Role: ROLE_SYSTEM_TEXT
Use MSAA or UIA guidance
Role: IA2_ROLE_CAPTION
Relations: IA2_RELATION_LABEL_FOR with parent figure element
Interfaces: IAccessibleText2; IAccessibleHypertext2;
Control Type: Text
Role: ATK_ROLE_CAPTION
Relations: ATK_RELATION_LABEL_FOR with parent figure element
Interfaces: AtkText; AtkHypertext
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
figure No corresponding role
Role: ROLE_SYSTEM_GROUPING
Use MSAA or UIA guidance
Role: ROLE_SYSTEM_GROUPING
Object attributes: xml-roles:figure
Name: related figcaption content
Relations: IA2_RELATION_LABELLED_BY with child figcaption element
Control Type: Group
Localized Control Type: Figure
Role: ATK_ROLE_PANEL
Object attributes: xml-roles:figure
Name: related figcaption content
Relations: ATK_RELATION_LABELLED_BY with child figcaption element
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "figure"
form form role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
h1, h2, h3, h4, h5, h6 heading role, with the aria-level property set to the element's outline depth
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
head No corresponding role
Not mapped
Not mapped
Not mapped
Not mapped
Not mapped
header (nearest ancestor sectioning content or sectioning root element is not body) No corresponding role
Role: ROLE_SYSTEM_GROUPING
Role: IA2_ROLE_SECTION
Interfaces: IAccessibleText2; IAccessibleHypertext2;
Control Type: Group
Role: ATK_ROLE_SECTION
Interfaces: AtkText; AtkHypertext
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
header (nearest ancestor sectioning content or sectioning root element is body) banner role
Role: ROLE_SYSTEM_GROUPING
Expose "banner" as text string in AriaRole
Role: IA2_ROLE_HEADER
Object attributes: xml-roles:banner
Interfaces: IAccessibleText2; IAccessibleHypertext2;
Control Type: Group
Localized Control Type: "header"
Landmark Type: Custom
Localized Landmark Type: "banner"
Role: ATK_ROLE_HEADER
Object attributes: xml-roles:banner
Interfaces: AtkText; AtkHypertext
AXRole: AXGroup
AXSubrole: AXLandmarkBanner
AXRoleDescription: "banner"
hr separator role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
html No corresponding role
Not mapped
Not mapped
Not mapped
Not mapped
Not mapped
i No corresponding role
No accessible object. Exposed by UIA_IsItalicAttributeId of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Exposed as "font-style:italic" text attribute on its text container.
No accessible object. Exposed by UIA_IsItalicAttributeId of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Exposed as "font-style:italic" text attribute on its text container.
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
iframe No corresponding role
Role: ROLE_SYSTEM_DOCUMENT ??pane??
States: STATE_SYSTEM_READONLY
Role: IA2_ROLE_INTERNAL_FRAME
Child: ROLE_SYSTEM_DOCUMENT having STATE_SYSTEM_READONLY
Control Type: Pane
Role: ATK_ROLE_INTERNAL_FRAME
Child: ATK_ROLE_DOCUMENT_FRAME
AXRole: AXWebArea
AXSubrole: (nil)
AXRoleDescription: "html content"
img img role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
img (alt attribute is empty) presentation role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
input (type attribute in the Button state) button role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
input (type attribute in the Button state and parent is a menu) menuitem role
Role: ROLE_SYSTEM_MENUITEM
Role: ROLE_SYSTEM_MENUITEM
Control Type: MenuItem
Role: ATK_ROLE_MENU_ITEM
If the option's parent has a group role, then maps to AXMenuButton

If the option's parent has a menu role, then maps to AXMenuItem

AXRole: AXMenuItem
AXSubrole: <nil>
AXRoleDescription: 'menu item'

input (type attribute in the Color state) No corresponding role
Role: If implemented as a textbox, ROLE_SYSTEM_TEXT
Use UIA guidance
Role: IA2_ROLE_COLOR_CHOOSER
Control Type: If implemented as a textbox, Edit.
Properties: If implemented as a color picker, set LocalizedControlType string to "Color Picker".
Control Pattern: If implemented as a color picker, implement IUIAutomationSelectionPattern for the container and IUIAutomationSelectionItemPattern for each color choice
Role: ATK_ROLE_COLOR_CHOOSER
If implemented as a textbox:
AXRole: AXTextField
AXSubrole: (nil)
AXRoleDescription: "textfield"
If implemented as a color picker:
AXRole: AXColorWell
AXSubrole: (nil)
AXRoleDescription: "color chooser"
input (type attribute in the Checkbox state) 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
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
input (type attribute in the Checkbox state and parent is a menu) menuitemcheckbox role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
input (type attribute in the Date state) No corresponding role
Role: ROLE_SYSTEM_DROPLIST
UIA Calendar
Role: IA2_ROLE_DATE_EDITOR
Control Type: Calendar
Role: ATK_ROLE_CALENDAR
AXRole: AXDateField
AXSubrole: (nil)
AXRoleDescription: "date field"
input (type attribute in the Date and Time state) No corresponding role
Role: ROLE_SYSTEM_DROPLIST
UIA Calendar
Role: IA2_ROLE_DATE_EDITOR
Control Type: Calendar
Role: ATK_ROLE_CALENDAR
AXRole: AXTextField
AXSubrole: (nil)
AXRoleDescription: "text field"
input (type attribute in the E-mail state with no suggestions source element) textbox role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
+
Object attributes: text-input-type:email
Control Type: edit
localized control type: email
Use WAI-ARIA mapping
Use WAI-ARIA mapping
input (type attribute in the File Upload state) No corresponding role
Role: ROLE_SYSTEM_PUSHBUTTON
Role: IA2_ROLE_TEXT_FRAME
Children: A button and label (implementation specific)
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"
Role: ATK_ROLE_STATIC
Children: ATK_ROLE_PUSH_BUTTON when pressed ATK_ROLE_FILE_CHOOSER dialog shown
AXRole: AXButton
AXSubrole: AXFileUploadButton
AXRoleDescription: file upload button
input (type attribute in the Hidden state) No corresponding role
Do not expose this object
Not mapped
Do not expose this object
Not mapped
Do not expose this object
input (type attribute in the Image Button state) button role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
input (type attribute in the Image Button state and parent is a menu) menuitem role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
input (type attribute in the Month state) No corresponding role
Role: ROLE_SYSTEM_DROPLIST
UIA Calendar
Role: IA2_ROLE_DATE_EDITOR
Control Type: Calendar
Role: ATK_ROLE_DATE_EDITOR
AXRole: AXTextField
AXSubrole: (nil)
AXRoleDescription: "text field"
input (type attribute in the Number state) spinbutton role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
If implemented as a spin control, use wai-aria mapping.
If implemented as a textbox, use mapping below:
Control Type: Edit
Localized Control Type: number
Use WAI-ARIA mapping
Use WAI-ARIA mapping
input (type attribute in the Password state) No corresponding role
Role: ROLE_SYSTEM_TEXT
States:STATE_SYSTEM_PROTECTED
Use UIA guidance
Role: ROLE_SYSTEM_TEXT
States: STATE_SYSTEM_PROTECTED; IA2_STATE_SINGLE_LINE; STATE_SYSTEM_READONLY if readonly, otherwise IA2_STATE_EDITABLE
Control Type: Edit
Localized Control Type: "password"
IsPassword: true
Role: ATK_ROLE_PASSWORD_TEXT
States: ATK_STATE_SINGLE_LINE; ATK_STATE_READ_ONLY if readonly, otherwise ATK_STATE_EDITABLE
AXRole: AXTextField
AXSubrole: AXSecureTextField
AXRoleDescription: "secure text field"
input (type attribute in the Radio Button state) 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.
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
input (type attribute in the Radio Button state and parent is a menu) menuitemradio role, with the aria-checked state set to "true" if the element's checkedness is true, or "false" otherwise
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
input (type attribute in the Range state) slider role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
input (type attribute in the Reset Button state) button role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
input (type attribute in the Submit Button state) button role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
input (type attribute in the Telephone state with no suggestions source element) textbox role
Use WAI-ARIA mapping
Use WAI-ARIA mapping

+

Object attributes: text-input-type:telephone
Control Type: edit
localized control type: telephone
Use WAI-ARIA mapping
Use WAI-ARIA mapping
input (type attribute in the Text state with no suggestions source element) textbox role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
input (type attribute in the Text, Search, Telephone, URL, or E-mail states with a suggestions source element) combobox role, with the aria-owns property set to the same value as the list attribute
Use WAI-ARIA mapping
Use WAI-ARIA mapping

+

Object attributes: text-input-type:as per input type
Use WAI-ARIA mapping
Relationships: ControllerFor pointing to the suggestions source.
Use WAI-ARIA mapping
Use WAI-ARIA mapping
input (type attribute in the Time state) No corresponding role

Role: ROLE_SYSTEM_SPINBUTTON if implemented as a simple widget.
If implemented as a complex widget use:
Role: ROLE_SYSTEM_GROUPING and map child controls as appropriate

Role: ROLE_SYSTEM_SPINBUTTON if implemented as a simple widget.
If implemented as a complex widget use:
Role: ROLE_SYSTEM_GROUPING and map child controls as appropriate

+

Object attributes: text-input-type:time
Control Type: Spinner

Role: ATK_ROLE_SPINBUTTON if implemented as a simple widget.
If implemented as a complex widget use:
Role: ROLE_PANEL and map child controls as appropriate.

AXRole: AXTimeField
AXSubrole: (nil)
AXRoleDescription: "time field"
input (type attribute in the URL state with no suggestions source element) textbox role
Use WAI-ARIA mapping
Use WAI-ARIA mapping

+

Object attributes: text-input-type:url
Control Type: edit
localized control type: url
Use WAI-ARIA mapping
Use WAI-ARIA mapping
input (type attribute in the Week state) No corresponding role
Role: ROLE_SYSTEM_DROPLIST
UIA Calendar
Role: IA2_ROLE_DATE_EDITOR

+

Object attributes: text-input-type:week
Control Type: Calendar
Role: ATK_ROLE_CALENDAR
AXRole: AXTextField
AXSubrole: (nil)
AXRoleDescription: "text field"
ins No corresponding role
No accessible object. Styles used are exposed by UIA text attribute identifiers of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Styles used are mapped into text attributes on its text container.
No accessible object. Styles used are exposed by UIA text attribute identifiers of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Styles used are mapped into text attributes on its text container.
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
kbd No corresponding role
No accessible object. Styles used are exposed by UIA text attribute identifiers of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Mapped into "font-family:monospace" text attribute on its text container.
No accessible object. Styles used are exposed by UIA text attribute identifiers of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Mapped into "font-family:monospace" text attribute on its text container.
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
keygen listbox role, with the aria-multiselectable property set to "false"
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
label No corresponding role
Role: ROLE_SYSTEM_TEXT
Use UIA guidance
Role: ROLE_SYSTEM_STATICTEXT and IA2_ROLE_LABEL
Relations: IA2_RELATION_LABEL_FOR for a child form element or form element referred by for attribute. Note, related form element provides IA2_RELATION_LABELLED_BY pointing to the label.
Interfaces: IAccessibleText2; IAccessibleHypertext2
Control Type: Text
Properties: ??The parent input has a UIA_LabeledByPropertyId pointing to the UIA element for the legend element.?? When the label element has a for attribute pointing to a valid IDREF, the referenced element has a UIA_LabeledByPropertyId pointing to the UIA element for the label element.
Role: ATK_ROLE_LABEL
Relations: ATK_RELATION_LABEL_FOR for a child form element or form element referred by for attribute. Note, related form element provides ATK_RELATION_LABELLED_BY pointing to the label.
Interfaces: AtkText; AtkHypertext
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
legend No corresponding role
Role: ROLE_SYSTEM_TEXT
SHOULD use UIA_LabeledByPropertyId (see UIA column)
Role : ROLE_SYSTEM_STATICTEXT and IA2_ROLE_LABEL
Relations: IA2_RELATION_LABEL_FOR with parent fieldset element
Interfaces: IAccessibleText2; IAccessibleHypertext2
Control Type: Text
Properties: The parent fieldset has a UIA_LabeledByPropertyId pointing to the UIA element for the legend element.
Role : ATK_ROLE_LABEL
Relations: ATK_RELATION_LABEL_FOR with parent fieldset element
Interfaces: AtkText; AtkHypertext
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
li (parent is an ol or ul) listitem role with aria-setsize value reflecting number of li elements within the parent ol or ul and aria-posinset value reflecting the li elements position within the set.
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
li (parent is a menu) listitem role with aria-setsize value reflecting number of li elements within the parent menu and aria-posinset value reflecting the li elements position within the set.
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
main main role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
map No corresponding role
Not mapped
Not mapped if used as an image map, otherwise:
Role: IA2_ROLE_TEXT_FRAME
Not mapped
Not mapped if used as an image map, otherwise:
Role: ATK_ROLE_STATIC
Not mapped
mark No corresponding role
Role: ROLE_SYSTEM_TEXT
Role: IA2_ROLE_TEXT_FRAME

Object attributes: xml-roles:mark

Styles used are mapped to text attributes on the accessible object.

Interfaces: IAccessibleText2; IAccessibleHypertext2;

Control Type: Text

Role: ATK_ROLE_STATIC

Object attributes: xml-roles:mark

Styles used are mapped to text attributes on the accessible object.

Interfaces: AtkText; AtkHypertext

 

AXRole: AXGroup
AXSubrole: ?
AXRoleDescription: "highlighted content"
math math role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
menu (type attribute in the popup menu state) menu role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
menu (type attribute in the toolbar state) toolbar role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
menuitem (type attribute in the Checkbox state) menuitemcheckbox role, with the aria-checked state set to "true" if the checked attribute is present, and "false" otherwise
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
menuitem (type attribute in the Command state) menuitem role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
menuitem (type attribute in the Radio state) menuitemradio role, with the aria-checked state set to "true" if the checked attribute is present, and "false" otherwise
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
meta No corresponding role
Not mapped
Not mapped
Not mapped
Not mapped
Not mapped
meter No corresponding role
Role: ROLE_SYSTEM_TEXT
?? not sure this is right.  maybe a number or value or something?
Use UIA guidance
Role: ROLE_SYSTEM_PROGRESSBAR
Interfaces: IAccessibleValue
Control Pattern: RangeValue
Properties: Set the control pattern's IsReadOnly property to true. Set LocalizedControlType to "Meter".
Role: ATK_ROLE_LEVEL_BAR
Interfaces: AtkValue
Properties: AtkRange
AXRole: AXProgressIndicator
AXSubrole: (nil)
AXRoleDescription: "Progress Indicator"
nav navigation role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
noscript No corresponding role
Not mapped
Not mapped
Not mapped
Not mapped
Not mapped
object No corresponding role ?? would pane or window work??

depends on format of data file. examples include document, client, graphic and unknown.

Use MSAA or UIA guidance
Depends on format of data file. If contains a plugin then
Role: IA2_ROLE_EMBEDDED_OBJECT
States: STATE_SYSTEM_UNAVAILABLE for windowless plugin
Depends on format of data file.
Depends on format of data file. If contains a plugin then
Role: ATK_ROLE_EMBEDDED
Depends on format of data file.
ol list role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
optgroup group role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
option (in a list of options or represents a suggestion in a datalist) option role, with the aria-selected state set to "true" if the element's selectedness is true, or "false" otherwise.
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
output status role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Control Type: Group
LiveSetting: Polite

If the output element has a for attribute, the element referenced (via the id attribute value) will have a ControllerFor property pointing to the output.

Use WAI-ARIA mapping
Use WAI-ARIA mapping
p No corresponding role
Role: ROLE_SYSTEM_TEXT
Use MSAA or UIA guidance
Role: IA2_ROLE_PARAGRAPH
Interfaces: IAccessibleText2; IAccessibleHypertext2
Control Type: Text
Role: ATK_ROLE_PARAGRAPH
Interfaces: AtkText; AtkHypertext
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
param No corresponding role
Not mapped
Not mapped
Not mapped
Not mapped
Not mapped
picture No corresponding role
Not mapped
Not mapped
Not mapped
Not mapped
Not mapped
pre No corresponding role
Role: ROLE_SYSTEM_TEXT ??group?
Use MSAA or UIA guidance
Role: IA2_ROLE_TEXT_FRAME
Styles used are mapped to text attributes on the accessible object.
Interfaces: IAccessibleText2; IAccessibleHypertext2
Control Type: Text ??Group??
Role: ATK_ROLE_SECTION
Styles used are mapped to text attributes on the accessible object.
Interfaces: AtkText; AtkHypertext
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
progress 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
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
q No corresponding role
Role: ROLE_SYSTEM_TEXT ??group??
Use MSAA or UIA guidance
Role: IA2_ROLE_TEXT_FRAME
Children: ROLE_SYSTEM_TEXT wrapped by ROLE_SYSTEM_STATICTEXT created for quote marks
Interfaces: IAccessibleText2; IAccessibleHypertext2
Control Type: Text ??Group??
Role: ATK_ROLE_STATIC
Interfaces: AtkText; AtkHypertext
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
rp No corresponding role
Role: ROLE_SYSTEM_TEXT ??group??
Use MSAA or UIA guidance
No accessible object. No child elements are exposed if ruby is supported by the browser.
Control Type: Text ??Group??
No accessible object. No child elements are exposed if ruby is supported by the browser.
?
rt No corresponding role
Role: ROLE_SYSTEM_TEXT
Use MSAA or UIA guidance
No accessible object.
Control Type: Text
No accessible object.
?
ruby No corresponding role
Role: ROLE_SYSTEM_TEXT ??group??
Use MSAA or UIA guidance
Role: IA2_ROLE_TEXT_FRAME
Control Type: Text ??Group??
Role: ATK_ROLE_STATIC
?
s No corresponding role
No accessible object. Styles used are exposed by UIA text attribute identifiers of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Exposed as "text-line-through-style:solid" text attribute on the text container.
No accessible object. Styles used are exposed by UIA text attribute identifiers of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Exposed as "text-line-through-style:solid" text attribute on the text container.
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
samp No corresponding role
No accessible object. Styles used are exposed by UIA text attribute identifiers of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Styles are mapped into text attributes on its text container.
No accessible object. Styles used are exposed by UIA text attribute identifiers of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Styles are mapped into text attributes on its text container.
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
script No corresponding role
Not mapped
Not mapped
Not mapped
Not mapped
Not mapped
section

region role

Note:It is strongly recommended that user agents such as screen readers only convey the presence of, and provide navigation for section elements, when the section element has an accessible name.

Use WAI-ARIA mapping
Use WAI-ARIA mapping
Control Type: Group
Localized Control Type: "section" (all lower-case)
Landmark Type: Custom
Localized Landmark Type: "region" (all lower-case)
Use WAI-ARIA mapping
Use WAI-ARIA mapping
select (with a multiple attribute or size attribute having value greater than 1) listbox role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
select (with NO multiple attribute and NO size attribute having value greater than 1) combobox role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
small No corresponding role
No accessible object. Exposed by UIA_FontSizeAttributeId of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Exposed as "font-size" text attribute on the text container.
No accessible object. Exposed by UIA_FontSizeAttributeId of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Exposed as "font-size" text attribute on the text container.
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
source No corresponding role
Do not expose this object
Not mapped
Do not expose this object
Not mapped
Do not expose this object
span No corresponding role
Role: ROLE_SYSTEM_GROUPING
Use MSAA or UIA guidance
Not mapped
Control Type: Group
Not mapped
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
strong No corresponding role
No accessible object. Styles used are exposed by UIA text attribute identifiers of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Styles used are mapped into text attributes on its text container.
No accessible object. Styles used are exposed by UIA text attribute identifiers of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Styles used are mapped into text attributes on its text container.
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
style No corresponding role
Do not expose this object
Not mapped
Do not expose this object
Not mapped
Do not expose this object
sub No corresponding role
No accessible object. Exposed by UIA_IsSubscriptAttributeId of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Exposed as "text-position:sub" text attribute on its text container.
No accessible object. Exposed by UIA_IsSubscriptAttributeId of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Exposed as "text-position:sub" text attribute on its text container.
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
summary No corresponding role
Role: ROLE_SYSTEM_PUSHBUTTON
States: ??has popup??
Use MSAA or UIA guidance
Role: ROLE_SYSTEM_PUSHBUTTON
Control Type: Button
Control Pattern: ExpandCollapse
Role: ATK_ROLE_PUSHBUTTON
AXRole: AXDisclosureTriangle
AXSubrole: (nil)
AXRoleDescription: "disclosure triangle"
sup No corresponding role
No accessible object. Exposed by UIA_IsSuperscriptAttributeId of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Exposed as "text-position:super" text attribute on its text container.
No accessible object. Exposed by UIA_IsSuperscriptAttributeId of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Exposed as "text-position:super" text attribute on its text container.
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
svg No corresponding role
Role: ROLE_SYSTEM_GRAPHIC
Role: ROLE_SYSTEM_GRAPHIC
Control Type: Image
Role: ATK_ROLE_IMAGE
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
table table role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
tbody rowgroup role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
td (ancestor table element has table role) cell role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
td (ancestor table element has grid role) gridcell role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
template No corresponding role
Not mapped
Not mapped
Not mapped
Not mapped
Not mapped
textarea textbox role, with the aria-multiline property set to "true"
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
tfoot rowgroup role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
th (is neither column header nor row header, and ancestor table element has table role) cell role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
th (is neither column header nor row header, and ancestor table element has grid role) gridcell role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
th (is a column header) columnheader role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
th (is a row header) rowheader role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
thead rowgroup role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Control Type: Header
Use WAI-ARIA mapping
Use WAI-ARIA mapping
time No corresponding role
Role: ROLE_SYSTEM_TEXT
Role: IA2_ROLE_TEXT_FRAME

Object attributes: xml-roles:time

"datetime" attribute on the containing time, text content used as a value

Interfaces: IAccessibleText2; IAccessibleHypertext2;

?

Role: ATK_ROLE_STATIC

Object attributes: xml-roles:time

"datetime" attribute on the containing time, text content used as a value

Interfaces: AtkText; AtkHypertext

 

AXRole: AXGroup
AXSubrole: ?
AXRoleDescription: ?
title No corresponding role
Not mapped
Not mapped
Not mapped
Not mapped
Not mapped
tr row role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
track No corresponding role
Not mapped
Not mapped
Not mapped
Not mapped
Not mapped
u No corresponding role
No accessible object. Exposed by UIA_UnderlineStyleAttributeId of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Exposed as "text-underline-style:solid" text attribute on its text container.
No accessible object. Exposed by UIA_UnderlineStyleAttributeId of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Exposed as "text-underline-style:solid" text attribute on its text container.
?
ul list role
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
var No corresponding role
No accessible object. Styles used are exposed by UIA text attribute identifiers of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Styles used are mapped to text attributes on its text container.
No accessible object. Styles used are exposed by UIA text attribute identifiers of the TextRange control pattern implemented on a parent accessible object.
No accessible object. Styles used are mapped to text attributes on its text container.
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
video No corresponding role
Role: ROLE_SYSTEM_GROUPING
Role: ROLE_SYSTEM_GROUPING
Control Type: Group
Role: ATK_ROLE_VIDEO
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"
Note: UI controls within the video element exposed as AXToolbar.
wbr No corresponding role
Not mapped
A line break if added is exposed via IAccessibleText on its text container
Not mapped
A line break if added is exposed via Text interface on its text container
AXRole: AXGroup
AXSubrole: (nil)
AXRoleDescription: "group"

HTML Attribute State and Property Mappings

Notes:

Mappings of HTML attributes (excluding event handler content attributes) to platform accessibility APIs: ARIA, MSAA + UIA Express, MSAA + IAccessible2, UIA, ATK, and AX
Attribute Element(s) WAI-ARIA MSAA + UIA Express MSAA + IAccessible2 UIA ATK AX Comments
abbr th Not mapped  
Object attributes: "abbr" until child abbr element is provided
 
Object attributes: "abbr" until child abbr element is provided
   
accept input Not mapped  
Not mapped
 
Not mapped
   
accept-charset form Not mapped  
Not mapped
 
Not mapped
   
accesskey HTML elements Not mapped accKeyboardShortcut
a key binding accessible by accKeyboardShortcut and IAccessibleAction::keyBinding
Properties: AcceleratorKey
atk_action_get_keybinding
AXAccessKey: <value>  
action form Not mapped  
Not mapped
 
Not mapped
   
allowfullscreen iframe  
Not mapped
 
Not mapped
   
alt area; img; input Not mapped accName Used for accessible name, exposed via accName
Properties: Name
Used for accessible name, exposed via atk_object_get_name
AXDescription: <value>  
async script Not mapped  
Not mapped
 
Not mapped
   
autocomplete "on|off" form

aria-autocomplete

Note: the ARIA attribute and the HTML attribute have disparate features.

Not mapped
States: STATE_SUPPORTS_AUTOCOMPLETION on text form controls unitl the value is overriden by control
Not mapped
States: ATK_STATE_SUPPORTS_AUTOCOMPLETION on text form controls unitl the value is overriden by control
Not mapped If the element includes both autocomplete and aria-autocomplete attributes with valid values, User Agents MUST expose only the autocomplete attribute value.
autocomplete input; select; textarea

aria-autocomplete

Note: the ARIA attribute and the HTML attribute have disparate features.

Not mapped
States: STATE_SUPPORTS_AUTOCOMPLETION
Not mapped
States: ATK_STATE_SUPPORTS_AUTOCOMPLETION
Not mapped  If the element includes both autocomplete and aria-autocomplete attributes with valid values, User Agents MUST expose only the autocomplete attribute value.
autofocus button; input; keygen; select; textarea Not mapped - aria-flowto? N/A
Not mapped
N/A
Not mapped
N/A  
autoplay audio; video Not mapped N/A
Not mapped
N/A
Not mapped
N/A  
border table Not mapped  
Not mapped
 
Not mapped
   
challenge keygen Not mapped  
Not mapped
 
Not mapped
   
charset meta Not mapped  
Not mapped
 
Not mapped
   
charset script Not mapped  
Not mapped
 
Not mapped
   
checked (if present) menuitem; input aria-checked (state)="true" Set the STATE_SYSTEM_CHECKED state
States: STATE_SYSTEM_CHECKED
Expose as ToggleState property in Toggle control pattern
States: ATK_STATE_CHECKED
AXValue: 1  
checked (if absent) menuitem; input aria-checked (state)="false" Clear the STATE_SYSTEM_CHECKED state
Not mapped
Expose as ToggleState property in Toggle control pattern.
Not mapped
AXValue: 0  
cite blockquote; del; ins; q    
Not mapped
 
Not mapped
AXURL: <value>  
class HTML elements Not mapped  
Not mapped
 
Not mapped
   
cols textarea    
Not mapped
 
Not mapped
AXRangeForLine: <value>  
colspan td; th    
exposed via IAccessibleTableCell::columnExtent
 
exposed via atk_table_get_column_extent_at
AXColumnIndexRange:
loc=<column index>
len=<colspan value>
 
command menuitem Not mapped  
Not mapped
 
Not mapped
   
content meta Not mapped  
Not mapped
 
Not mapped
   
contenteditable HTML elements    
States: IA2_STATE_EDITABLE on this and every nested text accessible object
Interfaces: IAccessibleEditableText on this and every nested text accessible object
 
States: ATK_STATE_EDITABLE on this and every nested text accessible object
Interfaces: AtkEditableText on this and every nested text accessible object
?  
contextmenu HTML elements aria-haspopup="true" Expose as STATE_SYSTEM_HASPOPUP. If on a push button, change the role to ROLE_SYSTEM_BUTTONMENU.
Linked menu is available in browser's context menu on the element
Expose state of the pop-up activities in the ExpandCollapseState property in the ExpandCollapse control pattern.
Linked menu is available in browser's context menu on the element
Actions: AXShowMenu; AXPress
 
controls audio; video    
Not mapped
 
Not mapped
Controls exposed as AXToolbar  
coords area Not mapped  
Defines an accessible object's dimensions (IAccessible::accLocation)
 
Defines an accessible object's dimensions, exposed via atk_component_get_position and atk_component_get_size
   
crossorigin audio; img; link; script; video Not mapped  
Not mapped
 
Not mapped
   
data object Not mapped  
Not mapped
 
Not mapped
   
datetime del; ins    
Object attributes: datetime: text content used as a value
 
Object attributes: datetime: text content used as a value
?  
datetime time    
Object attributes: datetime: text content used as a value
 
Object attributes: datetime: text content used as a value
?  
default track Not mapped  
Not mapped
 
Not mapped
   
defer script Not mapped  
Not mapped
 
Not mapped
   
dir HTML elements    
Exposed as "writing-mode" text attribute on the text container.
 
Exposed as "writing-mode" text attribute on the text container.
?  
dirname input; textarea    
Not mapped
 
Not mapped
?  
disabled button; menuitem; fieldset; input; keygen; optgroup; option; select; textarea    
States: STATE_SYSTEM_UNAVAILABLE
 
States: No interactive states like ATK_STATE_FOCUSABLE
AXEnabled: NO  
download a; area    
Not mapped
 
Not mapped
?  
draggable HTML elements    
Object attributes: draggable:true
 
Object attributes: draggable:true
?  
dropzone HTML elements    
Not mapped
 
Not mapped
?  
enctype form Not mapped  
Not mapped
 
Not mapped
   
for label Not mapped  
Used for accessible name
Relations: IA2_RELATION_LABEL_FOR and IA2_RELATION_LABEL_BY relations between label and referred element
 
Used for accessible name
Relations: ATK_RELATION_LABEL_FOR and ATK_RELATION_LABEL_BY relations between label and referred element
   
for output Not mapped  
Relations: IA2_RELATION_CONTROLLED_BY with an element pointed by the attribute. Paired element exposes IA2_RELATION_CONTROLLER_FOR relation.
 
Relations: ATK_RELATION_CONTROLLED_BY with an element pointed by the attribute. Paired element exposes ATK_RELATION_CONTROLLER_FOR relation.
   
form button; fieldset; input; keygen; label; object; output; select; textarea Not mapped  
Not mapped
 
Not mapped
   
formaction button; input Not mapped  
Not mapped
 
Not mapped
   
formenctype button; input Not mapped  
Not mapped
 
Not mapped
   
formmethod button; input Not mapped  
Not mapped
 
Not mapped
   
formnovalidate button; input Not mapped  
Not mapped
 
Not mapped
   
formtarget button; input Not mapped  
Not mapped
 
Not mapped
   
headers td; th    
Links the cell to its header cells. Exposed via IAccessibleTableCell::rowHeaderCells and IAccessibleTableCell::columnHeaderCells.
 
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.
Expose via AXColumnHeaderUIElements and AXRowHeaderUIElements  
height canvas; embed; iframe; img; input; object; video Not mapped  
Defines an accessible object's height (IAccessible::accLocation)
 
Defines an accessible object's height (atk_component_get_size)
   
hidden HTML elements    
Excludes the element from being exposed in the accessibility tree.
 
Excludes the element from being exposed in the accessibility tree.
Not exposed in AX API  
high meter    
Not mapped
 
Not mapped
?  
href a; area    
Creates a link accessible object. For details, refer to a and area element mappings.
 
Creates a link accessible object. For details, refer to a and area element mappings.
AXURL: <value>  
hreflang a; area; link    
Not mapped
 
Not mapped
   
http-equiv meta Not mapped  
Not mapped
 
Not mapped
   
icon menuitem Not mapped  
Not mapped
 
Not mapped
   
id HTML elements Not mapped  
Not mapped
 
Not mapped
   
indeterminate [IDL] HTML elements; menuitem; input aria-checked (state)="mixed"
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
 
ismap img Not mapped  
Not mapped
 
Not mapped
   
keytype keygen Not mapped  
Not mapped
 
Not mapped
   
kind track    
Not mapped
 
Not mapped
   
label menuitem; menu; optgroup; option; track    
Associates the accessible name
 
Associates the accessible name
   
lang HTML elements   Unknown
Exposed as "language" text attribute on the text container
Unknown
Exposed as "language" text attribute on the text container
 AXLanguage: <value>

chrome OSX lang bug

IE lang bug

list input Not mapped  
Associates the autocomplete list with the control. Refer to input elements mapping.
 
Associates the autocomplete list with the control. Refer to input elements mapping.
   
longdesc img, frame, iframe No accdescription (Internet Explorer only)
Actions: showlongdesc (exposed on img only)
Not mapped
Actions: showlongdesc (exposed on img only)
Not mapped
IE 8+ populates the accdescription with the value of the longdesc attribute. This is brittle as it is overwritten when aria-describedby is used.
loop audio; video Not mapped  
Not mapped
 
Not mapped
   
low meter    
Not mapped
 
Not mapped
   
manifest html Not mapped  
Not mapped
 
Not mapped
   
max input    
Exposed as IAccessibleValue::maximumValue if the element implements the interface
 
Exposed as atk_value_get_maximum_value if the element implements the AtkValue interface
AXMaxValue: <value>  
max meter; progress    
Exposed as IAccessibleValue::maximumValue if the element implements the interface
 
Exposed as atk_value_get_maximum_value if the element implements the AtkValue interface
AXMaxValue: <value>  
maxlength input; textarea    
Not mapped
 
Not mapped
   
media link; source; style    
Not mapped
 
Not mapped
   
mediagroup audio; video Not mapped  
Not mapped
 
Not mapped
   
method form Not mapped  
Not mapped
 
Not mapped
   
min input    
Exposed as IAccessibleValue::minimumValue if the element implements the interface
 
Exposed as atk_value_get_minimum_value if the element implements the AtkValue interface
AXMinValue: <value>  
min meter    
Exposed as IAccessibleValue::minimumValue if the element implements the interface
 
Exposed as atk_value_get_minimum_value if the element implements the AtkValue interface
AXMinValue: <value>  
multiple input aria-multiselectable property set to "true"  
Not mapped
 
Not mapped
   
multiple select    
States: STATE_SYSTEM_MULTISELECTABLE
A multi selectable listbox accessible object, refer to select element
 
States: ATK_STATE_SYSTEM_MULTISELECTABLE
A multi selectable listbox accessible object, refer to select element
   
muted audio; video Not mapped  
Not mapped
 
Not mapped
   
name button; fieldset; input; keygen; output; select; textarea Not mapped  
Not mapped
 
Not mapped
   
name form Not mapped  
Not mapped
 
Not mapped
   
name iframe; object Not mapped  
Not mapped
 
Not mapped
   
name map Not mapped  
Not mapped
 
Not mapped
   
name meta Not mapped  
Not mapped
 
Not mapped
   
name param Not mapped  
Not mapped
 
Not mapped
   
novalidate form Not mapped  
Not mapped
 
Not mapped
   
open details aria-expanded="true | false" STATE_SYSTEM_EXPANDED
STATE_SYSTEM_COLLAPSED
STATE_SYSTEM_EXPANDED
STATE_SYSTEM_COLLAPSED
ExpandCollapsePattern
States: ATK_STATE_COLLAPSED or ATK_STATE_EXPANDED depending on the attribute value
AXExpanded: YES|NO Set properties on the summary element.
open dialog aria-expanded="true | false" STATE_SYSTEM_EXPANDED
STATE_SYSTEM_COLLAPSED
STATE_SYSTEM_EXPANDED
STATE_SYSTEM_COLLAPSED
ExpandCollapsePattern
States: ATK_STATE_COLLAPSED or ATK_STATE_EXPANDED depending on the attribute value
AXExpanded: YES|NO
optimum meter    
Not mapped
 
Not mapped
   
pattern input    
States: IA2_STATE_INVALID_ENTRY if value doesn't meet the pattern
 
States: ATK_STATE_INVALID_ENTRY if value doesn't meet the pattern
   
placeholder input; textarea aria-placeholder
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
Use WAI-ARIA mapping
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.
poster video    
Not mapped
 
Not mapped
   
preload audio; video    
Not mapped
 
Not mapped
   
radiogroup menuitem    
Not mapped
 
Not mapped
   
readonly input; textarea   STATE_SYSTEM_READONLY
Adds STATE_SYSTEM_READONLY bit to input and textarea elements
 
Removes ATK_STATE_EDITABLE bit bit from input and textarea elements
AXEnabled: NO  
rel a; area; link    
Not mapped
 
Not mapped
   
required input; select; textarea aria-required

Not mapped *

* Exposed as STATE_SYSTEM_ALERT_LOW, STATE_SYSTEM_ALERT_HIGH in Firefox.

States: IA2_STATE_REQUIRED
Expose as IsrequiredForForm property.
States: ATK_STATE_REQUIRED
AXRequired: YES ?
reversed ol    
Reverses the numbering of the child list item accessible objects.
 
Reverses the numbering of the child list item accessible objects.
   
rows textarea    
Not mapped
 
Not mapped
   
rowspan td; th    
exposed via IAccessibleTableCell::rowExtent
 
Exposed via atk_table_get_row_extent_at
AXRowIndexRange:
loc=<row index>
len=<rowspan value>
 
sandbox iframe    
Not mapped
 
Not mapped
   
spellcheck HTML elements    
Mapped to "invalid" text attribute on the text container
 
Mapped to "invalid" text attribute on the text container
   
scope th    
Defines whether the element is a row or column header (refer to th element)
 
Defines whether the element is a row or column header (refer to th element)
   
scoped style    
Not mapped
 
Not mapped
   
seamless iframe    
Not mapped
 
Not mapped
   
selected option    
States: STATE_SYSTEM_SELECTED; if the container widget has DOM focus then STATE_SYSTEM_FOCUSED (refer to option element)
 
States: ATK_STATE_SELECTED; if the container widget has DOM focus then ATK_STATE_FOCUSED (refer to option element)
   
shape area    
Not mapped
 
Not mapped
   
size input; select    
If greater than 1, then creates a listbox accessible object. Refer to select element for details.
 
If greater than 1, then creates a listbox accessible object. Refer to select element for details.
   
sizes link    
Not mapped
 
Not mapped
   
span col; colgroup    
exposed as IAccessibleTableCell::columnExtent on all cells at the column
 
Exposed via atk_table_get_column_extent_at
   
src audio; embed; iframe; img; input; script; source; track; video    
Object attributes: src on img only
 
Object attributes: src on img only
   
srcdoc iframe    
Not mapped
 
Not mapped
   
srclang track    
Not mapped
 
Not mapped
   
start ol    
Changes the first number of the child list item accessible objects to match the start attribute's value.
 
Changes the first number of the child list item accessible objects to match the start attribute's value.
   
step input    
Not mapped
 
Exposed as atk_value_get_minimum_increment if the element implements the AtkValue interface
   
style HTML elements Not mapped  
Refer to CSS accessibility mapping
 
Refer to CSS accessibility mapping
   
tabindex HTML elements Not mapped  
States: STATE_SYSTEM_FOCUSABLE; when the element has DOM focus then STATE_SYSTEM_FOCUSED
 
States: ATK_STATE_FOCUSABLE; when the element has DOM focus then ATK_STATE_FOCUSED
   
target a; area    
Not mapped
 
Not mapped
   
target base    
Not mapped
 
Not mapped
   
target form    
Not mapped
 
Not mapped
   
title HTML elements    
Associates the accessible name or if it was provided otherwise then accessible description
 
Associates the accessible name or if it was provided otherwise then accessible description
AXHelp: <value>  
title abbr; dfn    
Associates the accessible name
 
Associates the accessible name
AXHelp: <value>  
title menuitem    
Associates the accessible name or if it was provided otherwise then accessible description
 
Associates the accessible name or if it was provided otherwise then accessible description
AXHelp: <value>  
title link; style    
Not mapped
 
Not mapped
Not mapped
 
translate HTML elements    
Not mapped
 
Not mapped
   
type button    
submit type may be a default button in the form
 
submit type may be a default button in the form
   
type button; input    
Defines the accessible role, states and other properties, refer to type="text", type="password", type="button", etc
 
Defines the accessible role, states and other properties, refer to type="text", type="password", type="button", etc
   
type menuitem    
Defines the accessible role and states, refer to type="command"
 
Defines the accessible role and states: type="command"
   
type embed; object; script; source; style    
Not mapped
 
Not mapped
   
type menu    
Not mapped
 
Not mapped
   
typemustmatch object    
Not mapped
 
Not mapped
   
usemap img; object    
Responsible for image map creation, refer to img element
 
Responsible for image map creation, refer to img element
   
value button; option    
Not mapped
 
Not mapped
   
value input    
Associates the accessible value for entry type input elements and accessible name for button type input elements
 
Associates the accessible value for entry type input elements and accessible name for button type input elements
AXValue: <value>  
value li    
Exposed as first text node of li's accessible object.
 
Exposed as first text node of li's accessible object.
Exposed as AXValue: <value> with accessible object:
AXRole: AXLlistMarker
AXSubrole: (nil)
AXRoleDescription: list marker
 
value meter; progress    
Exposed as IAccessibleValue::currentValue
 
Exposed as atk_value_get_current_value
AXValue: <value>  
value param    
Not mapped
 
Not mapped
   
width canvas; embed; iframe; img; input; object; video    
Defines an accessible object's width (IAccessible::accLocation)
 
Defines an accessible object's width (atk_component_get_size)
AXSize: w=n  
wrap textarea    
Not mapped
 
Not mapped
   

Accessible Name and Description Calculation

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.

input type="text", input type="password", input type="search", input type="tel", input type="url" and textarea Element

input type="text", input type="password", input type="search", input type="tel", input type="email", input type="url" and textarea Element Accessible Name Calculation

  1. If the control 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 1.1.
  2. Otherwise use the associated label element(s) accessible name(s) - if more than one label is associated; concatenate by DOM order, delimited by spaces.
  3. Otherwise use the placeholder attribute
  4. Otherwise use the title attribute
  5. Otherwise use the aria-placeholder attribute
  6. If none of the above yield a usable text string there is no accessible name

input type="text", input type="password", input type="search", input type="tel", input type="email", input type="url" and textarea Element Accessible Description Calculation

  1. If the element has an aria-describedby attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1.
  2. Otherwise use the placeholder attribute if it wasn't used as the accessible name
  3. Otherwise use the title attribute if it wasn't used as the accessible name.
  4. If none of the above yield a usable text string there is no accessible description

input type="button", input type="submit" and input type="reset"

input type="button" , input type="submit" and input type="reset" Accessible Name Calculation

  1. If the control 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 1.1.
  2. Otherwise use the value attribute
  3. For input type=submit: If steps 1 to 2 do not yield a usable text string, the accessible name is a localized string of the word "submit"
  4. For input type=reset: If steps 1 to 2 do not yield a usable text string, the accessible name is a localized string of the word "reset"
  5. Otherwise use title attribute
  6. If none of the above yield a usable text string there is no accessible name

input type="button" , input type="submit" and input type="reset" Accessible Description Calculation

  1. If the element has an aria-describedby attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1.
  2. Otherwise use the value attribute if it wasn't used as the accessible name
  3. Otherwise use the title attribute if it wasn't used as the accessible name
  4. If none of the above yield a usable text string there is no accessible description

input type="image"

input type="image" Accessible Name Calculation

  1. If the control 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 1.1.
  2. Otherwise use alt attribute
  3. Otherwise use value attribute
  4. Otherwise the user agent may provide an accessible name via a localized string of the phrase "Submit Query"
  5. Otherwise use title attribute
  6. If none of the above yield a usable text string there is no accessible name

input type="image" Accessible Description Calculation

  1. If the element has an aria-describedby attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1.
  2. Otherwise use the title attribute if it wasn't used as the accessible name.
  3. If none of the above yield a usable text string there is no accessible description

button Element

button Element Accessible Name Calculation

  1. If the button 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 1.1.
  2. Otherwise use the button element subtree
  3. Otherwise use title attribute
  4. If none of the above yield a usable text string there is no accessible name

button Element Accessible Description Calculation

  1. use aria-describedby
  2. Otherwise use the title attribute if it wasn't used as the accessible name.

fieldset and legend Elements

fieldset Element Accessible Name Calculation

  1. If the 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 1.1.
  2. Otherwise use legend subtree
  3. Otherwise use title attribute
  4. If none of the above yield a usable text string there is no accessible name

fieldset Element Accessible Description Calculation

  1. If the fieldset element has an aria-describedby attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1.
  2. Otherwise use the title attribute if it wasn't used as the accessible name
  3. If none of the above yield a usable text string there is no accessible description

Other Form Elements

Other Form Elements Accessible Name Calculation

  1. If the control 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 1.1.
  2. Otherwise use label element
  3. Otherwise use title attribute
  4. If none of the above yield a usable text string there is no accessible name

Other Form Elements Accessible Description Calculation

  1. If the element has an aria-describedby attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1.
  2. Otherwise use the title attribute if it wasn't used as the accessible name.
  3. If none of the above yield a usable text string there is no accessible description

summary Element

summary Element Accessible Name Calculation

  1. If the summary 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 1.1.
  2. Otherwise use summary element subtree
  3. Otherwise use title attribute
  4. If none of the above yield a usable text string the user agent should provide its own text string (e.g. "Details")

summary Element Accessible Description Calculation

  1. If the element has an aria-describedby attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1.
  2. Otherwise use summary element subtree if not used as the accessible name
  3. Otherwise use the title attribute if it wasn't used as the accessible name
  4. If none of the above yield a usable text string there is no accessible description

figure and figcaption Elements

figure Element Accessible Name Calculation

  1. If the 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 1.1.
  2. Otherwise use figcaption subtree
  3. Otherwise use title attribute
  4. If none of the above yield a usable text string there is no accessible name

figure Element Accessible Description Calculation

  1. If the element has an aria-describedby attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1.
  2. Otherwise use the title attribute if it wasn't used as the accessible name
  3. If none of the above yield a usable text string there is no accessible description

img Element

img element Accessible Name Calculation

  1. If the 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 1.1.
  2. Otherwise use alt attribute
  3. Otherwise use title attribute
  4. If none of the above yield a usable text string there is no accessible name

If the img element is exposed in the accessibility tree and the computed text alternative is empty, then check for the presence of role="presentation" or any labeling attribute that specifies an empty label, specifically aria-label, aria-labelledby, alt or title. The presence of any of these indicates the author's intention to indicate that the img is decorative or redundant. In this case, the user agent must set the name to an empty string. If none of these attributes are present, this indicates the author simply did not provide an accessible label for the image, and the implementation must return an accessible name of NULL instead of an empty string if the accessibility API supports it. This hints to the assistive technology to do its own heuristic processing to repair the missing accessible name.

img Element Accessible Description Calculation

  1. If the element has an aria-describedby attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1.
  2. Otherwise use the title attribute if it wasn't used as the accessible name
  3. If none of the above yield a usable text string there is no accessible description

table Element

table Element Accessible Name Calculation

  1. If the table 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 1.1.
  2. Otherwise use caption element
  3. Otherwise use the title attribute
  4. If none of the above yield a usable text string there is no accessible name

table Element Accessible Description Calculation

  1. If the element has an aria-describedby attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1.
  2. Otherwise use the caption element if it wasn't used as the accessible name
  3. Otherwise use the title attribute if it wasn't used as the accessible name
  4. If none of the above yield a usable text string there is no accessible description

a Element

a Element Accessible Name Calculation

  1. If the a 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 1.1.
  2. Otherwise use a element subtree
  3. Otherwise use the title attribute
  4. If none of the above yield a usable text string there is no accessible name

a Element Accessible Description Calculation

  1. If the element has an aria-describedby attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1.
  2. Otherwise use the title attribute if it wasn't used as the accessible name
  3. If none of the above yield a usable text string there is no accessible description

Section Elements and Grouping Content Elements Not listed Elsewhere

Section and Grouping Element Accessible Name Calculation

  1. If the 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 1.1.
  2. Otherwise use the title attribute
  3. If none of the above yield a usable text string there is no accessible name

Section and Grouping Element Accessible Description Calculation

  1. If the element has an aria-describedby attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1.
  2. Otherwise use the title attribute if it wasn't used as the accessible name
  3. If none of the above yield a usable text string there is no accessible description

Text Level Elements Not listed Elsewhere

em, strong, small, s, cite, q, dfn, abbr, time, code, var, samp, kbd, sub and sup, i, b, u, mark, ruby, rt, rp, bdi, bdo, br, wbr

Text Level Element Accessible Name Calculation

  1. If the 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 1.1.
  2. Otherwise use the title attribute
  3. If none of the above yield a usable text string there is no accessible name

Text Level Element Accessible Description Calculation

  1. If the element has an aria-describedby attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1.
  2. Otherwise use the title attribute if it wasn't used as the accessible name
  3. If none of the above yield a usable text string there is no accessible description

Accessible Feature Implementation Examples

summary and details Elements

Focus and Keyboard Interaction

The summary element should be focusable by default.

The details element should not focusable by default.

Pressing the spacebar or enter key when the summary element has focus will show the details element content if the content is hidden. If the details element content is showing and the summary element has focus, pressing the spacebar or enter key will hide the details element content.

Role, Name, State and Property Mapping

The summary element should be mapped to a disclosure triangle role in accessibility APIs that have such a role. For example the Mac accessibility API includes the AXDisclosureTriangle role. In accessibility APIs that do not have such a fine grained role, the summary element should be mapped to a button role. The role mapping table contains recommended mappings for the summary element.

The default accessible name for the summary element is the text content of the summary element.

When the details element content is hidden, the state of the content should be reflected by an accessible state or property.

Example 1: In the Mac accessibility API on the summary element (AXDisclosureTriangle), set AXExpanded property to NO. When the details element content is shown, on the summary element (AXDisclosureTriangle), set theAXExpanded property to YES. The hidden and shown states of the details element content is reflected by the absence or presence of the open attribute.

Example 2: In the IA2 accessibility API on the summary element (ROLE_SYSTEM_PUSHBUTTON), set STATE_SYSTEM_COLLAPSED. When the details element content is shown, on the summary element (ROLE_SYSTEM_PUSHBUTTON), set STATE_SYSTEM_EXPANDED. The hidden and shown states of the details element content is reflected by the absence or presence of the open attribute.

The figure and figcaption Elements

to do

Acknowledgments

The following people contributed to the development of this document.

Participants active in the HTML Accessibility Task Force active at the time of publication

Enabling funders

This publication has been funded in part with U.S. Federal funds from the Department of Education, National Institute on Disability, Independent Living, and Rehabilitation Research (NIDILRR), initially under contract number ED-OSE-10-C-0067 and currently under contract number HHSP23301500054C. The content of this publication does not necessarily reflect the views or policies of the U.S. Department of Education, nor does mention of trade names, commercial products, or organizations imply endorsement by the U.S. Government.