HTML Accessibility API Mappings 1.0

Abstract

HTML Accessibility API Mappings (HTML-AAM) defines how user agents map HTML [HTML] elements and attributes to platform accessibility application programming interfaces (APIs). It leverages and extends the Core Accessibility API Mappings 1.2 and the Accessible Name and Description Computation 1.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.

3. Mapping HTML to Accessibility APIs

3.1 General Rules for Exposing WAI-ARIA Semantics

Note

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.

3.2 Conflicts Between Native Markup Semantics and WAI-ARIA

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.

3.3 Exposing HTML Features That Do Not Directly Map to Accessibility APIs

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].

3.4 HTML Element Role Mappings

HTML elements with implicit WAI-ARIA role semantics MUST be mapped to platform accessibility APIs according to those WAI-ARIA roles' mappings as defined in the [core-aam-1.2] specification.
A '?' in a cell indicates the data has yet to be provided.
"Not mapped" (Not Applicable) means the 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.
Where applicable, how an element participates in the computation of its own or another element's accessible name and/or accessible description is described in the Accessible Name and Description Computation section of this document.
Where an element is indicated as having "No corresponding (WAI-ARIA) 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.
IAccessible2:
- All elements with accessible objects should implement the IAccessible, IAccessible2 and IAccessible2_2 interfaces.
UIA:
- When a labelable element is referenced by a 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.
- Elements mapped to the 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.
AXAPI:
- User agents should return a user-presentable, localized string value for the Mac Accessibility AXRoleDescription.

Mappings of HTML elements to platform accessibility APIs: ARIA, MSAA + UIA Express, MSAA + IAccessible2, UIA, ATK, and AX
Element	[wai-aria-1.1]	MSAA + IAccessible2	UIA	ATK	AX	Comments
`a` (represents a hyperlink)	`link` role	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`a` (no `href` attribute)	No corresponding role	Roles: `ROLE_SYSTEM_TEXT`; `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	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 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	Roles: `ROLE_SYSTEM_GROUPING`; `IA2_ROLE_SECTION` Interfaces: `IAccessibleText2`; `IAccessibleHypertext2`;	Control Type: `Group`	Role: `ATK_ROLE_SECTION` Interfaces: `AtkText`; `AtkHypertext`	AXRole: `AXGroup` AXSubrole: `(nil)` AXRoleDescription: `"group"`
`area` (represents a hyperlink)	`link` role	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`area` (no `href` attribute)	No corresponding role	Roles: `ROLE_SYSTEM_TEXT`; `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
`aside`	`complementary` role	Use WAI-ARIA mapping	Use WAI-ARIA mapping Localized Control Type: `"aside"`	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`audio`	No corresponding role	Role: `ROLE_SYSTEM_GROUPING`	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.	Role: `ATK_ROLE_AUDIO`	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`).
autonomous custom element	If the author assigned a conforming ARIA role using the `role` attribute, map to that role. Otherwise, no corresponding role.	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`b`	No corresponding role	No accessible object. Exposed as "font-weight" text attribute on the text container. The value depends on the platform.	No accessible object. Exposed by the `FontWeight` attribute 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
`bdi`	No corresponding role	No accessible object. May affect on "writing-mode" text attribute on its text container.	Control Type: `Text`	No accessible object. May affect on "writing-mode" text attribute on its text container.
`bdo`	No corresponding role	Role: `ROLE_SYSTEM_TEXT` Text attributes: `writing-mode` on the 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	Roles: `ROLE_SYSTEM_GROUPING`; `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`	No corresponding role	Roles: `ROLE_SYSTEM_DOCUMENT`	Control Type: `Pane` Localized Control Type: `"pane"`	Role: `ATK_ROLE_DOCUMENT_WEB`	AXRole: `AXWebArea` AXSubrole: `(nil)` AXRoleDescription: `"HTML content"`
`br`	No corresponding role	No accessible object. Exposed as '\n' character via `IAccessibleText2` interface on the text container.	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	A `button`'s mapping will change if the `aria-pressed` and `aria-haspopup` attributes are specified.
`canvas`	No corresponding role	Roles: `ROLE_SYSTEM_GRAPHIC`; `IA2_ROLE_CANVAS`	Control Type: `Image` Descendants of the `canvas` element are mapped separately.	Role: `ATK_ROLE_CANVAS`	AXRole: `AXGroup` AXSubrole: `(nil)` AXRoleDescription: `""`
`caption`	No corresponding role	Roles: `ROLE_SYSTEM_TEXT`; `IA2_ROLE_CAPTION` States: `STATE_SYSTEM_READONLY` Relations: `IA2_RELATION_LABEL_FOR` with parent `table` Interfaces: `IAccessibleText2`; `IAccessibleHypertext2`;	Control Type: `Text` Other properties: The `LabeledBy` property for the parent `table` element points 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 mapped into text attributes on its text container.	No accessible object. Styles used are exposed by UIA text attributes 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 mapped into text attributes on its text container.	No accessible object. Styles used are exposed by UIA text attributes 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: `AXCodeStyleGroup` AXRoleDescription: `"group"`
`col`	No corresponding role	Not mapped	Not mapped	Not mapped	Not mapped
`colgroup`	No corresponding role	Role: `ROLE_SYSTEM_GROUPING`	Control Type: `Group` Localized Control Type: `"colgroup"`	Not mapped	Not mapped
`data`	No corresponding role	Not mapped	Not mapped	Not mapped	Not mapped
`datalist` (represents pre-defined options for `input` element)	`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	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	If `datalist` is not linked to a proper `input` element, then `datalist` element is not mapped to accessibility APIs.
`dd`	`definition` role	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`del`	No corresponding role	Role: `IA2_ROLE_CONTENT_DELETION`	Control Type: `Text` Localized Control Type: `"del"`	Role: `ATK_ROLE_CONTENT_DELETION` Object attributes: `xml-roles:deletion`	AXRole: `AXGroup` AXSubrole: `AXDeleteStyleGroup` AXRoleDescription: `"group"`
`details`	No corresponding role	Role: `ROLE_SYSTEM_GROUPING`	Control Type: `Group` Localized Control Type: `"details"`	Role: `ATK_ROLE_PANEL` Relations: `ATK_RELATION_DETAILS_FOR`	AXRole: `AXGroup` AXSubrole: `(nil)` AXRoleDescription: `"group"`
`dfn`	`term` role	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`dialog`	`dialog` role	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	See also the `dialog` element's `open` attribute.
`div`	No corresponding role	May not have an accessible object if has no semantic meaning. Otherwise, Roles: `ROLE_SYSTEM_GROUPING`; `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`	Control Type: `List`	Role: `ATK_ROLE_DESCRIPTION_LIST`	AXRole: `AXList` AXSubrole: `AXDefinitionList` AXRoleDescription: `"definition list"`
`dt`	`term` role	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`em`	No corresponding role	No accessible object. Styles used are mapped into text attributes on its text container.	No accessible object. Styles used are exposed by UIA text attributes 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	Roles: `ROLE_SYSTEM_CLIENT`; `IA2_ROLE_EMBEDDED_OBJECT` States: `STATE_SYSTEM_UNAVAILABLE` for windowless plugin	Control Type: `Pane`	Role: `ATK_ROLE_EMBEDDED`	Depends on format of data file
`fieldset`	`group` role	Role: Use WAI-ARIA mapping Relations: `IA2_RELATION_LABELLED_BY` with child `legend` element	Role: Use WAI-ARIA mapping	Role: Use WAI-ARIA mapping Relations: `ATK_RELATION_LABELLED_BY` with child `legend` element	Role: Use WAI-ARIA mapping AXSubrole: `AXFieldset` AXDescription: value from child `legend` subtree
`figcaption`	No corresponding role	Roles: `ROLE_SYSTEM_TEXT`; `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`	`figure` role	Role: Use WAI-ARIA mapping Relations: `IA2_RELATION_LABELLED_BY` with child `figcaption` element	Role: Use WAI-ARIA mapping Accessible name derived from `figcaption` according to the `figure` Element Accessible Name Computation	Role: Use WAI-ARIA mapping Name: related `figcaption` content Relations: `ATK_RELATION_LABELLED_BY` with child `figcaption` element	AXRole: Use WAI-ARIA mapping
`footer` (scoped to the `body` element)	`contentinfo` role	Use WAI-ARIA mapping	Use WAI-ARIA mapping Localized Control Type: `"footer"`	Use WAI-ARIA mapping	Use WAI-ARIA mapping AXRoleDescription: `"footer"`
`footer` (scoped to the `main` element, a sectioning content element, or a sectioning root element other than `body`)	No corresponding role	Roles: `ROLE_SYSTEM_GROUPING`; `IA2_ROLE_SECTION` Interfaces: `IAccessibleText2`; `IAccessibleHypertext2`;	Control Type: `Group` Localized Control Type: `"footer"`	Role: `ATK_ROLE_FOOTER` Interfaces: `AtkText`; `AtkHypertext`	AXRole: `AXGroup` AXSubrole: `(nil)` AXRoleDescription: `"group"`
`form` with an accessible name	`form` role	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`form` without an accessible name	No corresponding role	Role: `ROLE_SYSTEM_GROUPING`; `IA2_ROLE_SECTION` Interfaces: `IAccessibleText2`; `IAccessibleHypertext2`;	Control Type: `Group` Localized Control Type: `"form"`	Role: `ATK_ROLE_SECTION` Interfaces: `AtkText`; `AtkHypertext`	AXRole: `AXGroup` AXSubrole: `(nil)` AXRoleDescription: `"group"`
form-associated custom element	If the author assigned a conforming ARIA role using the `role` attribute, map to that role. Otherwise, no corresponding role.	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`h1`, `h2`, `h3`, `h4`, `h5`, and `h6`	`heading` role, with the `aria-level` property set to the number in the element's tag name.	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
`header` (scoped to the `body` element)	`banner` role	Use WAI-ARIA mapping	Use WAI-ARIA mapping Localized Control Type: `"header"`	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`header` (scoped to the `main` element, a sectioning content element, or a sectioning root element other than `body`)	No corresponding role	Role: `ROLE_SYSTEM_GROUPING`; `IA2_ROLE_SECTION` Interfaces: `IAccessibleText2`; `IAccessibleHypertext2`;	Control Type: `Group` Localized Control Type: `"header"`	Role: `ATK_ROLE_HEADER` Interfaces: `AtkText`; `AtkHypertext`	AXRole: `AXGroup` AXSubrole: `(nil)` AXRoleDescription: `"group"`
`hgroup`	No corresponding role	Not mapped	Not mapped	Not mapped	Not mapped
`hr`	`separator` role	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
`i`	No corresponding role	No accessible object. Text attributes: `font-style:italic` on the text container	No accessible object. Exposed by the `IsItalic` attribute 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: `IA2_ROLE_INTERNAL_FRAME`	Control Type: `Pane`	Role: `ATK_ROLE_INTERNAL_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
`img` (`alt` attribute value is an empty string, i.e. `alt=""` or `alt` with no value in the markup)	`presentation` See also the Note under `img` element Accessible Name Computation.	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
`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
`input` (`type` attribute in the Color state)	No corresponding role	If implemented as a textbox: Roles: `ROLE_SYSTEM_TEXT` If implemented as a color picker: Roles: `IA2_ROLE_COLOR_CHOOSER`	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"	If implemented as a button, use WAI-ARIA mapping for `button`. If implemented as a textbox, use WAI-ARIA mapping for `textbox`.	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"`	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)	No corresponding role	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`	Depends on UI design of implementation. The UI in Windows 10 Edge, for example, is a composite of multiple spinners.	Role: `ATK_ROLE_CALENDAR`	AXRole: `AXDateField` AXSubrole: `(nil)` AXRoleDescription: `"date field"`
`input` (`type` attribute in the E-mail state with no suggestions source element)	`textbox` role	Use WAI-ARIA mapping Object attributes: `text-input-type:email`	Use WAI-ARIA mapping Localized Control Type: `"email"`	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`input` (`type` attribute in the File Upload state)	No corresponding role	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.	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	Not mapped	Not mapped	Not mapped	Not mapped
`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
`input` (`type` attribute in the Local Date and Time state)	No corresponding role	Role: `IA2_ROLE_DATE_EDITOR`	Depends on UI design of implementation. The UI in Windows 10 Edge, for Example, is a composite of multiple spinners.	Role: `ATK_ROLE_CALENDAR`	AXRole: `AXTextField` AXSubrole: `(nil)` AXRoleDescription: `"text field"`
`input` (`type` attribute in the Month state)	No corresponding role	Role: `IA2_ROLE_DATE_EDITOR`	Depends on UI design of implementation. The UI in Windows 10 Edge, for Example, is a composite of multiple spinners.	Role: `ATK_ROLE_DATE_EDITOR`	AXRole: `AXTextField` AXSubrole: `(nil)` AXRoleDescription: `"text field"`
`input` (`type` attribute in the Number state)	`spinbutton` role	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`	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"`	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`	Use WAI-ARIA mapping
`input` (`type` attribute in the Password state)	No corresponding role	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"` Other properties: Set `isPassword` to `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
`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
`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
`input` (`type` attribute in the Search state with no suggestions source element)	`searchbox` role	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
`input` (`type` attribute in the Telephone state with no suggestions source element)	`textbox` role	Use WAI-ARIA mapping Object attributes: `text-input-type:telephone`	Use WAI-ARIA mapping 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
`input` (`type` attribute in the Text, Search, Telephone, URL, or E-mail states with a suggestions source element)	`combobox` role, with the `aria-controls` property set to the same value as the `list` attribute	Use WAI-ARIA mapping Object attributes: `text-input-type:as per input type`	Use WAI-ARIA mapping Other properties: `ControllerFor` points to the suggestions source element	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; `ROLE_SYSTEM_GROUPING` with child controls mapped as appropriate if implemented as a complex widget Object attributes: `text-input-type:time`	Depends on UI design of implementation. The UI in Windows 10 Edge, for Example, is a composite of multiple spinners.	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 Object attributes: `text-input-type:url`	Use WAI-ARIA mapping Localized Control Type: `"url"`	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`input` (`type` attribute in the Week state)	No corresponding role	Role: `IA2_ROLE_DATE_EDITOR` Object attributes: `text-input-type:week`	Depends on UI design of implementation. The UI in Windows 10 Edge, for Example, is a composite of multiple spinners.	Role: `ATK_ROLE_CALENDAR`	AXRole: `AXTextField` AXSubrole: `(nil)` AXRoleDescription: `"text field"`
`ins`	No corresponding role	Role: `IA2_ROLE_CONTENT_INSERTION`	Control Type: `Text` Localized Control Type: `"ins"`	Role: `ATK_ROLE_CONTENT_INSERTION` Object attributes: `xml-roles:insertion`	AXRole: `AXGroup` AXSubrole: `AXInsertStyleGroup` AXRoleDescription: `"group"`
`kbd`	No corresponding role	No accessible object. Text attributes: `font-family:monospace` 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. Mapped into "font-family:monospace" text attribute on its text container.	AXRole: `AXGroup` AXSubrole: `(nil)` AXRoleDescription: `"group"`
`label`	No corresponding role	Roles: `ROLE_SYSTEM_STATICTEXT`; `IA2_ROLE_LABEL` Relations: `IA2_RELATION_LABEL_FOR` with a form control that is child to the `label` or referred to by the `label` element's `for` attribute. The associated form element has `IA2_RELATION_LABELLED_BY` pointing to the `label`. Interfaces: `IAccessibleText2`; `IAccessibleHypertext2`	Control Type: `Text` Other properties: When the `label` element contains an `input` element, the `LabeledBy` property for the `input` element points to the UIA element for the `label` element. When the `label` element has a `for` attribute referencing another element, the `LabeledBy` property for the referenced element points 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	Roles: `ROLE_SYSTEM_STATICTEXT`; `IA2_ROLE_LABEL` Relations: `IA2_RELATION_LABEL_FOR` with the parent `fieldset` Interfaces: `IAccessibleText2`; `IAccessibleHypertext2`	Control Type: `Text` Other properties: The `LabeledBy` property for the parent `fieldset` points 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
`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
`link`	No corresponding role	Not mapped	Not mapped	Not mapped	Not mapped
`main`	`main` role	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`map`	No corresponding role	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`	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`.
`mark`	No corresponding role	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` Localized Control Type: `"highlight"`	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: `(nil)` AXRoleDescription: `"highlight"`
`math`	`math` role	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`menu`	`list` role	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	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`	No corresponding role	Not mapped	Not mapped	Not mapped	Not mapped
`meter`	No corresponding role	Role: `IA2_ROLE_LEVEL_BAR` Interfaces: `IAccessibleValue`;	Control Type: `ProgressBar` Localized Control Type: `meter` Control Pattern: `RangeValue`	Role: `ATK_ROLE_LEVEL_BAR` Interfaces: `AtkValue` Properties: `AtkRange`	AXRole: `AXLevelIndicator` AXSubrole: `(nil)` AXRoleDescription: `"level indicator"`	See GitHub issue #2.
`nav`	`navigation` role	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
`object`	No corresponding role	Depends on format of data file. If it 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
`optgroup`	`group` role	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
`output`	`status` role	Use WAI-ARIA mapping	Use WAI-ARIA mapping Localized Control Type: `"output"`	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`p`	No corresponding role	Roles: `ROLE_SYSTEM_TEXT`; `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
`picture`	No corresponding role	Not mapped	Not mapped	Not mapped	Not mapped
`pre`	No corresponding role	Roles: `ROLE_SYSTEM_GROUPING`; `IA2_ROLE_SECTION` Styles used are mapped to text attributes on the parent accessible object. Interfaces: `IAccessibleText2`; `IAccessibleHypertext2`	Control Type: `Text` Localized Control Type: `"pre"`	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
`q`	No corresponding role	Roles: `ROLE_SYSTEM_TEXT`; `IA2_ROLE_TEXT_FRAME` Children: `ROLE_SYSTEM_TEXT` wrapped by quote marks using `ROLE_SYSTEM_STATICTEXT` Interfaces: `IAccessibleText2`; `IAccessibleHypertext2`	Control Type: `Text` Localized Control Type: `"q"`	Role: `ATK_ROLE_STATIC` Interfaces: `AtkText`; `AtkHypertext`	AXRole: `AXGroup` AXSubrole: `(nil)` AXRoleDescription: `"group"`
`rp`	No corresponding role	No accessible object. No child elements are exposed if `ruby` is supported by the browser.	No accessible object.	No accessible object. No child elements are exposed if `ruby` is supported by the browser.	Not mapped
`rt`	No corresponding role	No accessible object. No child elements are exposed if `ruby` is supported by the browser.	No accessible object.	No accessible object.	AXRole: `AXGroup` AXSubrole: `AXRubyText` AXRoleDescription: `"group"`
`ruby`	No corresponding role	Role: `ROLE_SYSTEM_TEXT`; `IA2_ROLE_TEXT_FRAME`	Control Type: `Text` Localized Control Type: `"ruby"`	Role: `ATK_ROLE_STATIC`	AXRole: `AXGroup` AXSubrole: `AXRubyInline` AXRoleDescription: `"group"`
`s`	No corresponding role	No accessible object. Text attributes: `text-line-through-style:solid` 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 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
`section`	`region` role if the `section` element has an accessible name. Otherwise, no corresponding role.	If the `section` element has an accessible name, use WAI-ARIA mapping. Otherwise: Roles: `ROLE_SYSTEM_GROUPING`; `IA2_ROLE_SECTION` Interfaces: `IAccessibleText2`; `IAccessibleHypertext2`;	If the `section` element has an accessible name: Control Type: `Group` Localized Control Type: `"section"` (all lower-case) Landmark Type: `Custom` Localized Landmark Type: `"region"` (all lower-case) Otherwise: Control Type: `Group`	If the `section` element has an accessible name, use WAI-ARIA mapping. Otherwise: Role: `ATK_ROLE_SECTION` Interfaces: `AtkText`; `AtkHypertext`	If the `section` element has an accessible name, use WAI-ARIA mapping. Otherwise: AXRole: `AXGroup` AXSubrole: `(nil)` AXRoleDescription: `"group"`
`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
`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
`slot`	No corresponding role	Not mapped	Not mapped	Not mapped	Not mapped
`small`	No corresponding role	No accessible object. Text attributes: `font-size` on the text container	No accessible object. Exposed by `FontSize` attribute 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	Not mapped	Not mapped	Not mapped	Not mapped
`span`	No corresponding role	Not mapped	Control Type: `Group`	Not mapped	AXRole: `AXGroup` AXSubrole: `(nil)` AXRoleDescription: `"group"`
`strong`	No corresponding role	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	Not mapped	Not mapped	Not mapped	Not mapped	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`	No corresponding role	Roles: `ROLE_SYSTEM_GROUPING`; `IA2_ROLE_TEXT_FRAME` Text attributes: `text-position:sub`	Control Type: `Text` Styles used are exposed by `IsSubscript` attribute of the `TextRange` Control Pattern implemented on the accessible object.	Role: `ATK_ROLE_SUBSCRIPT`	AXRole: `AXGroup` AXSubrole: `AXSubscriptStyleGroup` AXRoleDescription: `"group"`
`summary`	No corresponding role	Role: `ROLE_SYSTEM_PUSHBUTTON` States: `STATE_SYSTEM_EXPANDED` / `STATE_SYSTEM_COLLAPSED` Actions: `expand` / `collapse`	Control Type: `Button` Control Pattern: `ExpandCollapse`	Role: `ROLE_TOGGLE_BUTTON` Relations: `ATK_RELATION_DETAILS`	AXRole: `AXDisclosureTriangle` AXSubrole: `(nil)` AXRoleDescription: `"disclosure triangle"`
`sup`	No corresponding role	Roles: `ROLE_SYSTEM_GROUPING`; `IA2_ROLE_TEXT_FRAME` Text attributes: `text-position:super`	Control Type: `Text` Styles used are exposed by `IsSuperscript` attribute of the `TextRange` Control Pattern implemented on the accessible object.	Role: `ATK_ROLE_SUPERSCRIPT`	AXRole: `AXGroup` AXSubrole: `AXSuperscriptStyleGroup` AXRoleDescription: `"group"`
`svg`	`graphics-document` role	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`table`	`table` role	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
`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
`td` (ancestor `table` element has `grid` or `treegrid` role)	`gridcell` role	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
`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
`tfoot`	`rowgroup` role	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`th` (is not a column header, row header, column group header or row group 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
`th` (is not a column header, row header, column group header or row group header, and ancestor `table` element has `grid` or `treegrid` role)	`gridcell` role	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`th` (is a column header or column group header)	`columnheader` role	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`th` (is a row header or row group header)	`rowheader` role	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`thead`	`rowgroup` role	Use WAI-ARIA mapping	Control Type: `Header`	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`time`	No corresponding role	Role: `IA2_ROLE_TEXT_FRAME` Object attributes: `xml-roles:time` Interfaces: `IAccessibleText2`; `IAccessibleHypertext2`	Control Type: `Text` Localized Control Type: `"time"` Note: create a separate UIA Control of type Text. This is different from most UIA text mappings, which only create ranges in the page text pattern.	Role: `ATK_ROLE_STATIC` Object attributes: `xml-roles:time` Interfaces: `AtkText`; `AtkHypertext`	AXRole: `AXGroup` AXSubrole: `AXTimeGroup` AXRoleDescription: `"group"`
`title`	No corresponding role	Not mapped	Not mapped	Not mapped	Not mapped
`tr`	`row` role	Use WAI-ARIA mapping	Generally not mapped. If the element must be included per Core-AAM Section 5.1.2, map as `Group`.	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`track`	No corresponding role	Not mapped	Not mapped	Not mapped	Not mapped
`u`	No corresponding role	No accessible object. Exposed as "text-underline-style:solid" text attribute on its text container.	No accessible object. Exposed by `UnderlineStyle` attribute 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.	Not mapped
`ul`	`list` role	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 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`	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.	Role: `ATK_ROLE_VIDEO`	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`).
`wbr`	No corresponding role	If a line break is added, expose it with `IAccessibleText` on the text container	Not mapped	A line break if added is exposed via Text interface on its text container	AXRole: `AXGroup` AXSubrole: `(nil)` AXRoleDescription: `"group"`

3.5 HTML Attribute State and Property Mappings

Notes:

HTML attributes with default WAI-ARIA state and property semantics MUST be mapped to platform accessibility APIs according to those WAI-ARIA state and property mappings as defined in the [core-aam-1.2] specification.
A '?' in a cell indicates the data has yet to be provided.
"Not mapped" (Not Applicable) means the attribute does not need to be exposed via an accessibility API. This is usually because the attribute is not displayed as part of the user interface.
Note
In some cases, while not directly exposed to accessibility APIs, an attribute can still impact the accessibility of an element. e.g., autoplay will automatically start playing video or audio elements.
All elements having an accessible object in IAccessible2 mapping are supposed to implement IAccessible, IAccessible2 and IAccessible2_2 interfaces.

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)	Accessible Rich Internet Applications (WAI-ARIA) 1.0	MSAA + IAccessible2	UIA	ATK	AX	Comments
`abbr`	`th`	Not mapped	Object attributes: "abbr" until child `abbr` element is provided	Not mapped	Object attributes: "abbr" until child `abbr` element is provided	`AXDescription: <value>`
`accept`	`input`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`accept-charset`	`form`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`accesskey`	`HTML elements`	Not mapped	A key binding accessible by `accKeyboardShortcut` and `IAccessibleAction::keyBinding`	Properties: `AccessKey: <value>`	`atk_action_get_keybinding`	`AXAccessKey: <value>`
`action`	`form`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`allow`	`iframe`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`allowfullscreen`	`iframe`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`allowpaymentrequest`	`iframe`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`alt`	`area`; `img`; `input`	Not mapped	Used for accessible name, exposed via `accName`	Properties: `Name`	Used for accessible name, exposed via `atk_object_get_name`	`AXDescription: <value>`
`as`	`link`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`async`	`script`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`autocapitalize`	HTML elements	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`autocomplete` "on\|off"	`form`	`aria-autocomplete` Note: the ARIA attribute and the HTML attribute have disparate features.	States: `STATE_SUPPORTS_AUTOCOMPLETION` on text form controls until the value is overridden by control	Not mapped	States: `ATK_STATE_SUPPORTS_AUTOCOMPLETION` on text form controls until the value is overridden 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` and `textarea`	`aria-autocomplete` Note: the ARIA attribute and the HTML attribute have disparate features.	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`	HTML elements	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped	Similar to `aria-flowto`.
`autoplay`	`audio` and `video`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`charset`	`meta`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`checked` (if present)	`input`	`aria-checked` (state)="true"	States: `STATE_SYSTEM_CHECKED`	Expose as `ToggleState` property in `Toggle` control pattern	States: `ATK_STATE_CHECKED`	`AXValue: 1`	If the element 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`	`aria-checked` (state)="false"	Not mapped	Expose as `ToggleState` property in `Toggle` control pattern.	Not mapped	`AXValue: 0`
`cite`	`blockquote`; `del` and `ins`; `q`	Not mapped	Not mapped	Not mapped	Not mapped	`AXURL: <value>`
`class`	HTML elements	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`color`	`link`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`cols`	`textarea`	Not mapped	Not mapped	Not mapped	Not mapped	`AXRangeForLine: <value>`	Not mapped
`colspan`	`td` and `th`	`aria-colspan`	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`content`	`meta`	Not mapped	Not mapped	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	Control Pattern: `TextEdit`	States: `ATK_STATE_EDITABLE` on this and every nested text accessible object. Interfaces: `AtkEditableText` on this and every nested text accessible object.	Role: AXtextArea Use WAI-ARIA mapping	If the element has the `contenteditable` attribute and `aria-readonly="true"`, User Agents MUST expose only the `contenteditable` state.
`controls`	`audio` and `video`	Not mapped	Not mapped	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 (`BoundingRectangle`)	Defines an accessible object's dimensions, exposed via `atk_component_get_position` and `atk_component_get_size`	Defines an accessible object's dimensions, exposed via `Frame` property
`crossorigin`	`audio`; `img`; `link`; `script`; `video`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`data`	`object`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`datetime`	`del` and `ins`	Not mapped	Object attributes: `datetime: <value>`	Not mapped	Object attributes: `datetime: <value>`	`AXDateTimeValue: <value>`
`datetime`	`time`	Not mapped	Object attributes: `datetime: <value>`	Properties: `FullDescription: <value>`	Object attributes: `datetime: <value>`	`AXDateTimeValue: <value>`
`decoding`	`img`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`default`	`track`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`defer`	`script`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`dir`	HTML elements	Not mapped	Exposed as "writing-mode" text attribute on the text container.	Exposed by `TextFlowDirections` attribute of the `TextRange` Control Pattern implemented on a parent accessible object.	Exposed as "writing-mode" text attribute on the text container.	Not mapped
`dirname`	`input` and `textarea`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`disabled`	`button`; `fieldset`; `input`; `optgroup`; `option`; `select`; `textarea`; form-associated custom element	`aria-disabled="true"`	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	If the element includes both the `disabled` attribute and the `aria-disabled` attribute with a valid value, User Agents MUST expose only the `disabled` attribute value.
`download`	`a` and `area`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`draggable`	HTML elements	Not mapped	Object attributes: draggable:true	Not mapped	Object attributes: draggable:true	Not mapped
`enctype`	`form`	Not mapped	Not mapped	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	Not mapped	Used for accessible name Relations: `ATK_RELATION_LABEL_FOR` and `ATK_RELATION_LABEL_BY` relations between `label` and referred element	Not mapped
`for`	`output`	Not mapped	Relations: `IA2_RELATION_CONTROLLED_BY` with an element pointed by the attribute. Paired element exposes `IA2_RELATION_CONTROLLER_FOR` relation.	Not mapped	Relations: `ATK_RELATION_CONTROLLED_BY` with an element pointed by the attribute. Paired element exposes `ATK_RELATION_CONTROLLER_FOR` relation.	Not mapped
`form`	`button`; `fieldset`; `input`; `label`; `object`; `output`; `select`; `textarea`; form-associated custom element	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`formaction`	`button`; `input`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`formenctype`	`button`; `input`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`formmethod`	`button`; `input`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`formnovalidate`	`button`; `input`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`formtarget`	`button`; `input`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`headers`	`td`; `th`	Not mapped	Links the cell to its header cells. Exposed via `IAccessibleTableCell::rowHeaderCells` and `IAccessibleTableCell::columnHeaderCells`.	Links the cell to its header cells. Exposed via `Table.ItemColumnHeaderItems` and `Table.ItemRowHeaderItems`.	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 (`BoundingRectangle`)	Defines an accessible object's height (`atk_component_get_size`)	Defines an accessible object's height (`AXSize` property)
`hidden`	HTML elements	`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.	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`high`	`meter`	Not mapped	Not mapped	`RangeValue.Maximum`	Not mapped	Not mapped
`href`	`a`; `area`	Not mapped	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. The value of the `href` attribute is stored in the `Value.Value` UIA property.	Creates a link accessible object. For details, refer to `a` and `area` element mappings.	`AXURL: <value>`
`href`	`link`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`hreflang`	`a`; `link`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`http-equiv`	`meta`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`id`	HTML elements	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`indeterminate [IDL]`	HTML elements; `input`	`aria-checked` (state)="mixed"	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	If the element has the `indeterminate [IDL]` set and the `aria-checked` attribute set, User Agents MUST expose only the`indeterminate [IDL]` state.
`ismap`	`img`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`kind`	`track`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`label`	`optgroup`; `option`; `track`	Not mapped	Associates the accessible name	The target element of the `label` attribute has a `LabeledBy` property pointing to the element with the `label` attribute. Participates in name computation.	Associates the accessible name	`AXTitle`: `<value>`	See Also: Accessible Name and Description: Computation and API Mappings 1.1
`lang`	HTML elements	Not mapped	Exposed as "language" text attribute on the text container	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.	Exposed as "language" text attribute on the text container	`AXLanguage: <value>`
`list`	`input`	`aria-controls`	`IA2_RELATION_CONTROLLER_FOR` pointing to a `datalist` element referred by the `list` attribute.	`ControllerFor` pointing to a `datalist` element referred by the `list` attribute.	`ATK_RELATION_CONTROLLER_FOR` pointing to a `datalist` element referred by the `list` attribute.	Not mapped	Refer to `datalist` and `input` elements mapping.
`loop`	`audio`; `video`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`low`	`meter`	Not mapped	Not mapped	`RangeValue.Minimum`	Not mapped	Not mapped
`max`	`input`	`aria-valuemax`	Exposed as `IAccessibleValue::maximumValue` if the element implements the interface	`RangeValue.Maximum`	Exposed as `atk_value_get_maximum_value` if the element implements the `AtkValue` interface	`AXMaxValue: <value>`
`max`	`meter`; `progress`	`aria-valuemax`	Exposed as `IAccessibleValue::maximumValue` if the element implements the interface	`RangeValue.Maximum`	Exposed as `atk_value_get_maximum_value` if the element implements the `AtkValue` interface	`AXMaxValue: <value>`
`maxlength`	`input`; `textarea`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`media`	`link`; `source`; `style`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`method`	`form`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`min`	`input`	`aria-valuemin`	Exposed as `IAccessibleValue::minimumValue` if the element implements the interface	`RangeValue.Minimum`	Exposed as `atk_value_get_minimum_value` if the element implements the `AtkValue` interface	`AXMinValue: <value>`
`min`	`meter`	`aria-valuemin`	Exposed as `IAccessibleValue::minimumValue` if the element implements the interface	`RangeValue.Minimum`	Exposed as `atk_value_get_minimum_value` if the element implements the `AtkValue` interface	`AXMinValue: <value>`
`minlength`	`input`; `textarea`	Not mapped	States: `IA2_STATE_INVALID_ENTRY` if value doesn't meet the designated minimum length value.	States: `IsDataValidForForm` if value doesn't meet the designated minimum length value.	States: `ATK_STATE_INVALID_ENTRY` if value doesn't meet the designated minimum length value.	Property: `AXInvalid`: `true` if value doesn't meet the designated minimum length value.
`multiple`	`input`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`multiple`	`select`	`aria-multiselectable="true"`	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`muted`	`audio`; `video`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`name`	`button`; `fieldset`; `input`; `output`; `select`; `textarea`; form-associated custom element	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`name`	`form`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`name`	`iframe`; `object`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`name`	`map`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`name`	`meta`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`name`	`param`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`name`	`slot`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`nomodule`	`script`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`nonce`	HTML elements	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`novalidate`	`form`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`open`	`details`	`aria-expanded`="true \| false"	`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`	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"`.	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	The `open` attribute's value is irrelevant. When the `open` attribute is not specified the default user agent styling for a `dialog` is `display: none`. Authors can reveal a `dialog` through the style layer by modifying its `display` property. If revealed this way then the `dialog` is `aria-modal="false"` and `aria-hidden="false"`.
`optimum`	`meter`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`pattern`	`input`	Not mapped	States: `IA2_STATE_INVALID_ENTRY` if value doesn't meet the pattern	States: `IsDataValidForForm` if value doesn't meet the pattern	States: `ATK_STATE_INVALID_ENTRY` if value doesn't meet the pattern	Property: `AXInvalid`: `true` if value doesn't meet the pattern
`ping`	`a` and `area`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`placeholder`	`input`; `textarea`	`aria-placeholder`	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.
`playsinline`	`video`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`poster`	`video`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`preload`	`audio` and `video`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`readonly`	`input`; `textarea`; form-associated custom elements	`aria-readonly="true"`	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	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`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`rel`	`a`; `area`; `link`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`required`	`input`; `select`; `textarea`	`aria-required`	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	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`	Not mapped	Reverses the numbering of the child list item accessible objects.	Reverses the order of the child list items in the accessibility tree and reverses the numbering of the child list items.	Reverses the numbering of the child list item accessible objects.	Reverses the numbering of the child list markers.
`rows`	`textarea`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`rowspan`	`td`; `th`	`aria-rowspan`	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`sandbox`	`iframe`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`scope`	`th`	If `scope="row"` then map `th` to `rowheader` If `scope="col"` then map `th` to `columnheader`	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`selected`	`option`	`aria-selected="true"`	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	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`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`size`	`input`; `select`	Not mapped for `input` elements. If greater than 1, then creates a listbox accessible object. Refer to `select` element for details.	Not mapped for `input` elements. For `select` element use WAI-ARIA mapping.	Not mapped for `input` elements. For `select` element use WAI-ARIA mapping.	Not mapped for `input` elements. For `select` element use WAI-ARIA mapping.	Not mapped for `input` elements. For `select` element use WAI-ARIA mapping.	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`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`sizes`	`img`; `source`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`slot`	HTML elements	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`span`	`col`; `colgroup`	Not mapped	Exposed as `IAccessibleTableCell::columnExtent` on all cells at the column	Exposed as `GridItem.ColumnSpan` on all cells at the column	Exposed via `atk_table_get_column_extent_at`	`AXColumnIndexRange.length: <value>`
`spellcheck`	HTML elements	`aria-invalid="spelling"` or `grammar`	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`src`	`audio`; `embed`; `iframe`; `img`; `input`; `script`; `source`; `track`; `video`	Not mapped	Object attributes: `src` on `img` only	Not mapped	Object attributes: `src` on `img` only	`AXURL: <value>` on `img` and `input type="image"`
`srcdoc`	`iframe`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`srclang`	`track`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`srcset`	`img`; `source`	Not mapped	Not mapped	Not mapped	Not mapped	Not Mapped
`start`	`ol`	Not mapped	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.	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	Not mapped	If the `input` is in the `Range` state, set both `RangeValue.SmallChange` and `RangeValue.LargeChange` to the value of `step`.	Exposed as `atk_value_get_minimum_increment` if the element implements the `AtkValue` interface.	Not mapped
`style`	HTML elements	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`tabindex`	HTML elements	See Focus States and Events Table	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping
`target`	`a`; `area`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`target`	`base`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`target`	`form`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`title`	HTML elements	Either the accessible name, or the accessible description, or Not mapped (see Comments).	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	Use WAI-ARIA mapping	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`	Not mapped	Associates the accessible name	Associates the accessible name	Associates the accessible name	`AXExpandedTextValue: <value>`
`title`	`link`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`title`	`link`; `style`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped	Provides the name for the CSS style sheet.
`translate`	HTML elements	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`type`	`a`; `link`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`type`	`button`	Not mapped	`submit` type may be a default button in the form.	`submit` type may be a default button in the form.	`submit` type may be a default button in the form.	`submit` type may be a default button in the form.
`type`	`embed`; `object`; `script`; `source`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`type`	`input`	Refer to WAI-ARIA mappings for input types with defined ARIA roles.	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	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`	`ol`	Not mapped	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`	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`	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`	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"`	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`	Not mapped	Responsible for image map creation.	Responsible for image map creation.	Responsible for image map creation.	Responsible for image map creation.	Refer to `img` element.
`value`	`button`; `option`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`value`	`data`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`value`	`input`	Not mapped	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	Associates the accessible value for entry type input elements and accessible name for button type input elements	`AXValue: <value>`
`value`	`li`	Not mapped	Exposed as first text node of `li`'s accessible object.	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.	Exposed as first text node of `li`'s accessible object.	Exposed as `AXValue: <value>` with accessible object: AXRole: `AXListMarker` AXSubrole: `(nil)` AXRoleDescription: `list marker`
`value`	`meter`; `progress`	`aria-valuenow`	Exposed as `IAccessibleValue::currentValue`	Exposed as `Value.Value`	Exposed as `atk_value_get_current_value`	`AXValue: <value>`
`value`	`param`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped
`width`	`canvas`; `embed`; `iframe`; `img`; `input`; `object`; `video`	Not mapped	Defines an accessible object's width (`IAccessible::accLocation`)	Defines an accessible object's width (`BoundingRectangle`)	Defines an accessible object's width (`atk_component_get_size`)	`AXSize: w=n`
`wrap`	`textarea`	Not mapped	Not mapped	Not mapped	Not mapped	Not mapped

4. Accessible Name and Description Computation

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.

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

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

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.
Otherwise use the associated label element(s) accessible name(s) - if more than one label is associated; concatenate by DOM order, delimited by spaces.
If the accessible name is still empty, then: use the control's title attribute.
Otherwise use the control's placeholder attribute.
If none of the above yield a usable text string there is no accessible name.

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

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.
Otherwise use the title attribute if it wasn't used as the accessible name.
If none of the above yield a usable text string there is no accessible description.

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

4.2.1 `input type="button"` , `input type="submit"` and `input type="reset"` Accessible Name Computation

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

4.2.2 `input type="button"` , `input type="submit"` and `input type="reset"` Accessible Description Computation

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.
Otherwise use the value attribute if it wasn't used as the accessible name.
Otherwise use the title attribute if it wasn't used as the accessible name.
If none of the above yield a usable text string there is no accessible description.

4.3 `input type="image"`

4.3.1 `input type="image"` Accessible Name Computation

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.
Otherwise use alt attribute.
Otherwise use title attribute.
Otherwise if the previous steps do not yield a usable text string, the accessible name is a localized string of the word "Submit Query".
If none of the above yield a usable text string there is no accessible name.

4.3.2 `input type="image"` Accessible Description Computation

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.
Otherwise use the title attribute if it wasn't used as the accessible name.
If none of the above yield a usable text string there is no accessible description.

4.4 `button` Element

4.4.1 `button` Element Accessible Name Computation

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

4.4.2 `button` Element Accessible Description Computation

If the button 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.
Otherwise use the title attribute if it wasn't used as the accessible name.
If none of the above yield a usable text string there is no accessible description.

4.5 `fieldset` and `legend` Elements

4.5.1 `fieldset` Element Accessible Name Computation

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.
If the accessible name is still empty, then: if the fieldset element has a child that is a legend element, then use the subtree of the first such element.
If the accessible name is still empty, then:, if the fieldset element has a title attribute, then use that attribute.
Otherwise, there is no accessible name.

4.5.2 `fieldset` Element Accessible Description Computation

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.
Otherwise use the title attribute if it wasn't used as the accessible name.
If none of the above yield a usable text string there is no accessible description.

4.6 `output` Element

4.6.1 `output` Element Accessible Name Computation

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

4.6.2 `output` Element Accessible Description Computation

Use aria-describedby.
Otherwise use the title attribute if it wasn't used as the accessible name.
If none of the above yield a usable text string there is no accessible description.

4.7 Other Form Elements

4.7.1 Other Form Elements Accessible Name Computation

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

4.7.2 Other Form Elements Accessible Description Computation

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.
Otherwise use the title attribute if it wasn't used as the accessible name.
If none of the above yield a usable text string there is no accessible description.

4.8 `summary` Element

4.8.1 `summary` Element Accessible Name Computation

If the first 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 1.1.
Otherwise use summary element subtree.
Otherwise use title attribute.
If there is no 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".
If there is a 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.

4.8.2 `summary` Element Accessible Description Computation

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.
Otherwise use summary element subtree if not used as the accessible name.
Otherwise use the title attribute if it wasn't used as the accessible name.
If none of the above yield a usable text string there is no accessible description.

4.9 `figure` and `figcaption` Elements

4.9.1 `figure` Element Accessible Name Computation

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.
If the accessible name is still empty, then: if the figure element has a child that is a figcaption element, then use the subtree of the first such element.
If the accessible name is still empty, then: if the figure element has a title attribute, then use that attribute.
Otherwise, there is no accessible name.

4.9.2 `figure` Element Accessible Description Computation

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.
Otherwise use the title attribute if it wasn't used as the accessible name.
If none of the above yield a usable text string there is no accessible description.

4.10 `img` Element

4.10.1 `img` Element Accessible Name Computation

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

4.10.2 `img` Element Accessible Description Computation

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.
Otherwise use the title attribute if it wasn't used as the accessible name.
If none of the above yield a usable text string there is no accessible description.

4.11 `table` Element

4.11.1 `table` Element Accessible Name Computation

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.
If the accessible name is still empty, then: if the table element has a child that is a caption element, then use the subtree of the first such element.
If the accessible name is still empty, then: if the table element has a title attribute, then use that attribute.
Otherwise, there is no accessible name.

4.11.2 `table` Element Accessible Description Computation

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.
If the accessible description is still empty, then:, if the table element has a child that is a caption element and it wasn't used as the accessible name, then use the subtree of the first such element.
If the accessible description is still empty, then: if the table element has a title attribute and it wasn't used as the accessible name, then use that attribute.
Otherwise, there is no accessible description.

4.12 Other Tabular data elements

4.12.1 `tr`, `td`, `th` Elements Accessible Name Computation

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

4.12.2 `tr`, `td`, `th` Elements Accessible Description Computation

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.
Otherwise use the title attribute if it wasn't used as the accessible name.
If none of the above yield a usable text string there is no accessible description.

4.13 `a` Element with a `href` attribute

4.13.1 `a` Element Accessible Name Computation

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

4.13.2 `a` Element with a `href` attribute Accessible Description Computation

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.
Otherwise use the title attribute if it wasn't used as the accessible name.
If none of the above yield a usable text string there is no accessible description.

4.14 `area` Element

4.14.1 `area` Element Accessible Name Computation

If the area 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.
Otherwise use area element's alt attribute.
Otherwise use the title attribute.
If none of the above yield a usable text string there is no accessible name.

4.14.2 `area` Element Accessible Description Computation

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.
Otherwise use the title attribute if it wasn't used as the accessible name.
If none of the above yield a usable text string there is no accessible description.

4.15 `iframe` Element

4.15.1 `iframe` Element Accessible Name Computation

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

Note

The document referenced by the src of the iframe element gets its name from that document's title element, like any other document. If there is no title provided, there is no accessible name.

4.15.2 `iframe` Element Accessible Description Computation

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.
Otherwise use the title attribute if it wasn't used as the accessible name.
If none of the above yield a usable text string there is no accessible description.

4.16 Section Elements and Grouping Content Elements Not listed Elsewhere

4.16.1 Section and Grouping Element Accessible Name Computation

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

4.16.2 Section and Grouping Element Accessible Description Computation

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.
Otherwise use the title attribute if it wasn't used as the accessible name.
If none of the above yield a usable text string there is no accessible description.

4.17 Text Level Elements Not Listed Elsewhere

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

4.17.1 Text Level Element Accessible Name Computation

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

4.17.2 Text Level Element Accessible Description Computation

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.
Otherwise use the title attribute if it wasn't used as the accessible name.
If none of the above yield a usable text string there is no accessible description.

HTML Accessibility API Mappings 1.0

W3C Working Draft 10 August 2021

Abstract

Status of This Document

1. Introduction

1.1 Accessibility APIs

2. Conformance

2.1 Deprecated

3. Mapping HTML to Accessibility APIs

3.1 General Rules for Exposing WAI-ARIA Semantics

3.2 Conflicts Between Native Markup Semantics and WAI-ARIA

3.3 Exposing HTML Features That Do Not Directly Map to Accessibility APIs

3.4 HTML Element Role Mappings

3.5 HTML Attribute State and Property Mappings

4. Accessible Name and Description Computation

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

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

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

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

4.2.1 input type="button" , input type="submit" and input type="reset" Accessible Name Computation

4.2.2 input type="button" , input type="submit" and input type="reset" Accessible Description Computation

4.3 input type="image"

4.3.1 input type="image" Accessible Name Computation

4.3.2 input type="image" Accessible Description Computation

4.4 button Element

4.4.1 button Element Accessible Name Computation

4.4.2 button Element Accessible Description Computation

4.5 fieldset and legend Elements

4.5.1 fieldset Element Accessible Name Computation

4.5.2 fieldset Element Accessible Description Computation

4.6 output Element

4.6.1 output Element Accessible Name Computation

4.6.2 output Element Accessible Description Computation

4.7 Other Form Elements

4.7.1 Other Form Elements Accessible Name Computation

4.7.2 Other Form Elements Accessible Description Computation

4.8 summary Element

4.8.1 summary Element Accessible Name Computation

4.8.2 summary Element Accessible Description Computation

4.9 figure and figcaption Elements

4.9.1 figure Element Accessible Name Computation

4.9.2 figure Element Accessible Description Computation

4.10 img Element

4.10.1 img Element Accessible Name Computation

4.10.2 img Element Accessible Description Computation

4.11 table Element

4.11.1 table Element Accessible Name Computation

4.11.2 table Element Accessible Description Computation

4.12 Other Tabular data elements

4.12.1 tr, td, th Elements Accessible Name Computation

4.12.2 tr, td, th Elements Accessible Description Computation

4.13 a Element with a href attribute

4.13.1 a Element Accessible Name Computation

4.13.2 a Element with a href attribute Accessible Description Computation

4.14 area Element

4.14.1 area Element Accessible Name Computation

4.14.2 area Element Accessible Description Computation

4.15 iframe Element

4.15.1 iframe Element Accessible Name Computation

4.15.2 iframe Element Accessible Description Computation