Scott O'Hara (Microsoft) · w3.org

Abstract

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

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

Status of This Document

This section describes the status of this document at the time of its publication. A list of current W3C publications and the latest revision of this technical report can be found in the W3C standards and drafts index.

Note

This document is subject to change without notice.

This document was initially developed by and with the approval of the HTML Accessibility Taskforce, a joint task force of the Protocols and Formats Working Group and the HTML Working Group. Work continued with the successor groups Accessible Rich Internet Applications Working Group and the Web Applications Working Group. This document is now maintained solely by the Accessible Rich Internet Applications Working Group.

This document was published by the Accessible Rich Internet Applications Working Group as a Working Draft using the Recommendation track.

Publication as a Working Draft does not imply endorsement by W3C and its Members.

This is a draft document and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to cite this document as other than a work in progress.

This document was produced by a group operating under the W3C Patent Policy. W3C maintains a public list of any patent disclosures made in connection with the deliverables of the group; that page also includes instructions for disclosing a patent. An individual who has actual knowledge of a patent that the individual believes contains Essential Claim(s) must disclose the information in accordance with section 6 of the W3C Patent Policy.

This document is governed by the 18 August 2025 W3C Process Document.

Table of Contents

  1. Abstract
  2. Status of This Document
  3. 1. Introduction
    1. 1.1 Accessibility APIs
  4. 2. Conformance
    1. 2.1 Deprecated
  5. 3. Mapping HTML to Accessibility APIs
    1. 3.1 General Rules for Exposing WAI-ARIA Semantics
    2. 3.2 Conflicts Between Native Markup Semantics and WAI-ARIA
    3. 3.3 Exposing HTML Features That Do Not Directly Map to Accessibility APIs
    4. 3.4 Exposing HTML Features That Require a Minimum Role
    5. 3.5 HTML Element Role Mappings
      1. 3.6 HTML Attribute State and Property Mappings
      2. 4. Accessible Name and Description Computation
        1. 4.1 Accessible Name Computations By HTML Element
          1. 4.2 Accessible Description Computation
        2. 5. Privacy considerations
        3. 6. Security considerations
        4. A. Appendices
          1. A.1 Change Log
            1. A.2 Acknowledgments
            2. B. References
              1. B.1 Normative references
              2. B.2 Informative references

            This section is non-normative.

            This specification defines how HTML user agents respond to and expose role, state and property information provided for Web content. Unless indicated otherwise, an HTML element or attribute with default Accessible Rich Internet Applications (WAI-ARIA) 1.2 semantics must be exposed to the platform accessibility APIs according to the relevant WAI-ARIA mappings defined in the Core Accessibility API Mappings 1.2 specification.

            In some cases, often due to features of the HTML host language or the accessibility API in question, an element or attribute's mapping differs from the corresponding ARIA mappings specified in the [core-aam-1.2]. Where an HTML element or attribute does not have any default WAI-ARIA semantics, the applicable mapping for each platform accessibility API is defined by this specification.

            This document also adapts the Accessible Name and Description Computation 1.2 specification for deriving the accessible names and accessible descriptions of [HTML] elements, and provides accessible implementation examples for specific HTML elements and features.

            Users often access HTML content using assistive technologies that rely on platform accessibility API to obtain and interact with information from the page. This document is part of the following suite of accessibility API mapping specifications for content rendered by user agents:

            Accessibility APIs covered by this document are:

            • MSAA with IAccessible2 1.3 [IAccessible2]
            • User Interface Automation [UI-AUTOMATION]
            • ATK - Accessibility Toolkit [ATK] and Assistive Technology Service Provider Interface [AT-SPI], referred to hereafter as "ATK/AT-SPI"
            • macOS Accessibility Protocol [AXAPI]

            If user agent developers need to expose information using other accessibility APIs, it is recommended that they work closely with the developer of the platform where the API runs, and assistive technology developers on that platform.

            For more information regarding accessibility APIs, refer to section 1.1 Accessibility APIs of the Core Accessibility API Mappings 1.2.

            As well as sections marked as non-normative, all authoring guidelines, diagrams, examples, and notes in this specification are non-normative. Everything else in this specification is normative.

            The key words MAY, MUST, MUST NOT, and SHOULD in this document are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.

            Normative sections provide requirements that user agents and assistive technologies MUST follow for an implementation to conform to this specification.

            Non-normative (informative) sections provide information useful to understanding the specification. Such sections may contain examples of recommended practice, but it is not required to follow such recommendations in order to conform to this specification.

            There are currently no deprecated requirements.

            Note

            WAI-ARIA support was first introduced to HTML in [HTML5].

            User Agents MUST expose HTML elements or attributes with default WAI-ARIA semantics to the platform accessibility APIs in a way that conforms to General rules for exposing WAI-ARIA semantics in the Core Accessibility API Mappings 1.2.

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

            HTML can include features that are not supported by accessibility APIs at the time of publication. There is not a one to one relationship between all features and platform accessibility APIs. When HTML roles, states and properties do not directly map to an accessibility API, and there is a method in the API to expose a text string, user agents MUST expose the undefined role, states and properties via that method.

            For HTML elements or attributes with default WAI-ARIA semantics, user agents MUST conform to Exposing attributes that do not directly map to accessibility API properties in the [core-aam-1.2].

            A minimum role is the equivalent WAI-ARIA role an element will map to if the element does not have a more specific implicit role or platform role mappings, e.g., a non-generic role. This can help ensure that users of assistive technologies get the best possible experience for commonly-used and valid HTML markup where otherwise a role would not be exposed.

            A minimum role is provided when all of the following conditions are true:

            • the author has not specified a valid explicit WAI-ARIA role to the element, or the specified role is either none, presentation, or generic;
            • the element either has no implicit WAI-ARIA role or platform role mappings, or it has an implicit generic or none computed role;
            • and the author has specified attributes which require a minimum role mapping for the element.

            The HTML Attribute State and Property Mappings section identifies the specific global attributes which would require an element map to a minimum role.

            When these conditions are met, user agents MUST expose an object using the mappings defined in CORE-AAM for the specified minimum role. If the element has multiple attributes specified which require a minimum role be returned as the computed role for the element, prioritize the more specific role in the ARIA taxonomy.

            • User agents MUST map HTML elements with implicit WAI-ARIA role semantics to platform accessibility APIs according to the identified WAI-ARIA role mapping as defined in the [core-aam-1.2] specification.
            • "Not mapped" means the element does not need to be exposed via an accessibility API. This is usually because the element is not displayed as part of the user interface. However, authors can force some of these elements to be rendered. For instance, by overriding user agent styles to render elements that would have been otherwise set to display: none. In these cases, the user agent SHOULD map such elements to the role of generic, unless other HTML features have been specified which would require a more specific minimum role to be exposed.
            • Where an element is indicated as having "No corresponding (WAI-ARIA) role", or is mapped to the generic role, user agents MUST NOT expose the aria-roledescription property value in the accessibility tree unless the element has an explicit, conforming role attribute value which [WAI-ARIA-1.2] does not prohibit the use of aria-roledescription.
            • Some HTML elements expose implicit WAI-ARIA roles depending on whether they have been provided an accessible name. How an element participates in the computation of its own or another element's accessible name and/or accessible description is described in the Accessible Name and Description Computation section of this document.
            • When HTML elements do not have an exact or equivalent mapping to a valid, non-abstract WAI-ARIA role, a unique computedrole string has been specified to serve as the return value for interoperability testing purposes. For instance, user agents MAY expose the video element with a computedrole of "html-video". Authors MUST NOT use any html-prefixed computed role string in the role attribute (such as html-video). User Agents MUST ignore any abstract or invalid role token.

              <video> <!-- computedrole returns 'html-video' --> <main role="html-video"> <!-- Author error. computed role returns 'main' -->

            • IAccessible2:
              • All elements with accessible objects SHOULD implement the IAccessible, IAccessible2 and IAccessible2_2 interfaces.
            • UIA:
              • When a labelable element is referenced by a 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.
            HTML Specification a (represents a hyperlink)
            [wai-aria-1.2] link role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification a (no href attribute)
            [wai-aria-1.2] generic role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification abbr
            [wai-aria-1.2] No corresponding role
            Computed Role

            html-abbr
            MSAA + IAccessible2

            Roles: ROLE_SYSTEM_TEXT; IA2_ROLE_TEXT_FRAME

            Object attributes: "abbr" attribute on the containing td if a single child, text content used as a value

            UIA

            Control Type: Text
            [ATK]

            Role: ATK_ROLE_STATIC

            Object attributes: "abbr" attribute on the containing td if a single child, text content used as a value

            AX

            AXRole: AXGroup

            AXSubrole: (nil)

            AXRoleDescription: "group"
            Comments
            HTML Specification address
            [wai-aria-1.2] group role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification area (represents a hyperlink)
            [wai-aria-1.2] link role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification area (no href attribute)
            [wai-aria-1.2] generic role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments User agents MAY still expose an a element lacking the href attribute with a link role in the event an author specifies interactive behavior for the element. For example, if using an event handler attribute.
            HTML Specification article
            [wai-aria-1.2] article role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification aside (scoped to the body or main element)
            [wai-aria-1.2] complementary role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification aside (scoped to a sectioning content element)
            [wai-aria-1.2] complementary role if the aside element has an accessible name. Otherwise, generic role.
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification audio
            [wai-aria-1.2] No corresponding role
            Computed Role

            html-audio
            MSAA + IAccessible2

            Role: ROLE_SYSTEM_GROUPING
            UIA

            Control Type: Group

            Localized Control Type: "audio"

            Note: If the controls attribute is present, UI controls (e.g., play, volume) are exposed as children of the audio element in the accessibility tree, and mapped as appropriate for the type of control (e.g., button or slider).

            User agents MAY include the following in the accessibility tree and mark them as hidden or off-screen:

            • Loading messages or error messages
            • UI controls that are not currently displayed
            [ATK]

            Role: ATK_ROLE_AUDIO
            AX

            AXRole: AXGroup

            AXSubrole: AXAudio

            AXRoleDescription: "audio playback"

            Note: If the controls attribute is present, UI controls (e.g., play, volume) are exposed as descendants of an accessible object with a role of toolbar, and mapped as appropriate for the type of control (e.g., button or slider).

            Comments
            HTML Specification autonomous custom element
            [wai-aria-1.2] If the author assigned a conforming ARIA role using the role attribute, map to that role. Otherwise, the generic role.
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification b
            [wai-aria-1.2] generic role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments Exposed by platform specific bold font weight text styles.
            HTML Specification base
            [wai-aria-1.2] No corresponding role
            Computed Role

            Not mapped
            MSAA + IAccessible2

            Not mapped
            UIA

            Not mapped
            [ATK]

            Not mapped
            AX

            Not mapped
            Comments
            HTML Specification bdi
            [wai-aria-1.2] generic role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments IA2/ATK: May affect on "writing-mode" text attribute on its text container.
            HTML Specification bdo
            [wai-aria-1.2] generic role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments IA2/ATK: Exposed as "writing-mode" text attribute on its text container.
            HTML Specification blockquote
            [wai-aria-1.2] blockquote role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification body
            [wai-aria-1.2] generic role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments User agents MUST ignore the aria-hidden attribute if specified on the body element.
            HTML Specification br
            [wai-aria-1.2] No corresponding role
            Computed Role

            Not mapped
            MSAA + IAccessible2

            Not mapped
            UIA

            Not mapped
            [ATK]

            Not mapped
            AX

            Not mapped
            Comments May be exposed as '\n' character by the platform interface.
            HTML Specification button
            [wai-aria-1.2] button role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments A button's mapping will change if the aria-pressed or aria-haspopup attributes are specified.
            HTML Specification canvas
            [wai-aria-1.2] No corresponding role
            Computed Role

            html-canvas
            MSAA + IAccessible2

            Roles: ROLE_SYSTEM_GRAPHIC; IA2_ROLE_CANVAS
            UIA

            Control Type: Image

            Descendants of the canvas element are mapped separately.
            [ATK]

            Role: ATK_ROLE_CANVAS
            AX

            AXRole: AXGroup

            AXSubrole: (nil)

            AXRoleDescription: ""
            Comments
            HTML Specification caption
            [wai-aria-1.2] caption role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping

            Relations: IA2_RELATION_LABEL_FOR with parent table

            UIA

            Use WAI-ARIA mapping

            Other properties: The LabeledBy property for the parent table element points to the UIA element for the caption element.

            [ATK]

            Use WAI-ARIA mapping

            Relations: ATK_RELATION_LABEL_FOR with parent table

            AX

            Use WAI-ARIA mapping

            Relations: ATK_RELATION_LABEL_FOR with parent table

            Comments

            Note

            If a caption element is hidden from the accessibility tree, then it will not provide an accessible name to its parent table element.
            HTML Specification cite
            [wai-aria-1.2] No corresponding role
            Computed Role

            html-cite
            MSAA + IAccessible2

            No accessible object. Styles used are mapped into text attributes on its text container.
            UIA

            No accessible object. Styles used are exposed by UIA text attributes of the TextRange Control Pattern implemented on a parent accessible object.
            [ATK]

            No accessible object. Styles used are mapped into text attributes on its text container.
            AX

            AXRole: AXGroup

            AXSubrole: (nil)

            AXRoleDescription: "group"
            Comments
            HTML Specification code
            [wai-aria-1.2] code role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification col
            [wai-aria-1.2] No corresponding role
            Computed Role

            Not mapped
            MSAA + IAccessible2

            Not mapped
            UIA

            Not mapped
            [ATK]

            Not mapped
            AX

            Not mapped
            Comments
            HTML Specification colgroup
            [wai-aria-1.2] No corresponding role
            Computed Role

            Not mapped
            MSAA + IAccessible2

            Role: ROLE_SYSTEM_GROUPING
            UIA

            Control Type: Group

            Localized Control Type: "colgroup"
            [ATK]

            Not mapped
            AX

            Not mapped
            Comments
            HTML Specification data
            [wai-aria-1.2] generic role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification datalist (represents pre-defined options for input element)
            [wai-aria-1.2] listbox role, with the aria-multiselectable property set to "true" if the datalist's selection model allows multiple option elements to be selected at a time, and "false" otherwise
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments If datalist is not linked to a proper input element, then datalist element is not mapped to accessibility APIs.
            HTML Specification dd
            [wai-aria-1.2] definition role
            Computed Role

            Use WAI-ARIA mapping

            Note

            Editorial Note: This value may change upon resolution of ARIA #1662.
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification del
            [wai-aria-1.2] deletion role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification details
            [wai-aria-1.2] group role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping

            Localized Control Type: "details"

            [ATK]

            Use WAI-ARIA mapping

            Relations: "ATK_RELATION_DETAILS_FOR"

            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification dfn
            [wai-aria-1.2] term role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification dialog
            [wai-aria-1.2] dialog role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments See also the dialog element's open attribute.
            HTML Specification dir
            [wai-aria-1.2] list role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            ATK

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments The dir element is marked as obsolete in HTML, and is not to be used by authors.
            HTML Specification div
            [wai-aria-1.2] generic role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification dl
            [wai-aria-1.2] list role
            Computed Role

            list

            Note

            Editorial Note: This value may change upon resolution of ARIA #1662.
            MSAA + IAccessible2

            Role: ROLE_SYSTEM_LIST

            States: STATE_SYSTEM_READONLY
            UIA

            Control Type: List
            [ATK]

            Role: ATK_ROLE_DESCRIPTION_LIST
            AX

            AXRole: AXList

            AXSubrole: AXDefinitionList

            AXRoleDescription: "definition list"
            Comments
            HTML Specification dt
            [wai-aria-1.2] term role
            Computed Role

            Use WAI-ARIA mapping

            Note

            Editorial Note: This value may change upon resolution of ARIA #1662.
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification em
            [wai-aria-1.2] emphasis role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification embed
            [wai-aria-1.2] No corresponding role
            Computed Role

            html-embed
            MSAA + IAccessible2

            Roles: ROLE_SYSTEM_CLIENT; IA2_ROLE_EMBEDDED_OBJECT

            States: STATE_SYSTEM_UNAVAILABLE for windowless plugin
            UIA

            Control Type: Pane
            [ATK]

            Role: ATK_ROLE_EMBEDDED
            AX Depends on format of data file
            Comments
            HTML Specification fieldset
            [wai-aria-1.2] group role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Role: Use WAI-ARIA mapping

            Relations: IA2_RELATION_LABELLED_BY with the first instance of a rendered child legend element
            UIA

            Role: Use WAI-ARIA mapping

            [ATK]

            Role: Use WAI-ARIA mapping

            Relations: ATK_RELATION_LABELLED_BY with first instance of a rendered child legend element
            AX

            Role: Use WAI-ARIA mapping

            AXSubrole: AXFieldset

            AXDescription: value from the first instance of a rendered child legend element
            Comments

            Note

            If a legend element is hidden from the accessibility tree, then it will not provide an accessible name to its parent fieldset element.
            HTML Specification figcaption
            [wai-aria-1.2] caption role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Role: Use WAI-ARIA mapping
            UIA

            Role: Use WAI-ARIA mapping
            [ATK]

            Role: Use WAI-ARIA mapping
            AX

            Role: Use WAI-ARIA mapping
            Comments
            HTML Specification figure
            [wai-aria-1.2] figure role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Role: Use WAI-ARIA mapping
            UIA

            Role: Use WAI-ARIA mapping
            [ATK]

            Role: Use WAI-ARIA mapping
            AX

            AXRole: Use WAI-ARIA mapping
            Comments
            HTML Specification footer (scoped to the body element)
            [wai-aria-1.2] contentinfo role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification footer (scoped to the main element, or a sectioning content element)
            [wai-aria-1.2] sectionfooter role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Control Type: Group

            Localized Control Type: "footer"
            [ATK]

            Role: ATK_ROLE_FOOTER
            AX

            Use WAI-ARIA mapping
            Comments User agents and assistive technology MAY not expose the sectionfooter role if the element:
            HTML Specification form
            [wai-aria-1.2] form role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping

            If a form has no accessible name:

            Role: ATK_ROLE_FORM
            AX

            Use WAI-ARIA mapping
            Comments If a form has no accessible name, do not expose the element as a landmark.
            HTML Specification form-associated custom element
            [wai-aria-1.2] If the author assigned a conforming ARIA role using the role attribute, map to that role. Otherwise, the generic role.
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification h1, h2, h3, h4, h5, and h6
            [wai-aria-1.2] heading role, with the aria-level property set to the number in the element's tag name.
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification head
            [wai-aria-1.2] No corresponding role
            Computed Role

            Not Mapped
            MSAA + IAccessible2

            Not mapped
            UIA

            Not mapped
            [ATK]

            Not mapped
            AX

            Not mapped
            Comments
            HTML Specification header (scoped to the body element)
            [wai-aria-1.2] banner role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification header (scoped to the main element, or a sectioning content element)
            [wai-aria-1.2] sectionheader role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Control Type: Group

            Localized Control Type: "header"
            [ATK]

            Role: ATK_ROLE_HEADER
            AX

            Use WAI-ARIA mapping
            Comments User agents and assistive technology MAY not expose the sectionheader role if the element:
            HTML Specification hgroup
            [wai-aria-1.2] group role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments If an hgroup contains multiple heading elements, then the user agent MAY treat the heading element with the highest priority level as the sole heading of the hgroup. The user agent MAY expose all other heading elements as if they were p elements. See paragraph role on Core AAM.
            HTML Specification hr
            [wai-aria-1.2] separator role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments

            If an hr element is a descendant of a select element, user agents MAY expose the element with a role of none.
            HTML Specification html
            [wai-aria-1.2] generic role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments

            User agents MUST ignore the aria-hidden attribute if specified on the html element.

            Note

            The document role of a web page is not exposed by the html element, but rather from a parent document node created by the user agent.
            HTML Specification i
            [wai-aria-1.2] generic role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments Exposed by platform specific italic text styles.
            HTML Specification iframe
            [wai-aria-1.2] No corresponding role
            Computed Role

            html-iframe
            MSAA + IAccessible2

            Role: IA2_ROLE_INTERNAL_FRAME
            UIA

            Control Type: Pane
            [ATK]

            Role: ATK_ROLE_INTERNAL_FRAME
            AX

            Not mapped
            Comments
            HTML Specification img
            [wai-aria-1.2] image or img role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments

            Note

            ARIA 1.3 adds the image role as the preferred synonym to the ARIA 1.0 img role. The expected computed role for named img elements is now "image".
            HTML Specification img (alt attribute value, when trimmed of whitespace, is the empty string, i.e., alt="", alt=" ", or alt with no value in the markup)
            [wai-aria-1.2]
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments

            Note

            If an img has an empty alt, but has been provided an accessible name via another valid naming mechanism per the naming steps of this specification, user agents will expose the element with its implicit image role.

            HTML Specification input (type attribute in the Button state)
            [wai-aria-1.2] button role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification input (type attribute in the Checkbox state)
            [wai-aria-1.2] checkbox role, with the aria-checked state set to "mixed" if the element's indeterminate IDL attribute is true, or "true" if the element's checkedness is true, or "false" otherwise
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification input (type attribute in the Color state)
            [wai-aria-1.2] No corresponding role
            Computed Role

            html-input-color
            MSAA + IAccessible2

            If implemented as a textbox:

            Roles: ROLE_SYSTEM_TEXT

            If implemented as a color picker:

            Roles: IA2_ROLE_COLOR_CHOOSER
            UIA

            If implemented as a textbox:

            Control Type: Edit

            Localized Control Type: "edit"

            If implemented as a color picker:

            Control Type: button

            Localized Control Type: "color picker"
            [ATK]

            If implemented as a button, use WAI-ARIA mapping for button.

            If implemented as a textbox, use WAI-ARIA mapping for textbox.
            AX

            If implemented as a textbox:

            AXRole: AXTextField

            AXSubrole: (nil)

            AXRoleDescription: "text field"

            If implemented as a color picker:

            AXRole: AXColorWell

            AXSubrole: (nil)

            AXRoleDescription: "color well"
            Comments

            If implemented as a color picker, any UI controls presented for selecting a color are exposed in the accessibility tree, associated with the input element, and mapped as appropriate for the type of control (e.g., button or slider).

            HTML Specification input (type attribute in the Date state)
            [wai-aria-1.2] No corresponding role
            Computed Role

            html-input-date
            MSAA + IAccessible2

            If implemented as a textbox:

            Role: ROLE_SYSTEM_TEXT

            Object attributes: text-input-type:date

            If implemented as a date picker:

            Role: IA2_ROLE_DATE_EDITOR
            UIA

            Depends on UI design of implementation. The UI in Windows 10 Edge, for example, is a composite of multiple spinners.
            [ATK]

            Role: ATK_ROLE_CALENDAR
            AX

            AXRole: AXDateField

            AXSubrole: (nil)

            AXRoleDescription: "date field"
            Comments
            HTML Specification input (type attribute in the Local Date and Time state)
            [wai-aria-1.2] No corresponding role
            Computed Role

            html-input-datetime-local
            MSAA + IAccessible2

            Role: IA2_ROLE_DATE_EDITOR
            UIA

            Depends on UI design of implementation. The UI in Windows 10 Edge, for Example, is a composite of multiple spinners.
            [ATK]

            Role: ATK_ROLE_CALENDAR
            AX

            AXRole: AXTextField

            AXSubrole: (nil)

            AXRoleDescription: "text field"
            Comments
            HTML Specification input (type attribute in the E-mail state with no suggestions source element)
            [wai-aria-1.2] textbox role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping

            Object attributes: text-input-type:email
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification input (type attribute in the File Upload state)
            [wai-aria-1.2] No corresponding role
            Computed Role

            html-input-file
            MSAA + IAccessible2

            Implementation dependent. If represented by a container with a button a text label inside then:

            Roles: IA2_ROLE_TEXT_FRAME

            Children: ROLE_SYSTEM_PUSHBUTTON and IA2_ROLE_LABEL for a button and a text label elements.
            UIA

            Can be rendered as a single button control, or as a button control with a text input field.

            Button control:

            Control Type: Button

            Text input field:

            Control Type: Edit

            Localized Control Type: "file"
            [ATK]

            Role: ATK_ROLE_STATIC

            Children: ATK_ROLE_PUSH_BUTTON when pressed ATK_ROLE_FILE_CHOOSER dialog shown

            AX

            AXRole: AXButton

            AXSubrole: AXFileUploadButton

            AXRoleDescription: file upload button
            Comments
            HTML Specification input (type attribute in the Hidden state)
            [wai-aria-1.2] No corresponding role
            Computed Role

            Not mapped
            MSAA + IAccessible2

            Not mapped
            UIA

            Not mapped
            [ATK]

            Not mapped
            AX

            Not mapped
            Comments
            HTML Specification input (type attribute in the Image Button state)
            [wai-aria-1.2] button role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification input (type attribute in the Month state)
            [wai-aria-1.2] No corresponding role
            Computed Role

            html-input-month
            MSAA + IAccessible2

            Role: IA2_ROLE_DATE_EDITOR
            UIA

            Depends on UI design of implementation. The UI in Windows 10 Edge, for Example, is a composite of multiple spinners.
            [ATK]

            Role: ATK_ROLE_DATE_EDITOR
            AX

            AXRole: AXTextField

            AXSubrole: (nil)

            AXRoleDescription: "text field"
            Comments
            HTML Specification input (type attribute in the Number state)
            [wai-aria-1.2] spinbutton role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            If implemented as a spin button, use WAI-ARIA mapping for spinbutton.

            If implemented as a text input, use WAI-ARIA mapping for textbox.

            Object attributes: text-input-type:number
            UIA

            Use WAI-ARIA mapping
            [ATK]

            If implemented as a spin button, use WAI-ARIA mapping for spinbutton.

            If implemented as a text input, use WAI-ARIA mapping for textbox.

            Object attributes: text-input-type:number
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification input (type attribute in the Password state)
            [wai-aria-1.2] No corresponding role
            Computed Role

            html-input-password
            MSAA + IAccessible2

            Role: ROLE_SYSTEM_TEXT

            States: STATE_SYSTEM_PROTECTED; IA2_STATE_SINGLE_LINE; STATE_SYSTEM_READONLY if readonly, otherwise IA2_STATE_EDITABLE
            UIA

            Control Type: Edit

            Other properties: isPassword=true
            [ATK]

            Role: ATK_ROLE_PASSWORD_TEXT

            States: ATK_STATE_SINGLE_LINE; ATK_STATE_READ_ONLY if readonly, otherwise ATK_STATE_EDITABLE
            AX

            AXRole: AXTextField

            AXSubrole: AXSecureTextField

            AXRoleDescription: "secure text field"
            Comments
            HTML Specification input (type attribute in the Radio Button state)
            [wai-aria-1.2] radio role, with the aria-checked state set to "true" if the element's checkedness is true, or "false" otherwise. With aria-setsize value reflecting number of type=radio input elements within the radio button group and aria-posinset value reflecting the elements position within the radio button group.
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification input (type attribute in the Range state)
            [wai-aria-1.2] slider role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification input (type attribute in the Reset Button state)
            [wai-aria-1.2] button role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification input (type attribute in the Search state with no suggestions source element)
            [wai-aria-1.2] searchbox role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification input (type attribute in the Submit Button state)
            [wai-aria-1.2] button role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification input (type attribute in the Telephone state with no suggestions source element)
            [wai-aria-1.2] textbox role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping

            Object attributes: text-input-type:telephone
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification input (type attribute in the Text state with no suggestions source element)
            [wai-aria-1.2] textbox role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification input (type attribute in the Text, Search, Telephone, URL, or E-mail states with a suggestions source element)
            [wai-aria-1.2] combobox role, with the aria-controls property set to the same value as the list attribute
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping

            Object attributes: text-input-type:as per input type
            UIA

            Use WAI-ARIA mapping

            Other properties: ControllerFor points to the suggestions source element
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification input (type attribute in the Time state)
            [wai-aria-1.2] No corresponding role
            Computed Role

            html-input-time
            MSAA + IAccessible2

            Role: ROLE_SYSTEM_SPINBUTTON if implemented as a simple widget; ROLE_SYSTEM_GROUPING with child controls mapped as appropriate if implemented as a complex widget

            Object attributes: text-input-type:time
            UIA

            Depends on UI design of implementation. The UI in Windows 10 Edge, for Example, is a composite of multiple spinners.
            [ATK]

            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.

            AX

            AXRole: AXTimeField

            AXSubrole: (nil)

            AXRoleDescription: "time field"
            Comments
            HTML Specification input (type attribute in the URL state with no suggestions source element)
            [wai-aria-1.2] textbox role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping

            Object attributes: text-input-type:url
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification input (type attribute in the Week state)
            [wai-aria-1.2] No corresponding role
            Computed Role

            html-input-week
            MSAA + IAccessible2

            Role: IA2_ROLE_DATE_EDITOR

            Object attributes: text-input-type:week
            UIA

            Depends on UI design of implementation. The UI in Windows 10 Edge, for Example, is a composite of multiple spinners.
            [ATK]

            Role: ATK_ROLE_CALENDAR
            AX

            AXRole: AXTextField

            AXSubrole: (nil)

            AXRoleDescription: "text field"
            Comments
            HTML Specification ins
            [wai-aria-1.2] insertion role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification kbd
            [wai-aria-1.2] No corresponding role
            Computed Role

            html-kbd
            MSAA + IAccessible2

            No accessible object.

            Text attributes: font-family:monospace on the text container
            UIA

            No accessible object. Styles used are exposed by UIA text attribute identifiers of the TextRange Control Pattern implemented on a parent accessible object.
            [ATK]

            No accessible object. Mapped into "font-family:monospace" text attribute on its text container.
            AX

            AXRole: AXGroup

            AXSubrole: (nil)

            AXRoleDescription: "group"
            Comments
            HTML Specification label
            [wai-aria-1.2] No corresponding role
            Computed Role

            html-label
            MSAA + IAccessible2

            Roles: ROLE_SYSTEM_STATICTEXT; IA2_ROLE_LABEL

            Relations: IA2_RELATION_LABEL_FOR with a labelable element that is child to the label or referred to by the label element's for attribute. The associated labelable element has IA2_RELATION_LABELLED_BY pointing to the label.

            UIA

            Control Type: Group

            Relations:

            When the label element contains a labelable element, the LabeledBy property for the element points to the UIA element for the label element.

            When the label element has a for attribute referencing a labelable element, the LabeledBy property for the referenced element points to the UIA element for the label element.

            [ATK]

            Role: ATK_ROLE_LABEL

            Relations: ATK_RELATION_LABEL_FOR for a child labelable element or labelable element referred by for attribute. Note, related labelable element provides ATK_RELATION_LABELLED_BY pointing to the label.

            AX

            AXRole: AXGroup

            AXSubrole: (nil)

            AXRoleDescription: "group"
            Comments

            Note

            If a label element is hidden from the accessibility tree, then it will not provide an accessible name to the labelable element it is associated with.

            HTML Specification legend
            [wai-aria-1.2] No corresponding role
            Computed Role

            html-legend
            MSAA + IAccessible2

            Roles: ROLE_SYSTEM_STATICTEXT; IA2_ROLE_LABEL

            Relations: IA2_RELATION_LABEL_FOR with the parent fieldset
            UIA

            Control Type: Text

            Other properties: The LabeledBy property for the parent fieldset points to the UIA element for the legend element.

            [ATK]

            Role: ATK_ROLE_LABEL

            Relations: ATK_RELATION_LABEL_FOR with parent fieldset element

            AX

            AXRole: AXGroup

            AXSubrole: (nil)

            AXRoleDescription: "group"
            Comments
            HTML Specification li
            [wai-aria-1.2] listitem role with aria-setsize value reflecting number of li elements within the parent ol, menu or ul and aria-posinset value reflecting the li elements position within the set.
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments If li element is not an accessibility child of an ol , menu or ul, or if the containing list element is no longer exposed with a list role, then expose the li element with a generic role.
            HTML Specification link
            [wai-aria-1.2] No corresponding role
            Computed Role

            Not mapped
            MSAA + IAccessible2

            Not mapped
            UIA

            Not mapped
            [ATK]

            Not mapped
            AX

            Not mapped
            Comments
            HTML Specification main
            [wai-aria-1.2] main role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification map
            [wai-aria-1.2] No corresponding role
            Computed Role

            html-map
            MSAA + IAccessible2

            Not mapped if used as an image map. Otherwise,

            Role: IA2_ROLE_TEXT_FRAME
            UIA

            Not mapped
            [ATK]

            Not mapped if used as an image map, otherwise:

            Role: ATK_ROLE_STATIC
            AX

            Role: AXImageMap if used as an image map. Otherwise,
            Role: AXGroup if associated with an img with no alt. Otherwise,
            not mapped if not associated with an img.

            Comments
            HTML Specification mark
            [wai-aria-1.2] mark role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification math
            [wai-aria-1.2] See comments
            Computed Role

            See comments
            MSAA + IAccessible2 See comments
            UIA See comments
            [ATK] See comments
            AX See comments
            Comments Mapping for math is defined by MathML AAM 1.0.
            HTML Specification meta
            [wai-aria-1.2] No corresponding role
            Computed Role

            Not mapped
            MSAA + IAccessible2

            Not mapped
            UIA

            Not mapped
            [ATK]

            Not mapped
            AX

            Not mapped
            Comments
            HTML Specification meter
            [wai-aria-1.2] meter role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification nav
            [wai-aria-1.2] navigation role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification noscript
            [wai-aria-1.2] No corresponding role
            Computed Role

            Not mapped
            MSAA + IAccessible2

            Not mapped
            UIA

            Not mapped
            [ATK]

            Not mapped
            AX

            Not mapped
            Comments
            HTML Specification object
            [wai-aria-1.2] No corresponding role
            Computed Role

            html-object
            MSAA + IAccessible2

            Depends on format of data file. If it contains a plugin then,

            Role: IA2_ROLE_EMBEDDED_OBJECT

            States: STATE_SYSTEM_UNAVAILABLE for windowless plugin

            UIA

            Depends on format of data file.
            [ATK]

            Depends on format of data file. If contains a plugin then

            Role: ATK_ROLE_EMBEDDED

            AX Depends on format of data file.
            Comments
            HTML Specification ol
            [wai-aria-1.2] list role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification optgroup
            [wai-aria-1.2] group role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification option (in a list of options or represents a suggestion in a datalist)
            [wai-aria-1.2] option role, with the aria-selected state set to "true" if the element's selectedness is true, or "false" otherwise.
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification output
            [wai-aria-1.2] status role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping

            Relations: IA2_RELATION_LABELLED_BY with associated label element
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping

            Relations: ATK_RELATION_LABELLED_BY with associated label element
            AX

            Use WAI-ARIA mapping
            Comments AXDescription: value from associated label element subtree.
            undefined
            HTML Specification p
            [wai-aria-1.2] paragraph role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification param
            [wai-aria-1.2] No corresponding role
            Computed Role

            Not mapped
            MSAA + IAccessible2

            Not mapped
            UIA

            Not mapped
            [ATK]

            Not mapped
            AX

            Not mapped
            Comments param is obsolete in HTML
            HTML Specification picture
            [wai-aria-1.2] No corresponding role
            Computed Role

            Not mapped
            MSAA + IAccessible2

            Not mapped
            UIA

            Not mapped
            [ATK]

            Not mapped
            AX

            Not mapped
            Comments
            HTML Specification pre
            [wai-aria-1.2] generic role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification progress
            [wai-aria-1.2] progressbar role, with, if the progress bar is determinate, the aria-valuemax property set to the maximum value of the progress bar, the aria-valuemin property set to zero, and the aria-valuenow property set to the current value of the progress bar
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification q
            [wai-aria-1.2] generic role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments ::before and ::after CSS pseudo content is used by platforms to render the element's quotation marks.
            HTML Specification rp
            [wai-aria-1.2] No corresponding role
            Computed Role

            html-rp
            MSAA + IAccessible2

            No accessible object. No child elements are exposed if ruby is supported by the browser.

            UIA

            No accessible object.
            [ATK]

            No accessible object. No child elements are exposed if ruby is supported by the browser.
            AX Not mapped
            Comments
            HTML Specification rt
            [wai-aria-1.2] No corresponding role
            Computed Role

            html-rt
            MSAA + IAccessible2

            No accessible object. No child elements are exposed if ruby is supported by the browser.

            UIA

            No accessible object.
            [ATK]

            No accessible object.
            AX

            AXRole: AXGroup

            AXSubrole: AXRubyText

            AXRoleDescription: "group"
            Comments
            HTML Specification ruby
            [wai-aria-1.2] No corresponding role
            Computed Role

            html-ruby
            MSAA + IAccessible2

            Role: ROLE_SYSTEM_TEXT; IA2_ROLE_TEXT_FRAME
            UIA

            Control Type: Text

            Localized Control Type: "ruby"
            [ATK]

            Role: ATK_ROLE_STATIC
            AX

            AXRole: AXGroup

            AXSubrole: AXRubyInline

            AXRoleDescription: "group"
            Comments
            HTML Specification s
            [wai-aria-1.2] deletion role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification samp
            [wai-aria-1.2] generic role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification script
            [wai-aria-1.2] No corresponding role
            Computed Role

            Not mapped
            MSAA + IAccessible2

            Not mapped
            UIA

            Not mapped
            [ATK]

            Not mapped
            AX

            Not mapped
            Comments
            HTML Specification search
            [wai-aria-1.2] search role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification section
            [wai-aria-1.2] region role if the section element has an accessible name. Otherwise, the generic role.
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification select (rendered as a list box)
            [wai-aria-1.2] listbox role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification select (rendered as a drop-down box)
            [wai-aria-1.2] combobox role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification slot
            [wai-aria-1.2] No corresponding role
            Computed Role

            Not mapped
            MSAA + IAccessible2

            Not mapped
            UIA

            Not mapped
            [ATK]

            Not mapped
            AX

            Not mapped
            Comments
            HTML Specification small
            [wai-aria-1.2] generic role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments Exposed by platform specific font size styles.
            HTML Specification source
            [wai-aria-1.2] No corresponding role
            Computed Role

            Not mapped
            MSAA + IAccessible2

            Not mapped
            UIA

            Not mapped
            [ATK]

            Not mapped
            AX

            Not mapped
            Comments
            HTML Specification span
            [wai-aria-1.2] generic role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification strong
            [wai-aria-1.2] strong role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification style
            [wai-aria-1.2] No corresponding role
            Computed Role

            Not mapped
            MSAA + IAccessible2

            Not mapped
            UIA

            Not mapped
            [ATK]

            Not mapped
            AX

            Not mapped
            Comments

            Note: There are instances where CSS properties can affect what is exposed by accessibility APIs. For instance, display: none or visibility: hidden will remove an element from the accessibility tree and hide its presence from assistive technologies.

            HTML Specification sub
            [wai-aria-1.2] subscript role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification summary
            [wai-aria-1.2] No corresponding role
            Computed Role

            If the element is the first child of its type within a parent details element: html-summary

            Otherwise, if it is not the first child of its type of a parent details element, or it is not a child of a details element: generic role

            MSAA + IAccessible2

            Role: ROLE_SYSTEM_PUSHBUTTON

            States: STATE_SYSTEM_EXPANDED / STATE_SYSTEM_COLLAPSED

            Actions: expand / collapse
            UIA

            Control Type: Button

            Control Pattern: ExpandCollapse
            [ATK]

            Role: ROLE_TOGGLE_BUTTON

            Relations: ATK_RELATION_DETAILS
            AX

            AXRole: AXDisclosureTriangle

            AXSubrole: (nil)

            AXRoleDescription: "disclosure triangle"
            Comments If a summary element is not a child of a details element, or it is not the first summary element of a parent details, then user agents MUST expose the summary element with a generic role (see HTML summary element).
            HTML Specification sup
            [wai-aria-1.2] superscript role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification svg
            [wai-aria-1.2] See comments
            Computed Role

            See comments
            MSAA + IAccessible2 See comments
            UIA See comments
            [ATK] See comments
            AX See comments
            Comments Mapping for svg is defined by SVG Accessibility API Mappings. See also Graphics Accessibility API Role Mappings
            HTML Specification table
            [wai-aria-1.2] table role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping

            Relations: IA2_RELATION_LABELLED_BY with first instance of a rendered child caption element
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping

            Relations: ATK_RELATION_LABELLED_BY with first instance of a rendered child caption element
            AX

            Use WAI-ARIA mapping

            AXDescription: value from the first instance of a rendered child caption element
            Comments
            HTML Specification tbody
            [wai-aria-1.2] rowgroup role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2 Use WAI-ARIA mapping
            UIA Use WAI-ARIA mapping
            [ATK] Use WAI-ARIA mapping
            AX Use WAI-ARIA mapping
            Comments
            HTML Specification td (ancestor table element has table role)
            [wai-aria-1.2] cell role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification td (ancestor table element has grid or treegrid role)
            [wai-aria-1.2] gridcell role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification template
            [wai-aria-1.2] No corresponding role
            Computed Role

            Not mapped
            MSAA + IAccessible2

            Not mapped
            UIA

            Not mapped
            [ATK]

            Not mapped
            AX

            Not mapped
            Comments
            HTML Specification textarea
            [wai-aria-1.2] textbox role, with the aria-multiline property set to "true"
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification tfoot
            [wai-aria-1.2] rowgroup role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification th (is not a column header, row header, column group header or row group header, and ancestor table element has table role)
            [wai-aria-1.2] cell role
            Computed Role

            Use WAI-ARIA mapping
            MSAA + IAccessible2

            Use WAI-ARIA mapping
            UIA

            Use WAI-ARIA mapping
            [ATK]

            Use WAI-ARIA mapping
            AX

            Use WAI-ARIA mapping
            Comments
            HTML Specification th (is not a "https:/

            Read the original on w3.org ↗