ARIA in HTML

<!DOCTYPE html> <html lang="en-US"> <head> <meta charset="utf-8"> <title>ARIA in HTML</title> <script src="https://www.w3.org/Tools/respec/respec-w3c" class="remove" defer></script> <script class="remove"> var respecConfig = { editors: [ { name: "Steve Faulkner", company: "TPGi", companyURL: "https://www.tpgi.com/", w3cid: "35007", retiredDate: "2023-04-28" }, { name: "Scott O'Hara", company: "Microsoft", companyURL: "https://www.microsoft.com/", w3cid: "103856" }, { name: "Patrick H. Lauke", company: "TetraLogical", companyURL: "https://tetralogical.com/", w3cid: '35129' }, ], previousMaturity: "REC", perEnd: "2022-09-01", previousPublishDate: "2021-12-09", implementationReportURI: "https://w3c.github.io/html-aria/results/implementation-results.html", github: "w3c/html-aria/", maxTocLevel: 2, shortName: "html-aria", specStatus: "ED", revisionTypes: ["addition", "correction"], group: "webapps", wgPublicList: "public-webapps", xref: true, errata: "https://github.com/w3c/html-aria/issues/new/", }; </script> <link rel="stylesheet" href="makeup.css"> </head> <body data-cite="HTML WAI-ARIA INFRA"> <section id="abstract"> This specification defines the authoring rules (author conformance requirements) for the use of [[[wai-aria-1.2]]] and [[[dpub-aria-1.0]]] attributes on [[HTML]] elements. This specification's primary objective is to define requirements for use with conformance checking tools used by authors (i.e., web developers). These requirements will aid authors in their development of web content, including custom interfaces and widgets, which make use of ARIA to complement or extend the features of the host language [[HTML]]. </section> <section id="sotd" class="updateable-rec"> ARIA in HTML is an [[HTML]] specification module. Any HTML features, conformance requirements, or terms that this specification module makes reference to, but does not explicitly define, are defined by the [[HTML|HTML Standard]]. Since this specification become a W3C Recommendation on 09 December 2021, the following substantive additions and/or corrections have been proposed: <ul> <li> <a href="https://github.com/w3c/html-aria/pull/489">4 October 2023 - Addition:</a> Update the button element and input type=button,image,reset,submit elements to allow the `separator` role. </li> <li> <a href="https://github.com/w3c/html-aria/pull/453">3 October 2023 - Correction:</a> Update the <a href="#el-img">`img`</a> element allowances to be based on if the element has an accessible name or not. </li> <li> <a href="https://github.com/w3c/html-aria/pull/462">21 August 2023 - Addition:</a> Update the <a href="#el-address">`address`</a> and <a href="#el-hgroup">`hgroup`</a> element allowances per their updated mapping to the `group` role. </li> <li> <a href="https://github.com/w3c/html-aria/pull/455">9 July 2023 - Addition:</a> Update the <a href="#el-aside">`aside`</a> element to allow the dpub `doc-glossary` role. </li> <li> <a href="https://github.com/w3c/html-aria/pull/446">5 July 2023 - Addition:</a> Update the <a href="#el-button">`button`</a>, <a href="#el-input-button">`input type=button`</a>, <a href="#el-input-image">`input type=image`</a> <a href="#el-input-reset">`input type=reset`</a>, and <a href="#el-input-submit">`input type=submit`</a> elements to align their allowed roles. </li> <li> <a href="https://github.com/w3c/html-aria/pull/469">29 June 2023 - Addition:</a> Update the <a href="#el-s">`s`</a> element allowed roles to indicate use of `role=deletion` on the element would be considered redundnat. </li> <li> <a href="https://github.com/w3c/html-aria/pull/435">31 May 2023 - Correction:</a> Conditionally revise allowed `aria-*` attributes and roles on <a href="#el-summary">`summary`</a> element. </li> <li> <a href="https://github.com/w3c/html-aria/pull/410">31 May 2023 - Correction:</a> Update <a href="#el-li">`li`</a> element role allowances in context to the element's ancestral relationship, or lack of, to a list element parent. </li> <li> <a href="https://github.com/w3c/html-aria/pull/401">24 March 2023 - Addition:</a> The <a href="#el-search">`search`</a> element has been added. </li> <li> <a href="https://github.com/w3c/html-aria/pull/447">6 March 2023 - Addition:</a> Disallow `aria-hidden=true` on the `body` element. </li> <li> <a href="https://github.com/w3c/html-aria/pull/415">13 February 2023 - Addition:</a> Update `figure` element role allowances to include `doc-example`. </li> <li> <a href="https://github.com/w3c/html-aria/pull/437">07 November 2022 - Correction:</a> Revisions to 'any role' term description. </li> <li> <a href="https://github.com/w3c/html-aria/pull/383">14 July 2022 - Correction:</a> Disallow roles and `aria-*` attributes on the <a href="#el-datalist">`datalist`</a> element. </li> <li> <a href="https://github.com/w3c/html-aria/pull/372">16 April 2022 - Correction:</a> <a href="#att-checked">`aria-checked`</a> is not to be used on elements that support the `checked` attribute. </li> <li> <a href="https://github.com/w3c/html-aria/pull/402">03 April 2022 - Addition:</a> Identify <a href="#dfn-naming-prohibited">Naming Prohibited</a> elements. </li> <li> <a href="https://github.com/w3c/html-aria/pull/404">06 March 2022 - Addition:</a> Allow `none` and `presentation` roles on <a href="#el-nav">`nav` element</a>. </li> <li> <a href="https://github.com/w3c/html-aria/pull/403">03 March 2022 - Addition:</a> Restrict role allowances for <a href="#el-div">`div` element</a> when it is a child of a `dl` element. </li> <li> <a href="https://github.com/w3c/html-aria/pull/396">12 February 2022 - Addition & Correction:</a> Allow `combobox` role on <a href="#el-button">`button` element</a>. Allow `combobox` and `checkbox` roles on <a href="#el-input-button">`input type=button` element</a>. </li> <li> <a href="https://github.com/w3c/html-aria/pull/391">18 January 2022 - Addition:</a> Added <a href="#docconformance-deprecated">Requirements for deprecated ARIA role, state and property attributes</a>. </li> <li> <a href="https://github.com/w3c/html-aria/pull/369">06 January 2022 - Addition:</a> Change allowances for `doc-biblioentry` and `doc-endnote` roles on the <a href="#el-li">`li` element</a>. These roles are deprecated in [[[dpub-aria-1.1]]]. </li> <li> <a href="https://github.com/w3c/html-aria/pull/381">13 December 2021 - Correction:</a> Allow `radio` role on <a href="#el-img">`img alt="some text"` element</a>. </li> <li> <a href="https://github.com/w3c/html-aria/pull/353">07 December 2021 - Correction:</a> Allow only `none` and `presentation` roles for <a href="#el-wbr">`wbr` element</a>. Allow only `aria-hidden` global attribute for <a href="#el-br">`br`</a> and <a href="#el-wbr">`wbr`</a> elements. </li> <li> <a href="https://github.com/w3c/html-aria/pull/367">02 December 2021 - Addition:</a> Allow `group` role on <a href="#el-section">`section` element</a>. </li> <li> <a href="https://github.com/w3c/html-aria/pull/360">16 November 2021 - Addition:</a> Allow `link` and `button` roles on <a href="#el-area-no-href">`area` without `href` element</a>. </li> <li> <a href="https://github.com/w3c/html-aria/pull/352">26 October 2021 - Addition:</a> Allow `aria-hidden` attribute on the <a href="#el-picture">`picture` element</a>. </li> </ul> Reviewers of the document can identify candidate additions and/or corrections by their distinctive styling in the document: Candidate corrections are marked in the document. Candidate additions are marked in the document. </section> <section> <h2 id="rules-wd"> Author requirements for use of ARIA in HTML </h2> Authors MAY use the ARIA `role` and `aria-*` attributes to change the exposed meaning (<a data-cite="html/dom.html#semantics-2">semantics</a>) of [=HTML elements=], in accordance with the requirements defined by [[wai-aria-1.2|WAI-ARIA]], except where ARIA features conflict with the <dfn data-cite="wai-aria-1.2#host_general_conflict">strong native semantics</dfn> or are equal to the <dfn data-cite="wai-aria-1.2#implicit_semantics">implicit ARIA semantics</dfn> of a given HTML element. The <a>implicit ARIA semantics</a> for the features of HTML are defined by the [[html-aam-1.0|HTML Accessibility API Mappings]] specification. Any constraints for the use of ARIA features in HTML defined by this specification are intended to prevent authors from making assistive technology products report nonsensical user interface (UI) information that does not represent the actual UI of the document. Authors MUST NOT use the ARIA `role` and `aria-*` attributes in a manner that conflicts with the semantics described in the [[[#docconformance]]] and [[[#docconformance-attr]]] tables. It is NOT RECOMMENDED for authors to set the ARIA `role` and `aria-*` attributes to values that match the <a>implicit ARIA semantics</a> defined in either table. Doing so is unnecessary and can potentially lead to unintended consequences. </section> <section class="informative"> <h2>ARIA semantics that extend and diverge from HTML</h2> Through the use of ARIA, authors can specify semantics that go beyond the current capabilities of native HTML. This can be very useful, as it provides authors the opportunity to create widgets, or expose specific accessible states and properties to native HTML features which would not be possible by the use of HTML alone. For instance, a `button` element has no native HTML feature to expose a "pressed" state. ARIA allows authors to extend the semantics of the element by specifying the `aria-pressed` attribute, allowing for an aural UI that will match the visual presentation of the control. In the following example, a `button` element allows for a user to toggle the state of a setting within a web application. The `aria-pressed` attribute is used to augment the `button` element. When in the "pressed" state that information can be exposed to users of assistive technologies. <pre class="HTML example" title="Communicate a button's pressed state with ARIA"> <button aria-pressed=true>...</button> </pre> There are also situations where certain `aria-*` attributes are allowed for use on elements with specific `role`s, while the equivalent native attribute is currently not valid in HTML itself. For instance, HTML has no direct concept of a disabled hyperlink (`a href` element). Constructs such as `<a href="..." disabled> ... </a>` are not valid, and will not be conveyed to assistive technologies. ARIA diverges from HTML in this regard and does allow for an `aria-disabled` attribute to be specified on an element with an explicit `role=link`. If an author were to specify an `aria-disabled=true` on an HTML hyperlink, user agents would not functionally treat the hyperlink any differently (it would still be clickable/operable), however it would be exposed to assistive technologies as being in the disabled state. Similarly, while native HTML `option` elements that are descendants of a `select` can only be set as being `selected`, elements with an explicit `option` role can not only allow the equivalent `aria-selected`, but also the `aria-checked` attribute, supporting widgets/constructs that go beyond the capabilities of a native `select` element. Unfortunately, in these situations where ARIA and HTML have feature parity, but diverge in allowances, it can create for a misalignment in support, if not also user experiences. In situations where ARIA allows a feature not supported by HTML, it will often be in the author's and ultimately the user's best interest to instead implement as a fully custom ARIA widget. In the following example, a hyperlink needs to be communicated as being in the disabled state. HTML does not allow for the use of the `disabled` attribute on a hyperlink, and using `aria-disabled=true` would communicate the hyperlink as being disabled to assistive technologies, but would not actually disable the element. The most effective way to both communicate and actually disable a hyperlink would be to remove the `href` from the [^a^] element, creating a placeholder. Then, ARIA can be applied to this placeholder link to communicate the element's intended role and state. <pre class="HTML example" title="Communicate a disabled link with ARIA"> <a role=link aria-disabled=true>...</a> </pre> </section> <section class="informative"> <h2> Author guidance to avoid incorrect use of ARIA </h2> <section> <h3> Avoid overriding interactive elements with non-interactive roles </h3> ARIA is useful for revising or correcting the role of an element when a different role is necessary to expose to users. However, it is rarely in the user or author's best interest to try and use ARIA to override an interactive element, for instance a `button`, with a role generally exposed by a non-interactive element. For instance, a heading. As an example, the following uses a `role=heading` on a [^button^] element. This is not allowed, because the `button` element has default functionality that conflicts with user expectations for the heading role. <pre class="example HTML" title="Wrong role"> <button role="heading">search</button> </pre> An author would need to take additional steps to ensure the default functionality and presentation of the `button` was removed, and even doing so may still not be enough to fully supress the element's implicit features depending on how the user chooses to engage with the web page. E.g., by turning on Windows high contrast themes, or viewing the web page in a browser's reader mode. </section> <section> <h3> Avoid specifying redundant roles </h3> The following example illustrates a [^button^] element which has also been provided an explicit `role=button`. Specifying this role is unnecessary, as a "button" element is already exposed with an implicit `button` role. In practice this particular instance of redundancy will likely not have unforeseen side effects, other than unnecessarily making the markup more verbose, and incorrectly signaling to other authors that this practice is useful. Please review the section [[[#side-effects]]] for an example of where specifying unnecessary roles can be problematic. <pre class="example HTML" title="Redundant role on button">  <button role="button">...</button> </pre> Similarly, the following uses a `role=group` on a [^fieldset^] element, and a `role=Main` on a [^main^] element. This is unnecessary, because the `fieldset` element is implicitly exposed as a `role=group`, as is the `main` element implicitly exposed as a `role=main`. Again, in practice this will likely not have any unforeseen side effects to users of assistive technology, as long as the declaration of the `role` value uses [=ASCII lowercase=]. Please see [[[#case-sensitivity]]] for more information. <pre class="HTML example" title="Redundant role on fieldset and main">  <fieldset role="group">...</fieldset>  <main role="Main">...</main> </pre> The following uses a `role=list` on an [^ul^] element. As the `ul` element has an implicit role of `list`, explicitly adding the role would generally be considered redundant. However, some user agents suppress a list's implicit ARIA semantics if the list markers are removed from the visual presentation of the list items. Generally the redundant declaration of an element's implicit role would not be recommended, but in specific situations such as this, and where the role is necessary to expose, authors can explicitly add the role. <pre class="HTML example" title="Redundant role on list">  <ul role="list">...</ul> </pre> </section> <section> <h3 id="side-effects"> Be cautious of side effects </h3> The following uses a `role=button` on a [^summary^] element. This is unnecessary and can result in cross-platform issues. For instance, preventing the element from correctly exposing its state, and forcing the role of `button`, when it might otherwise be exposed with a platform or browser specific role. <pre class="HTML example" title="Unintended consequences"> <details>  <summary role="button">more information</summary> ... </details> </pre> </section> <section> <h3>Adhere to the rules of ARIA</h3> [[[wai-aria-1.2]]] defines a number of roles which are not meant to be used by authors. Many of these roles are categorized as <a data-cite="wai-aria-1.2#isAbstract">Abstract Roles</a> which are explicitly stated as not to be used by authors. The following example illustrates the invalid use of an abstract `select` role, where an author likely meant to use the `combobox` role instead. <pre class="HTML example" title="Abstract roles are not for authors">  <div role="select" ...>...</div> </pre> ARIA also defines a <a data-cite="wai-aria-1.2#generic">`generic` role</a> which is meant to provide feature parity with a number of HTML elements that do not have more specific ARIA semantics of their own. For instance, HTML's [^div^] and [^span^] elements, among others. ARIA discourages authors from using the `generic` role as its intended purpose is for use by implementors of user agents. In the following example, rather than using a `generic` role, authors are advised to use a `div` in place of the `article` element. If changing the HTML element is not possible, specifying a role of `presentation` or `none` would be acceptable alternaties to remove the implicit role of the `article`. <pre class="HTML example" title="Do not specify elements as generic">  <article role="generic" ...>...</article> </pre> Additionally, ARIA specifically mentions in <a data-cite="wai-aria-1.2/#host_general_conflict">Conflicts with Host Language Semantics</a> that if authors use both native HTML features for exposing states and properties as well as their ARIA counterparts, then the host language features take priority over the explicit ARIA attributes that are also used. For instance, in the following example an author is using HTML's `input type=checkbox` and has specified an `aria-checked=true`. However, user agents are meant to ignore the `aria-checked` attribute. Instead user agents would expose the state based on the native features of the form control. <pre class="HTML example" title="The implicit checked state takes precedent over the explicit ARIA attribute">  <input type="checkbox" checked aria-checked="false"> </pre> </section> <section> <h3>Adhere to the rules of HTML</h3> While ARIA can be used to alter the way HTML features are exposed to users of assistive technologies, these modifications do not change the underlying parsing and allowed content models of HTML. For instance, a [^div^] allows an author to specify any role on it. However, this does not mean that the element can then be used in a way that deviates from the rules HTML has defined for the element. For instance, in the following example an author has specified a role of `link` on a `div` element. While HTML allows for a hyperlink (exposed as a `role=link`) to be a descendant of a `p` element, the HTML parser does not allow a `div` to be a descendant of a `p` element. <pre class="HTML example" title="Revised ARIA semantics with invalid HTML nesting">  ... <div role=link tabindex=0>...</div> ... </pre> The HTML parser will modify the above markup to be output as the following: <pre class="HTML example" title="Unwanted rendered markup with valid alternative solution"> &lt!-- The previous example's markup will render as follows --> ... <div role=link tabindex=0>...</div> ...  ... ... ... </pre> While this specification indicates the allowed ARIA attributes that can be specified on each HTML element, this example illustrates that even if a role is allowed, the context in which it is used can still result in potential rendering and accessibility issues. </section> </section> <section> <h2 id="docconformance"> Document conformance requirements for use of ARIA attributes in HTML </h2> The following table provides normative per-element document conformance requirements for the use of ARIA markup in HTML documents. Additionally, it identifies the <a>implicit ARIA semantics</a> that apply to [=HTML elements=]. The <a>implicit ARIA semantics</a> of these elements are defined in [[html-aam-1.0|HTML AAM]]. Each language feature (element) in a cell in the first column implies the ARIA semantics (role, states, and properties) given in the cell in the second column of the same row. The third cell in each row defines the ARIA `role` values and `aria-*` attributes which authors MAY specify on the element. Where a cell in the third column includes the term <dfn>Any `role`</dfn> it indicates that any `role` value MAY be used on the element. However, it is NOT RECOMMENDED for authors to specify the implicit role of the element, the `generic` role, or a role <a href="#docconformance-deprecated">deprecated by ARIA</a> on these elements. If a cell in the third column includes the term <dfn>No `role`</dfn> it indicates that authors MUST NOT overwrite the implicit ARIA semantics, or native semantics of the HTML element. <div class="addition"> [[wai-aria-1.2|WAI-ARIA]] identifies roles which have <a data-cite="wai-aria-1.2/#prohibitedattributes">prohibited states and properties</a>. These roles do not allow certain WAI-ARIA attributes to be specified by authors. HTML elements which expose these implicit WAI-ARIA roles also prohibit authors from specifying these WAI-ARIA attributes. Elements which are identified as <dfn>Naming prohibited</dfn> are those which authors MUST NOT specify an `aria-label` or `aria-labelledby` attribute, unless the element allows for its implicit role to be overwritten by an explicit WAI-ARIA role which allows naming from authors. For more information see [[[#docconformance-naming]]]. </div> While setting an ARIA `role` and/or `aria-*` attribute that matches the implicit ARIA semantics is NOT RECOMMENDED, in some situations explicitly setting these attributes can be helpful – for instance, for user agents that do not expose implicit ARIA semantics for certain elements. While it is conforming to use [[[dpub-aria-1.0]]] `role` values as outlined in the following table, the current support for exposing the semantics of these values to users of assistive technology is close to non-existent. <table class="simple"> <caption> Rules of ARIA attribute usage by HTML element </caption> <thead> <tr> <th> HTML element </th> <th> Implicit ARIA semantics (explicitly assigning these in markup is NOT RECOMMENDED) </th> <th> ARIA role, state and property allowances </th> </tr> </thead> <tbody> <tr> <th id="el-a" tabindex="-1"> [^a^] with [^a/href^] </th> <td> <code>role=<a href="#index-aria-link">link</a></code> </td> <td> Roles: <a href="#index-aria-button">`button`</a>, <a href="#index-aria-checkbox">`checkbox`</a>, <a href="#index-aria-menuitem">`menuitem`</a>, <a href="#index-aria-menuitemcheckbox">`menuitemcheckbox`</a>, <a href="#index-aria-menuitemradio">`menuitemradio`</a>, <a href="#index-aria-option">`option`</a>, <a href="#index-aria-radio">`radio`</a>, <a href="#index-aria-switch">`switch`</a>, <a href="#index-aria-tab">`tab`</a> or <a href="#index-aria-treeitem">`treeitem`</a>. (<code><a href="#index-aria-link">link</a></code> is also allowed, but NOT RECOMMENDED.) DPub Roles: <a data-cite="dpub-aria-1.0#doc-backlink">`doc-backlink`</a>, <a data-cite="dpub-aria-1.0#doc-biblioref">`doc-biblioref`</a>, <a data-cite="dpub-aria-1.0#doc-glossref">`doc-glossref`</a> or <a data-cite="dpub-aria-1.0#doc-noteref">`doc-noteref`</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. It is NOT RECOMMENDED to use `aria-disabled="true"` on an `a` element with an `href` attribute. <div class="note"> If a link needs to be programmatically communicated as "disabled", <a href="#example-communicate-a-disabled-link-with-aria">remove the `href` attribute</a>. </div> </td> </tr> <tr> <th id="el-a-no-href" tabindex="-1"> [^a^] without [^a/href^] </th> <td> <code>role=<a href="#index-aria-generic">generic</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-abbr" tabindex="-1"> [^abbr^] </th> <td> <a>No corresponding role</a> </td> <td> <a>Any `role`</a> <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-address" tabindex="-1"> [^address^] </th> <td> <code>role=<a href="#index-aria-group">group</a></code> </td> <td> <a>Any `role`</a>, though <a href="#index-aria-group">`group`</a> SHOULD NOT be used. Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-area" tabindex="-1"> [^area^] with [^area/href^] </th> <td> <code>role=<a href="#index-aria-link">link</a></code> </td> <td> <a>No `role`</a> other than <code><a href="#index-aria-link">link</a></code>, which is NOT RECOMMENDED. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the <a href="#index-aria-link">`link`</a> role. </td> </tr> <tr> <th id="el-area-no-href" tabindex="-1"> [^area^] without [^area/href^] </th> <td> <code>role=<a href="#index-aria-generic">generic</a></code> </td> <td> <div class="addition"> Roles: <a href="#index-aria-button">`button`</a> or <a href="#index-aria-link">`link`</a>. (<code><a href="#index-aria-generic">generic</a></code> is also allowed, but SHOULD NOT BE USED.) <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </div> </td> </tr> <tr> <th id="el-article" tabindex="-1"> [^article^] </th> <td> <code>role=<a href="#index-aria-article">article</a></code> </td> <td> Roles: <a href="#index-aria-application">`application`</a>, <a href="#index-aria-document">`document`</a>, <a href="#index-aria-feed">`feed`</a>, <a href="#index-aria-main">`main`</a>, <a href="#index-aria-none">`none`</a>, <a href="#index-aria-presentation">`presentation`</a> or <a href="#index-aria-region">`region`</a>. (<code><a href="#index-aria-article">article</a></code> is also allowed, but NOT RECOMMENDED.) <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-aside" tabindex="-1"> [^aside^] </th> <td> <code>role=<a href="#index-aria-complementary">complementary</a></code> </td> <td> Roles: <a href="#index-aria-feed">`feed`</a>, <a href="#index-aria-none">`none`</a>, <a href="#index-aria-note">`note`</a>, <a href="#index-aria-presentation">`presentation`</a>, <a href="#index-aria-region">`region`</a> or <a href="#index-aria-search">`search`</a>. (<code><a href="#index-aria-complementary">complementary</a></code> is also allowed, but NOT RECOMMENDED.) DPub Roles: <a data-cite="dpub-aria-1.0#doc-dedication">`doc-dedication`</a>, <a data-cite="dpub-aria-1.0#doc-example">`doc-example`</a>, <a data-cite="dpub-aria-1.0#doc-footnote">`doc-footnote`</a>, <a data-cite="dpub-aria-1.0#doc-glossary">`doc-glossary`</a>, <a data-cite="dpub-aria-1.0#doc-pullquote">`doc-pullquote`</a> or <a data-cite="dpub-aria-1.0#doc-tip">`doc-tip`</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-audio" tabindex="-1"> [^audio^] </th> <td> <a>No corresponding role</a> </td> <td> Role: <a href="#index-aria-application">`application`</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the <a href="#index-aria-application">`application`</a> role. </td> </tr> <tr> <th id="el-autonomous-custom-element" tabindex="-1"> <a>autonomous custom element</a> </th> <td> Role exposed from author defined {{ElementInternals}} Otherwise <code>role=<a href="#index-aria-generic">generic</a></code> </td> <td> If role defined by `ElementInternals`, <a>no `role`</a> Otherwise, <a>any `role`</a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used. <a>Naming Prohibited</a> if exposed as the `generic` role, or if exposed as another role which prohibits naming. Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-b" tabindex="-1"> [^b^] </th> <td> <code>role=<a href="#index-aria-generic">generic</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-base" tabindex="-1"> [^base^] </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> or `aria-*` attributes </td> </tr> <tr> <th id="el-bdi" tabindex="-1"> [^bdi^] </th> <td> <code>role=<a href="#index-aria-generic">generic</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-bdo" tabindex="-1"> [^bdo^] </th> <td> <code>role=<a href="#index-aria-generic">generic</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-blockquote" tabindex="-1"> [^blockquote^] </th> <td> <code>role=<a href="#index-aria-blockquote">`blockquote`</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-blockquote">`blockquote`</a></code> is NOT RECOMMENDED. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-body" tabindex="-1"> [^body^] </th> <td> <code>role=<a href="#index-aria-generic">generic</a></code> </td> <td> <a>No `role`</a> other than <code><a href="#index-aria-generic">generic</a></code>, which SHOULD NOT be used. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> allowed for the `generic` role, with the exception that authors MUST NOT specify `aria-hidden=true` on the `body` element. </td> </tr> <tr> <th id="el-br" tabindex="-1"> [^br^] </th> <td> <a>No corresponding role</a> </td> <td> Roles: <a href="#index-aria-none">`none`</a> or <a href="#index-aria-presentation">`presentation`</a> Authors MAY specify the <a data-cite="wai-aria-1.2#aria-hidden">`aria-hidden`</a> attribute on the `br` element. Otherwise, no other allowed `aria-*` attributes. </td> </tr> <tr> <th id="el-button" tabindex="-1"> [^button^] </th> <td> <code>role=<a href="#index-aria-button">button</a></code> </td> <td> Roles: <a href="#index-aria-checkbox">`checkbox`</a>, <a href="#index-aria-combobox">`combobox`</a>, <a href="#index-aria-gridcell">`gridcell`</a>, <a href="#index-aria-link">`link`</a>, <a href="#index-aria-menuitem">`menuitem`</a>, <a href="#index-aria-menuitemcheckbox">`menuitemcheckbox`</a>, <a href="#index-aria-menuitemradio">`menuitemradio`</a>, <a href="#index-aria-option">`option`</a>, <a href="#index-aria-radio">`radio`</a>, <a href="#index-aria-separator">`separator`</a>, <a href="#index-aria-slider">`slider`</a>, <a href="#index-aria-switch">`switch`</a>, <a href="#index-aria-tab">`tab`</a>, or <a href="#index-aria-treeitem">`treeitem`</a>. (<code><a href="#index-aria-button">button</a></code> is also allowed, but NOT RECOMMENDED.) <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-canvas" tabindex="-1"> [^canvas^] </th> <td> <a>No corresponding role</a> </td> <td> <a>Any `role`</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-caption" tabindex="-1"> [^caption^] </th> <td> <code>role=<a href="#index-aria-caption">`caption`</a></code> </td> <td> <a>No `role`</a> other than <code><a href="#index-aria-caption">`caption`</a></code>, which is NOT RECOMMENDED. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a>. </td> </tr> <tr> <th id="el-cite" tabindex="-1"> [^cite^] </th> <td> <a>No corresponding role</a> </td> <td> <a>Any `role`</a> <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-code" tabindex="-1"> [^code^] </th> <td> <code>role=<a href="#index-aria-code">`code`</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-code">`code`</a></code> is NOT RECOMMENDED. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-col" tabindex="-1"> [^col^] </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> or `aria-*` attributes </td> </tr> <tr> <th id="el-colgroup" tabindex="-1"> [^colgroup^] </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> or `aria-*` attributes </td> </tr> <tr> <th id="el-data" tabindex="-1"> [^data^] </th> <td> <code>role=<a href="#index-aria-generic">generic</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-datalist" tabindex="-1"> [^datalist^] </th> <td> <code>role=<a href="#index-aria-listbox">listbox</a></code> </td> <td> <div class="correction"> <a>No `role`</a> other than <code><a href="#index-aria-listbox">listbox</a></code>, which is NOT RECOMMENDED. No `aria-*` attributes. </div> </td> </tr> <tr> <th id="el-dd" tabindex="-1"> [^dd^] </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the `definition` role. </td> </tr> <tr> <th id="el-del" tabindex="-1"> [^del^] </th> <td> <code>role=<a href="#index-aria-deletion">`deletion`</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-deletion">`deletion`</a></code> is NOT RECOMMENDED. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-details" tabindex="-1"> [^details^] </th> <td> <code>role=<a href="#index-aria-group">group</a></code> </td> <td> <a>No `role`</a> other than <code><a href="#index-aria-group">group</a></code>, which is NOT RECOMMENDED. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the `group` role. </td> </tr> <tr> <th id="el-dfn" tabindex="-1"> [^dfn^] </th> <td> <code>role=<a href="#index-aria-term">term</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-term">term</a></code> is NOT RECOMMENDED. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-dialog" tabindex="-1"> [^dialog^] </th> <td> <code>role=<a href="#index-aria-dialog">dialog</a></code> </td> <td> Role: <a href="#index-aria-alertdialog">`alertdialog`</a>. (<code><a href="#index-aria-dialog">dialog</a></code> is also allowed, but NOT RECOMMENDED.) <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the `dialog` role. </td> </tr> <tr> <th id="el-div" tabindex="-1"> [^div^] </th> <td> <code>role=<a href="#index-aria-generic">generic</a></code> </td> <td> If a direct child of a [^dl^] element, only <a href="#index-aria-presentation">`presentation`</a> or <a href="#index-aria-none">`none`</a>. Otherwise, <a>any `role`</a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-dl" tabindex="-1"> [^dl^] </th> <td> <a>No corresponding role</a> </td> <td> Roles: <a href="#index-aria-group">`group`</a>, <a href="#index-aria-list">`list`</a>, <a href="#index-aria-none">`none`</a> or <a href="#index-aria-presentation">`presentation`</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-dt" tabindex="-1"> [^dt^] </th> <td> <a>No corresponding role</a> </td> <td> Role: <a href="#index-aria-listitem">`listitem`</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-em" tabindex="-1"> [^em^] </th> <td> <code>role=<a href="#index-aria-emphasis">`emphasis`</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-emphasis">`emphasis`</a></code> is NOT RECOMMENDED. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-embed" tabindex="-1"> [^embed^] </th> <td> <a>No corresponding role</a> </td> <td> Roles: <a href="#index-aria-application">`application`</a>, <a href="#index-aria-document">`document`</a>, <a href="#index-aria-img">`img`</a>, <a href="#index-aria-none">`none`</a> or <a href="#index-aria-presentation">`presentation`</a>. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-fieldset" tabindex="-1"> [^fieldset^] </th> <td> <code>role=<a href="#index-aria-group">group</a></code> </td> <td> Roles: <a href="#index-aria-none">`none`</a>, <a href="#index-aria-presentation">`presentation`</a> or <a href="#index-aria-radiogroup">`radiogroup`</a>. (<code><a href="#index-aria-group">group</a></code> is also allowed, but NOT RECOMMENDED.) <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-figcaption" tabindex="-1"> [^figcaption^] </th> <td> <a>No corresponding role</a> </td> <td> Roles: <a href="#index-aria-group">`group`</a>, <a href="#index-aria-none">`none`</a> or <a href="#index-aria-presentation">`presentation`</a> <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-figure" tabindex="-1"> [^figure^] </th> <td> <code>role=<a href="#index-aria-figure">figure</a></code> </td> <td> If the `figure` has no `figcaption` descendant: <a>Any `role`</a>, though <code><a href="#index-aria-figure">figure</a></code> is NOT RECOMMENDED. If the `figure` has a `figcaption` descendant: DPub Role: <a data-cite="dpub-aria-1.0#doc-example">`doc-example`</a>. Otherwise, <code><a href="#index-aria-figure">figure</a></code> is allowed, but NOT RECOMMENDED. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-footer" tabindex="-1"> [^footer^] </th> <td> If not a descendant of an `article`, `aside`, `main`, `nav` or `section` element, or an element with `role=article`, `complementary`, `main`, `navigation` or `region` then <code>role=<a href="#index-aria-contentinfo">contentinfo</a></code> Otherwise, <code>role=<a href="#index-aria-generic">generic</a></code> </td> <td> Roles: <a href="#index-aria-group">`group`</a>, <a href="#index-aria-presentation">`presentation`</a> or <a href="#index-aria-none">`none`</a>. (If not a descendant of an `article`, `aside`, `main`, `nav` or `section` element, or an element with `role=article`, `complementary`, `main`, `navigation` or `region`, then <code>role=<a href="#index-aria-contentinfo">contentinfo</a></code> is also allowed, but NOT RECOMMENDED. Otherwise, <code>role=<a href="#index-aria-generic">generic</a></code> is also allowed, but SHOULD NOT be used.) DPub Role: <a data-cite="dpub-aria-1.0#doc-footnote">`doc-footnote`</a> <a>Naming Prohibited</a> if exposed as `generic`. Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-form" tabindex="-1"> [^form^] </th> <td> <code>role=<a href="#index-aria-form">form</a></code> </td> <td> Roles: <a href="#index-aria-none">`none`</a>, <a href="#index-aria-presentation">`presentation`</a> or <a href="#index-aria-search">`search`</a>. (<code><a href="#index-aria-form">form</a></code> is also allowed, but NOT RECOMMENDED.) <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. A `form` is not exposed as a landmark region unless it has been provided an <a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a>. </td> </tr> <tr> <th id="el-form-associated-custom-element" tabindex="-1"> <a>form-associated custom element</a> </th> <td> Role exposed from author defined {{ElementInternals}} Otherwise <code>role=<a href="#index-aria-generic">generic</a></code> </td> <td> If role defined by `ElementInternals`, <a>no `role`</a> Otherwise, form-related roles: <a href="#index-aria-button">`button`</a>, <a href="#index-aria-checkbox">`checkbox`</a>, <a href="#index-aria-combobox">`combobox`</a>, <a href="#index-aria-listbox">`listbox`</a>, <a href="#index-aria-progressbar">`progressbar`</a>, <a href="#index-aria-group">`group`</a>, <a href="#index-aria-radio">`radio`</a>, <a href="#index-aria-radiogroup">`radiogroup`</a>, <a href="#index-aria-searchbox">`searchbox`</a>, <a href="#index-aria-slider">`slider`</a>, <a href="#index-aria-spinbutton">`spinbutton`</a>, <a href="#index-aria-switch">`switch`</a> or <a href="#index-aria-textbox">`textbox`</a>. (<code><a href="#index-aria-generic">generic</a></code> is also allowed, but SHOULD NOT be used.) <a>Naming Prohibited</a> if exposed as the `generic` role. Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-h1-h6" tabindex="-1"> <a data-cite="html/sections.html#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements">`h1 to h6`</a> </th> <td> <code>role=<a href="#index-aria-heading">heading</a></code>, `aria-level` = the number in the element's tag name </td> <td> Roles: <a href="#index-aria-none">`none`</a>, <a href="#index-aria-presentation">`presentation`</a> or <a href="#index-aria-tab">`tab`</a>. (<code><a href="#index-aria-heading">heading</a></code> is also allowed, but NOT RECOMMENDED.) DPub Role: <a data-cite="dpub-aria-1.0#doc-subtitle">`doc-subtitle`</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-head" tabindex="-1"> [^head^] </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> or `aria-*` attributes </td> </tr> <tr> <th id="el-header" tabindex="-1"> [^header^] </th> <td> If not a descendant of an `article`, `aside`, `main`, `nav` or `section` element, or an element with `role=article`, `complementary`, `main`, `navigation` or `region` then <code>role=<a href="#index-aria-banner">banner</a></code> Otherwise, <code>role=<a href="#index-aria-generic">generic</a></code> </td> <td> Roles: <a href="#index-aria-group">`group`</a>, <a href="#index-aria-none">`none`</a> or <a href="#index-aria-presentation">`presentation`</a>. (If not a descendant of an `article`, `aside`, `main`, `nav` or `section` element, or an element with `role=article`, `complementary`, `main`, `navigation` or `region`, then <code>role=<a href="#index-aria-banner">banner</a></code> is also allowed, but NOT RECOMMENDED. Otherwise, <code>role=<a href="#index-aria-generic">generic</a></code> is also allowed, but SHOULD NOT be used.) <a>Naming Prohibited</a> if exposed as `generic`. Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-hgroup" tabindex="-1"> [^hgroup^] </th> <td> <code>role=<a href="#index-aria-group">group</a></code> </td> <td> <a>Any `role`</a>, though <a href="#index-aria-group">`group`</a> SHOULD NOT be used. Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-hr" tabindex="-1"> [^hr^] </th> <td> <code>role=<a href="#index-aria-separator">separator</a></code> </td> <td> Roles: <a href="#index-aria-none">`none`</a> or <a href="#index-aria-presentation">`presentation`</a>. (<code><a href="#index-aria-separator">separator</a></code> is also allowed, but NOT RECOMMENDED.) DPub Role: <a data-cite="dpub-aria-1.0#doc-pagebreak">`doc-pagebreak`</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the `separator` role. </td> </tr> <tr> <th id="el-html" tabindex="-1"> [^html^] </th> <td> <code>role=<a href="#index-aria-document">document</a></code> </td> <td> <a>No `role`</a> other than <code><a href="#index-aria-document">document</a></code>, which is NOT RECOMMENDED. No `aria-*` attributes. </td> </tr> <tr> <th id="el-i" tabindex="-1"> [^i^] </th> <td> <code>role=<a href="#index-aria-generic">generic</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-iframe" tabindex="-1"> [^iframe^] </th> <td> <a>No corresponding role</a> </td> <td> Roles: <a href="#index-aria-application">`application`</a>, <a href="#index-aria-document">`document`</a>, <a href="#index-aria-img">`img`</a>, <a href="#index-aria-none">`none`</a> or <a href="#index-aria-presentation">`presentation`</a>. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-img" tabindex="-1"> <div class="correction proposed"> [^img^] with an accessible name. </div> </th> <td> If the `img` has non-empty [^img/alt^] (`alt="some text"`) or an accessible name is provided another <a data-cite="html-aam-1.0#img-element-accessible-name-computation">`img` naming method</a>: <code>role=<a href="#index-aria-img">img</a></code> </td> <td> Roles: <a href="#index-aria-button">`button`</a>, <a href="#index-aria-checkbox">`checkbox`</a>, <a href="#index-aria-link">`link`</a>, <a href="#index-aria-menuitem">`menuitem`</a>, <a href="#index-aria-menuitemcheckbox">`menuitemcheckbox`</a>, <a href="#index-aria-menuitemradio">`menuitemradio`</a>, <a href="#index-aria-meter">`meter`</a>, <a href="#index-aria-option">`option`</a>, <a href="#index-aria-progressbar">`progressbar`</a>, <a href="#index-aria-radio">`radio`</a>, <a href="#index-aria-scrollbar">`scrollbar`</a>, <a href="#index-aria-separator">`separator`</a>, <a href="#index-aria-slider">`slider`</a>, <a href="#index-aria-switch">`switch`</a>, <a href="#index-aria-tab">`tab`</a> or <a href="#index-aria-treeitem">`treeitem`</a>. (<code><a href="#index-aria-img">img</a></code> is also allowed, but NOT RECOMMENDED.) DPub Role: <a data-cite="dpub-aria-1.0#doc-cover">`doc-cover`</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-img-no-name" tabindex="-1"> [^img^] with no accessible name. </th> <td> <div class="proposed correction"> If the `img` has an empty `alt` ([^img/alt^]`=""`) and lacks any other <a data-cite="html-aam-1.0#img-element-accessible-name-computation">`img` naming methods</a>: <code>role=<a href="#index-aria-none">none</a></code>, <code>role=<a href="#index-aria-presentation">presentation</a></code> If the `img` <a data-cite="html/images.html#unknown-images">lacks an `alt` attribute</a> and lacks any other <a data-cite="html-aam-1.0#img-element-accessible-name-computation">`img` naming methods</a>: <code>role=<a href="#index-aria-img">img</a></code> </div> </td> <td> <div class="correction proposed"> If the `img` has no `alt` attribute or accessible name: <a>No `role`</a> other than the <code>role=<a href="#index-aria-none">none</a></code> or <code><a href="#index-aria-presentation">presentation</a></code> roles. (<code>role=<a href="#index-aria-img">img</a></code> is also allowed, but NOT RECOMMENDED.) If the `img` has an empty `alt=""` attribute and no `aria-label` or `aria-labelledby` attributes to provide it an accessible name: <a>No `role`</a> other than the <code>role=<a href="#index-aria-none">none</a></code> or <code><a href="#index-aria-presentation">presentation</a></code> roles, which are NOT RECOMMENDED. No `aria-*` attributes except <a data-cite="wai-aria-1.2#aria-hidden">`aria-hidden="true"`</a>. Otherwise, if the `img` has an author defined accessible name, see <a href="#el-img">`img` with an accessible name</a>. </div> </td> </tr> <tr> <th id="el-input-button" tabindex="-1"> <a data-cite="html/input.html#button-state-(type=button)">`input type=button`</a> </th> <td> <code>role=<a href="#index-aria-button">button</a></code> </td> <td> Roles: <a href="#index-aria-checkbox">`checkbox`</a>, <a href="#index-aria-combobox">`combobox`</a>, <a href="#index-aria-gridcell">`gridcell`</a>, <a href="#index-aria-link">`link`</a>, <a href="#index-aria-menuitem">`menuitem`</a>, <a href="#index-aria-menuitemcheckbox">`menuitemcheckbox`</a>, <a href="#index-aria-menuitemradio">`menuitemradio`</a>, <a href="#index-aria-option">`option`</a>, <a href="#index-aria-radio">`radio`</a>, <a href="#index-aria-separator">`separator`</a>, <a href="#index-aria-slider">`slider`</a>, <a href="#index-aria-switch">`switch`</a>, <a href="#index-aria-tab">`tab`</a>, or <a href="#index-aria-treeitem">`treeitem`</a>. (<code><a href="#index-aria-button">button</a></code> is also allowed, but NOT RECOMMENDED.) <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-input-checkbox" tabindex="-1"> <a data-cite="html/input.html#checkbox-state-(type=checkbox)">`input type=checkbox`</a> </th> <td> <code>role=<a href="#index-aria-checkbox">checkbox</a></code> </td> <td> Roles: <a href="#index-aria-menuitemcheckbox">`menuitemcheckbox`</a>, <a href="#index-aria-option">`option`</a> or <a href="#index-aria-switch">`switch`</a>; <a href="#index-aria-button">`button` if used with `aria-pressed`</a>. (<code><a href="#index-aria-checkbox">checkbox</a></code> is also allowed, but NOT RECOMMENDED.) Authors <a href="#att-checked">MUST NOT use the `aria-checked` attribute on `input type=checkbox` elements</a>. Otherwise, any <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. The HTML [^input/checked^] attribute can be used instead of the `aria-checked` attribute for `menuitemcheckbox`, `option` or `switch` roles when used on `type=checkbox`. </td> </tr> <tr> <th id="el-input-color" tabindex="-1"> <a data-cite="html/input.html#color-state-(type=color)">`input type=color`</a> </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and `aria-disabled` attribute. </td> </tr> <tr> <th id="el-input-date" tabindex="-1"> <a data-cite="html/input.html#date-state-(type=date)">`input type=date`</a> </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the `textbox` role. </td> </tr> <tr> <th id="el-input-datetime-local" tabindex="-1"> <a data-cite="html/input.html#local-date-and-time-state-(type=datetime-local)">`input type=datetime-local`</a> </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the `textbox` role. </td> </tr> <tr> <th id="el-input-email" tabindex="-1"> <a data-cite="html/input.html#e-mail-state-(type=email)">`input type=email`</a> with no [^input/list^] attribute </th> <td> <code>role=<a href="#index-aria-textbox">textbox</a></code> </td> <td> <a>No `role`</a> other than <code><a href="#index-aria-textbox">textbox</a></code>, which is NOT RECOMMENDED. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the `textbox` role. </td> </tr> <tr> <th id="el-input-file" tabindex="-1"> <a data-cite="html/input.html#file-upload-state-(type=file)">`input type=file`</a> </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a>, `aria-disabled`, `aria-invalid` and `aria-required` attributes. </td> </tr> <tr> <th id="el-input-hidden" tabindex="-1"> <a data-cite="html/input.html#hidden-state-(type=hidden)">`input type=hidden`</a> </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> or `aria-*` attributes </td> </tr> <tr> <th id="el-input-image" tabindex="-1"> <a data-cite="html/input.html#image-button-state-(type=image)">`input type=image`</a> </th> <td> <code>role=<a href="#index-aria-button">button</a></code> </td> <td> <div class="proposed addition"> The following roles are allowed, but are NOT RECOMMENDED: <a href="#index-aria-button">`button`</a>, <a href="#index-aria-checkbox">`checkbox`</a>, <a href="#index-aria-gridcell">`gridcell`</a>, <a href="#index-aria-link">`link`</a>, <a href="#index-aria-menuitem">`menuitem`</a>, <a href="#index-aria-menuitemcheckbox">`menuitemcheckbox`</a>, <a href="#index-aria-menuitemradio">`menuitemradio`</a>, <a href="#index-aria-option">`option`</a>, <a href="#index-aria-radio">`radio`</a>, <a href="#index-aria-separator">`separator`</a>, <a href="#index-aria-slider">`slider`</a>, <a href="#index-aria-switch">`switch`</a>, <a href="#index-aria-tab">`tab`</a> or <a href="#index-aria-treeitem">`treeitem`</a>. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. If possible, authors SHOULD consider using a different HTML element which allows the specified role, such as the `button` element. </div> </td> </tr> <tr> <th id="el-input-month" tabindex="-1"> <a data-cite="html/input.html#month-state-(type=month)">`input type=month`</a> </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the `textbox` role. </td> </tr> <tr> <th id="el-input-number" tabindex="-1"> <a data-cite="html/input.html#number-state-(type=number)">`input type=number`</a> </th> <td> <code>role=<a href="#index-aria-spinbutton">spinbutton</a></code> </td> <td> <a>No `role`</a> other than <code><a href="#index-aria-spinbutton">spinbutton</a></code>, which is NOT RECOMMENDED. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the `spinbutton` role. </td> </tr> <tr> <th id="el-input-password" tabindex="-1"> <a data-cite="html/input.html#password-state-(type=password)">`input type=password`</a> </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the `textbox` role. </td> </tr> <tr> <th id="el-input-radio" tabindex="-1"> <a data-cite="html/input.html#radio-button-state-(type=radio)">`input type=radio`</a> </th> <td> <code>role=<a href="#index-aria-radio">radio</a></code> </td> <td> Role: <a href="#index-aria-menuitemradio">`menuitemradio`</a>. (<code><a href="#index-aria-radio">radio</a></code> is also allowed, but NOT RECOMMENDED.) Authors <a href="#att-checked">MUST NOT use the `aria-checked` attribute on `input type=radio` elements</a>. Otherwise, any <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. The HTML [^input/checked^] attribute can be used instead of the `aria-checked` attribute for the `menuitemradio` role when used on `type=radio`. </td> </tr> <tr> <th id="el-input-range" tabindex="-1"> <a data-cite="html/input.html#range-state-(type=range)">`input type=range`</a> </th> <td> <code>role=<a href="#index-aria-slider">slider</a></code> </td> <td> <a>No `role`</a> other than <code><a href="#index-aria-slider">slider</a></code>, which is NOT RECOMMENDED. Authors SHOULD NOT use the <a href="#att-max">`aria-valuemax`</a> or <a href="#att-min">`aria-valuemin`</a> attributes on `input type=range`. Otherwise, any <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any other `aria-*` attributes applicable to the `slider` role. </td> </tr> <tr> <th id="el-input-reset" tabindex="-1"> <a data-cite="html/input.html#reset-button-state-(type=reset)">`input type=reset`</a> </th> <td> <code>role=<a href="#index-aria-button">button</a></code> </td> <td> <div class="proposed addition"> The following roles are allowed, but are NOT RECOMMENDED: <a href="#index-aria-button">`button`</a>, <a href="#index-aria-checkbox">`checkbox`</a>, <a href="#index-aria-combobox">`combobox`</a>, <a href="#index-aria-gridcell">`gridcell`</a>, <a href="#index-aria-link">`link`</a>, <a href="#index-aria-menuitem">`menuitem`</a>, <a href="#index-aria-menuitemcheckbox">`menuitemcheckbox`</a>, <a href="#index-aria-menuitemradio">`menuitemradio`</a>, <a href="#index-aria-option">`option`</a>, <a href="#index-aria-radio">`radio`</a>, <a href="#index-aria-separator">`separator`</a>, <a href="#index-aria-slider">`slider`</a>, <a href="#index-aria-switch">`switch`</a>, <a href="#index-aria-tab">`tab`</a> or <a href="#index-aria-treeitem">`treeitem`</a>. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. If possible, authors SHOULD consider using a different HTML element which allows the specified role, such as the `button` element. </div> </td> </tr> <tr> <th id="el-input-search" tabindex="-1"> <a data-cite="html/input.html#text-(type=text)-state-and-search-state-(type=search)">`input type=search`</a>, with no [^input/list^] attribute </th> <td> <code>role=<a href="#index-aria-searchbox">searchbox</a></code> </td> <td> <a>No `role`</a> other than <code><a href="#index-aria-searchbox">searchbox</a></code>, which is NOT RECOMMENDED. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the `searchbox` role. </td> </tr> <tr> <th id="el-input-submit" tabindex="-1"> <a data-cite="html/input.html#submit-button-state-(type=submit)">`input type=submit`</a> </th> <td> <code>role=<a href="#index-aria-button">button</a></code> </td> <td> <div class="proposed addition"> The following roles are allowed, but are NOT RECOMMENDED: <a href="#index-aria-button">`button`</a>, <a href="#index-aria-checkbox">`checkbox`</a>, <a href="#index-aria-combobox">`combobox`</a>, <a href="#index-aria-gridcell">`gridcell`</a>, <a href="#index-aria-link">`link`</a>, <a href="#index-aria-menuitem">`menuitem`</a>, <a href="#index-aria-menuitemcheckbox">`menuitemcheckbox`</a>, <a href="#index-aria-menuitemradio">`menuitemradio`</a>, <a href="#index-aria-option">`option`</a>, <a href="#index-aria-radio">`radio`</a>, <a href="#index-aria-separator">`separator`</a>, <a href="#index-aria-slider">`slider`</a>, <a href="#index-aria-switch">`switch`</a>, <a href="#index-aria-tab">`tab`</a> or <a href="#index-aria-treeitem">`treeitem`</a>. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. If possible, authors SHOULD consider using a different HTML element which allows the specified role, such as the `button` element. </div> </td> </tr> <tr> <th id="el-input-tel" tabindex="-1"> <a data-cite="html/input.html#telephone-state-(type=tel)">`input type=tel`</a>, with no [^input/list^] attribute </th> <td> <code>role=<a href="#index-aria-textbox">textbox</a></code> </td> <td> <a>No `role`</a> other than <code><a href="#index-aria-textbox">textbox</a></code>, which is NOT RECOMMENDED. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the `textbox` role. </td> </tr> <tr> <th id="el-input-text" tabindex="-1"> <a data-cite="html/input.html#text-(type=text)-state-and-search-state-(type=search)">`input type=text`</a> or with a missing or invalid `type`, with no [^input/list^] attribute </th> <td> <code>role=<a href="#index-aria-textbox">textbox</a></code> </td> <td> Roles: <a href="#index-aria-combobox">`combobox`</a>, <a href="#index-aria-searchbox">`searchbox`</a> or <a href="#index-aria-spinbutton">`spinbutton`</a>. (<code><a href="#index-aria-textbox">textbox</a></code> is also allowed, but NOT RECOMMENDED.) <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-input-text-list" tabindex="-1"> <a data-cite="html/input.html#text-(type=text)-state-and-search-state-(type=search)">`input type=text`</a>, <a data-cite="html/input.html#text-(type=text)-state-and-search-state-(type=search)">`search`</a>, <a data-cite="html/input.html#telephone-state-(type=tel)">`tel`</a>, <a data-cite="html/input.html#url-state-(type=url)">`url`</a>, <a data-cite="html/input.html#e-mail-state-(type=email)">`email`</a>, or with a missing or invalid `type`, with a [^input/list^] attribute </th> <td> <code>role=<a href="#index-aria-combobox">combobox</a></code> </td> <td> <a>No `role`</a> other than <code><a href="#index-aria-combobox">combobox</a></code>, which is NOT RECOMMENDED. Authors SHOULD NOT use the `aria-haspopup` attribute on the indicated `input`s with a `list` attribute. Otherwise, any <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any other `aria-*` attributes applicable to the `combobox` role. </td> </tr> <tr> <th id="el-input-time" tabindex="-1"> <a data-cite="html/input.html#time-state-(type=time)">`input type=time`</a> </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the `textbox` role. </td> </tr> <tr> <th id="el-input-url" tabindex="-1"> <a data-cite="html/input.html#url-state-(type=url)">`input type=url`</a> with no [^input/list^] attribute </th> <td> <code>role=<a href="#index-aria-textbox">textbox</a></code> </td> <td> <a>No `role`</a> other than <code><a href="#index-aria-textbox">textbox</a></code>, which is NOT RECOMMENDED. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the `textbox` role. </td> </tr> <tr> <th id="el-input-week" tabindex="-1"> <a data-cite="html/input.html#week-state-(type=week)">`input type=week`</a> </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the `textbox` role. </td> </tr> <tr> <th id="el-ins" tabindex="-1"> [^ins^] </th> <td> <code>role=<a href="#index-aria-insertion">`insertion`</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-insertion">`insertion`</a></code> is NOT RECOMMENDED. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-kbd" tabindex="-1"> [^kbd^] </th> <td> <a>No corresponding role</a> </td> <td> <a>Any `role`</a> <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-label" tabindex="-1"> [^label^] </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a>. </td> </tr> <tr> <th id="el-legend" tabindex="-1"> [^legend^] </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a>. </td> </tr> <tr> <th id="el-li" tabindex="-1"> [^li^] </th> <td> If the `li` is a child of a list element (<a href="#el-ul">`ul`</a>, <a href="#el-ol">`ol`</a>, <a href="#el-menu">`menu`</a>) <code>role=<a href="#index-aria-listitem">listitem</a></code>. Otherwise, if the `li` is not a child of a list element it is exposed as a <code>role=<a href="#index-aria-generic">generic</a></code>. </td> <td> <div class="proposed correction"> <a>No `role`</a> other than <code><a href="#index-aria-listitem">listitem</a></code>, which is NOT RECOMMENDED, if the parent list element has an implicit or explicit `list` role. Otherwise, <a>any `role`</a> if the parent list element does not expose an implicit or explicit `list` role. See <a href="#el-ul">`ul`</a>, <a href="#el-ol">`ol`</a>, or <a href="#el-menu">`menu`</a> for allowed roles for list elements. </div> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. <div class="addition proposal"> Authors SHOULD NOT use the following <a href="#docconformance-deprecated">deprecated</a> DPub Roles: <a data-cite="dpub-aria-1.1#doc-biblioentry">`doc-biblioentry`</a>, <a data-cite="dpub-aria-1.1#doc-endnote">`doc-endnote`</a>. </div> </td> </tr> <tr> <th id="el-link" tabindex="-1"> [^link^] </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> or `aria-*` attributes </td> </tr> <tr> <th id="el-main" tabindex="-1"> [^main^] </th> <td> <code>role=<a href="#index-aria-main">main</a></code> </td> <td> <a>No `role`</a> other than <code><a href="#index-aria-main">main</a></code>, which is NOT RECOMMENDED. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the `main` role. </td> </tr> <tr> <th id="el-map" tabindex="-1"> [^map^] </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> or `aria-*` attributes </td> </tr> <tr> <th id="el-mark" tabindex="-1"> [^mark^] </th> <td> <a>No corresponding role</a> </td> <td> <a>Any `role`</a> <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-math" tabindex="-1"> <a data-cite="html/embedded-content-other.html#mathml">`math`</a> </th> <td> <code>role=<a href="#index-aria-math">math</a></code> </td> <td> <a>No `role`</a> other than <code><a href="#index-aria-math">math</a></code>, which is NOT RECOMMENDED. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the `math` role. </td> </tr> <tr> <th id="el-menu" tabindex="-1"> [^menu^] </th> <td> <code>role=<a href="#index-aria-list">list</a></code> </td> <td> Roles: <a href="#index-aria-group">`group`</a>, <a href="#index-aria-listbox">`listbox`</a>, <a href="#index-aria-menu">`menu`</a>, <a href="#index-aria-menubar">`menubar`</a>, <a href="#index-aria-none">`none`</a>, <a href="#index-aria-presentation">`presentation`</a>, <a href="#index-aria-radiogroup">`radiogroup`</a>, <a href="#index-aria-tablist">`tablist`</a>, <a href="#index-aria-toolbar">`toolbar`</a> or <a href="#index-aria-tree">`tree`</a>. (<code><a href="#index-aria-list">list</a></code> is also allowed, but NOT RECOMMENDED.) <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. <div class="addition proposal"> Authors SHOULD NOT use <a href="#docconformance-deprecated">deprecated</a> <a href="#index-aria-directory">`directory`</a> role. </div> </td> </tr> <tr> <th id="el-meta" tabindex="-1"> [^meta^] </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> or `aria-*` attributes </td> </tr> <tr> <th id="el-meter" tabindex="-1"> [^meter^] </th> <td> <code>role=<a href="#index-aria-meter">`meter`</a></code> </td> <td> <a>No `role`</a> other than <code><a href="#index-aria-meter">`meter`</a></code>, which is NOT RECOMMENDED. Authors SHOULD NOT use the <a href="#att-max">`aria-valuemax`</a> or <a href="#att-min">`aria-valuemin`</a> attributes on `meter` elements. Otherwise, any <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any other `aria-*` attributes applicable to the `meter` role. </td> </tr> <tr> <th id="el-nav" tabindex="-1"> [^nav^] </th> <td> <code>role=<a href="#index-aria-navigation">navigation</a></code> </td> <td> Roles: <a href="#index-aria-menu">`menu`</a>, <a href="#index-aria-menubar">`menubar`</a>, <a href="#index-aria-none">`none`</a>, <a href="#index-aria-presentation">`presentation`</a> or <a href="#index-aria-tablist">`tablist`</a>. (<code><a href="#index-aria-navigation">navigation</a></code> is also allowed, but NOT RECOMMENDED.) DPub Roles: <a data-cite="dpub-aria-1.0#doc-index">`doc-index`</a>, <a data-cite="dpub-aria-1.0#doc-pagelist">`doc-pagelist`</a> or <a data-cite="dpub-aria-1.0#doc-toc">`doc-toc`</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-noscript" tabindex="-1"> [^noscript^] </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> or `aria-*` attributes </td> </tr> <tr> <th id="el-object" tabindex="-1"> [^object^] </th> <td> <a>No corresponding role</a> </td> <td> Roles: <a href="#index-aria-application">`application`</a>, <a href="#index-aria-document">`document`</a> or <a href="#index-aria-img">`img`</a>. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-ol" tabindex="-1"> [^ol^] </th> <td> <code>role=<a href="#index-aria-list">list</a></code> </td> <td> Roles: <a href="#index-aria-group">`group`</a>, <a href="#index-aria-listbox">`listbox`</a>, <a href="#index-aria-menu">`menu`</a>, <a href="#index-aria-menubar">`menubar`</a>, <a href="#index-aria-none">`none`</a>, <a href="#index-aria-presentation">`presentation`</a>, <a href="#index-aria-radiogroup">`radiogroup`</a>, <a href="#index-aria-tablist">`tablist`</a>, <a href="#index-aria-toolbar">`toolbar`</a> or <a href="#index-aria-tree">`tree`</a>. (<code><a href="#index-aria-list">list</a></code> is also allowed, but NOT RECOMMENDED.) <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. <div class="addition proposal"> Authors SHOULD NOT use <a href="#docconformance-deprecated">deprecated</a> <a href="#index-aria-directory">`directory`</a> role. </div> </td> </tr> <tr> <th id="el-optgroup" tabindex="-1"> [^optgroup^] </th> <td> <code>role=<a href="#index-aria-group">group</a></code> </td> <td> <a>No `role`</a> other than <code><a href="#index-aria-group">group</a></code>, which is NOT RECOMMENDED. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the `group` role. </td> </tr> <tr> <th id="el-option" tabindex="-1"> [^option^] element that is in a <a data-cite= "html/input.html#attr-input-list">list of options</a> or that represents a suggestion in a [^datalist^] </th> <td> <code>role=<a href="#index-aria-option">option</a></code> </td> <td> <a>No `role`</a> other than <code><a href="#index-aria-option">option</a></code>, which is NOT RECOMMENDED. Authors SHOULD NOT use the `aria-selected` attribute on the `option` element. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any other `aria-*` attributes applicable to the `option` role. </td> </tr> <tr> <th id="el-output" tabindex="-1"> [^output^] </th> <td> <code>role=<a href="#index-aria-status">status</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-status">status</a></code> is NOT RECOMMENDED. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-p" tabindex="-1"> [^p^] </th> <td> <code>role=<a href="#index-aria-paragraph">`paragraph`</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-paragraph">`paragraph`</a></code> is NOT RECOMMENDED. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-param" tabindex="-1"> [^param^] </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> or `aria-*` attributes </td> </tr> <tr> <th id="el-picture" tabindex="-1"> [^picture^] </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> <div class="addition"> Authors MAY specify the <a data-cite="wai-aria-1.2#aria-hidden">`aria-hidden`</a> attribute on the `picture` element. Otherwise, no other allowed `aria-*` attributes. </div> </td> </tr> <tr> <th id="el-pre" tabindex="-1"> [^pre^] </th> <td> <code>role=<a href="#index-aria-generic">generic</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-progress" tabindex="-1"> [^progress^] </th> <td> <code>role=<a href="#index-aria-progressbar">progressbar</a></code> </td> <td> <a>No `role`</a> other than <code><a href="#index-aria-progressbar">progressbar</a></code>, which is NOT RECOMMENDED. Authors SHOULD NOT use the <a href="#att-max">`aria-valuemax`</a> attribute on `progress` elements. Otherwise, any <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any other `aria-*` attributes applicable to the `progressbar` role. </td> </tr> <tr> <th id="el-q" tabindex="-1"> [^q^] </th> <td> <code>role=<a href="#index-aria-generic">generic</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-rp" tabindex="-1"> [^rp^] </th> <td> <a>No corresponding role</a> </td> <td> <a>Any `role`</a> <a>Naming Prohibited</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-rt" tabindex="-1"> [^rt^] </th> <td> <a>No corresponding role</a> </td> <td> <a>Any `role`</a> <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-ruby" tabindex="-1"> [^ruby^] </th> <td> <a>No corresponding role</a> </td> <td> <a>Any `role`</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-s" tabindex="-1"> [^s^] </th> <td> <code>role=<a href="#index-aria-deletion">`deletion`</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-deletion">`deletion`</a></code> is NOT RECOMMENDED. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-samp" tabindex="-1"> [^samp^] </th> <td> <code>role=<a href="#index-aria-generic">generic</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-script" tabindex="-1"> [^script^] </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> or `aria-*` attributes </td> </tr> <tr> <th id="el-search" tabindex="-1"> [^search^] </th> <td> <code>role=<a href="#index-aria-search">search</a></code> </td> <td> <div class="addition proposed"> Roles: <a href="#index-aria-form">`form`</a>, <a href="#index-aria-group">`group`</a>, <a href="#index-aria-none">`none`</a>, <a href="#index-aria-presentation">`presentation`</a> or <a href="#index-aria-region">`region`</a>. (<code><a href="#index-aria-search">search</a></code> is also allowed, but NOT RECOMMENDED.) <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </div> </td> </tr> <tr> <th id="el-section" tabindex="-1"> [^section^] </th> <td> <code>role=<a href="#index-aria-region">region</a></code> if the [^section^] element has an <a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a> Otherwise, <code>role=<a href="#index-aria-generic">generic</a></code> </td> <td> Roles: <a href="#index-aria-alert">`alert`</a>, <a href="#index-aria-alertdialog">`alertdialog`</a>, <a href="#index-aria-application">`application`</a>, <a href="#index-aria-banner">`banner`</a>, <a href="#index-aria-complementary">`complementary`</a>, <a href="#index-aria-contentinfo">`contentinfo`</a>, <a href="#index-aria-dialog">`dialog`</a>, <a href="#index-aria-document">`document`</a>, <a href="#index-aria-feed">`feed`</a>, <a href="#index-aria-group">`group`</a>, <a href="#index-aria-log">`log`</a>, <a href="#index-aria-main">`main`</a>, <a href="#index-aria-marquee">`marquee`</a>, <a href="#index-aria-navigation">`navigation`</a>, <a href="#index-aria-none">`none`</a>, <a href="#index-aria-note">`note`</a>, <a href="#index-aria-presentation">`presentation`</a>, <a href="#index-aria-search">`search`</a>, <a href="#index-aria-status">`status`</a> or <a href="#index-aria-tabpanel">`tabpanel`</a>. (<code>role=<a href="#index-aria-region">region</a></code> is also allowed, but NOT RECOMMENDED. <code>role=<a href="#index-aria-generic">generic</a></code> SHOULD NOT be used.) DPub Roles: <a data-cite="dpub-aria-1.0#doc-abstract">`doc-abstract`</a>, <a data-cite="dpub-aria-1.0#doc-acknowledgments">`doc-acknowledgments`</a>, <a data-cite="dpub-aria-1.0#doc-afterword">`doc-afterword`</a>, <a data-cite="dpub-aria-1.0#doc-appendix">`doc-appendix`</a>, <a data-cite="dpub-aria-1.0#doc-bibliography">`doc-bibliography`</a>, <a data-cite="dpub-aria-1.0#doc-chapter">`doc-chapter`</a>, <a data-cite="dpub-aria-1.0#doc-colophon">`doc-colophon`</a>, <a data-cite="dpub-aria-1.0#doc-conclusion">`doc-conclusion`</a>, <a data-cite="dpub-aria-1.0#doc-credit">`doc-credit`</a>, <a data-cite="dpub-aria-1.0#doc-credits">`doc-credits`</a>, <a data-cite="dpub-aria-1.0#doc-dedication">`doc-dedication`</a>, <a data-cite="dpub-aria-1.0#doc-endnotes">`doc-endnotes`</a>, <a data-cite="dpub-aria-1.0#doc-epigraph">`doc-epigraph`</a>, <a data-cite="dpub-aria-1.0#doc-epilogue">`doc-epilogue`</a>, <a data-cite="dpub-aria-1.0#doc-errata">`doc-errata`</a>, <a data-cite="dpub-aria-1.0#doc-example">`doc-example`</a>, <a data-cite="dpub-aria-1.0#doc-foreword">`doc-foreword`</a>, <a data-cite="dpub-aria-1.0#doc-glossary">`doc-glossary`</a>, <a data-cite="dpub-aria-1.0#doc-index">`doc-index`</a>, <a data-cite="dpub-aria-1.0#doc-introduction">`doc-introduction`</a>, <a data-cite="dpub-aria-1.0#doc-notice">`doc-notice`</a>, <a data-cite="dpub-aria-1.0#doc-pagelist">`doc-pagelist`</a>, <a data-cite="dpub-aria-1.0#doc-part">`doc-part`</a>, <a data-cite="dpub-aria-1.0#doc-preface">`doc-preface`</a>, <a data-cite="dpub-aria-1.0#doc-prologue">`doc-prologue`</a>, <a data-cite="dpub-aria-1.0#doc-pullquote">`doc-pullquote`</a>, <a data-cite="dpub-aria-1.0#doc-qna">`doc-qna`</a>, <a data-cite="dpub-aria-1.0#doc-toc">`doc-toc`</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-select" tabindex="-1"> [^select^] (with NO `multiple` attribute and NO `size` attribute having value greater than `1`) </th> <td> <code>role=<a href="#index-aria-combobox">combobox</a></code> </td> <td> Role: <a href="#index-aria-menu">`menu`</a>. (<code><a href="#index-aria-combobox">combobox</a></code> is also allowed, but NOT RECOMMENDED.) Authors SHOULD NOT use the `aria-multiselectable` attribute on a `select` element. Otherwise, any <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any other `aria-*` attributes applicable to the `combobox` or `menu` role. </td> </tr> <tr> <th id="el-select-multiple-or-size-greater-1" tabindex="-1"> [^select^] (with a `multiple` attribute or a `size` attribute having value greater than `1`) </th> <td> <code>role=<a href="#index-aria-list">listbox</a></code> </td> <td> <a>No `role`</a> other than <code><a href="#index-aria-list">listbox</a></code>, which is NOT RECOMMENDED. Authors SHOULD NOT use the `aria-multiselectable` attribute on a `select` element. Otherwise, any <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any other `aria-*` attributes applicable to the `listbox` role. </td> </tr> <tr> <th id="el-slot" tabindex="-1"> [^slot^] </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> or `aria-*` attributes </td> </tr> <tr> <th id="el-small" tabindex="-1"> [^small^] </th> <td> <code>role=<a href="#index-aria-generic">generic</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-source" tabindex="-1"> [^source^] </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> or `aria-*` attributes </td> </tr> <tr> <th id="el-span" tabindex="-1"> [^span^] </th> <td> <code>role=<a href="#index-aria-generic">generic</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-strong" tabindex="-1"> [^strong^] </th> <td> <code>role=<a href="#index-aria-strong">`strong`</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-strong">`strong`</a></code> is NOT RECOMMENDED. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-style" tabindex="-1"> [^style^] </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> or `aria-*` attributes </td> </tr> <tr> <th id="el-sub" tabindex="-1"> [^sub^] </th> <td> <code>role=<a href="#index-aria-subscript">`subscript`</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-subscript">`subscript`</a></code> is NOT RECOMMENDED. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-summary" tabindex="-1"> [^summary^] </th> <td> <a>No corresponding role</a> <div class="note"> Many, but not all, user agents expose the `summary` element with an implicit ARIA <code>role=<a href="#index-aria-button">button</a></code>. </div> </td> <td> <div class="proposed correction"> <a>No `role`</a> if the `summary` element is a <a data-cite="html/interactive-elements.html#summary-for-its-parent-details">summary for its parent details</a>. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a>, `aria-disabled`, and `aria-haspopup` attributes. Otherwise, authors MAY specifiy <a>Any `role`</a>, and any <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </div> </td> </tr> <tr> <th id="el-sup" tabindex="-1"> [^sup^] </th> <td> <code>role=<a href="#index-aria-superscript">superscript</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-superscript">superscript</a></code> is NOT RECOMMENDED. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-svg" tabindex="-1"> <a data-cite="html/embedded-content-other.html#svg-0">`SVG`</a> </th> <td> `role=graphics-document` as defined by <a data-cite="svg-aam-1.0/#details-id-66">SVG AAM</a> </td> <td> <a>Any `role`</a>, though `graphics-document` is NOT RECOMMENDED. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-table" tabindex="-1"> [^table^] </th> <td> <code>role=<a href="#index-aria-table">table</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-table">table</a></code> is NOT RECOMMENDED. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-tbody" tabindex="-1"> [^tbody^] </th> <td> <code>role=<a href="#index-aria-rowgroup">rowgroup</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-rowgroup">rowgroup</a></code> is NOT RECOMMENDED. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-td" tabindex="-1"> [^td^] </th> <td> <code>role=<a href="#index-aria-cell">cell</a></code> if the ancestor `table` element is exposed as a `role=table` <code>role=<a href="#index-aria-gridcell">gridcell</a></code> if the ancestor `table` element is exposed as a `role=grid` or `treegrid` <a>No corresponding role</a> if the ancestor `table` element is not exposed as a `role=table`, `grid` or `treegrid` </td> <td> If the ancestor `table` element has `role=table`, `grid`, or `treegrid`, <a>no `role`</a> other than the following: <ul> <li>If the ancestor `table` element is exposed as a `role=table`, then <code><a href="#index-aria-cell">cell</a></code> is allowed, but NOT RECOMMENDED.</li> <li>If the ancestor `table` element is exposed as a `role=grid` or `treegrid`, then <code><a href="#index-aria-gridcell">gridcell</a></code> is allowed, but NOT RECOMMENDED.</li> </ul> Otherwise, if the ancestor `table` element is not exposed as a `role=table`, `grid` or `treegrid`, <a>any `role`</a>. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-template" tabindex="-1"> [^template^] </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> or `aria-*` attributes </td> </tr> <tr> <th id="el-textarea" tabindex="-1"> [^textarea^] </th> <td> <code>role=<a href="#index-aria-textbox">textbox</a></code> </td> <td> <a>No `role`</a> other than <code><a href="#index-aria-textbox">textbox</a></code>, which is NOT RECOMMENDED. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the `textbox` role. </td> </tr> <tr> <th id="el-tfoot" tabindex="-1"> [^tfoot^] </th> <td> <code>role=<a href="#index-aria-rowgroup">rowgroup</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-rowgroup">rowgroup</a></code> is NOT RECOMMENDED. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-th" tabindex="-1"> [^th^] </th> <td> <code>role=<a href="#index-aria-columnheader">columnheader</a></code>, <a href="#index-aria-rowheader">`rowheader`</a> or <a href="#index-aria-rowheader">`cell`</a> if the ancestor `table` element is exposed as a `role=table` <code>role=<a href="#index-aria-columnheader">columnheader</a></code>, <a href="#index-aria-rowheader">`rowheader`</a> or <a href="#index-aria-rowheader">`gridcell`</a> if the ancestor `table` element is exposed as a `role=grid` or `treegrid` <a>No corresponding role</a> if the ancestor `table` element is not exposed as a `role=table`, `grid` or `treegrid` </td> <td> If the ancestor `table` element has `role=table`, `grid`, or `treegrid`, <a>no `role`</a> other than the following: <ul> <li> If the ancestor `table` element is exposed as a `role=table`, then <code><a href="#index-aria-columnheader">columnheader</a></code>, <a href="#index-aria-rowheader">`rowheader`</a> and <a href="#index-aria-rowheader">`cell`</a> are allowed, but NOT RECOMMENDED. </li> <li> If the ancestor `table` element is exposed as a `role=grid` or `treegrid`, then <code><a href="#index-aria-columnheader">columnheader</a></code>, <a href="#index-aria-rowheader">`rowheader`</a> or <a href="#index-aria-rowheader">`gridcell`</a> are allowed, but NOT RECOMMENDED. </li> </ul> Otherwise, if the ancestor `table` element is not exposed as a `role=table`, `grid` or `treegrid`, <a>any `role`</a>. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-thead" tabindex="-1"> [^thead^] </th> <td> <code>role=<a href="#index-aria-rowgroup">rowgroup</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-rowgroup">rowgroup</a></code> is NOT RECOMMENDED. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-time" tabindex="-1"> [^time^] </th> <td> <code>role=<a href="#index-aria-time">time</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-time">time</a></code> is NOT RECOMMENDED. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-title" tabindex="-1"> [^title^] </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> or `aria-*` attributes </td> </tr> <tr> <th id="el-tr" tabindex="-1"> [^tr^] </th> <td> <code>role=<a href="#index-aria-row">row</a></code> </td> <td> If the ancestor `table` element has `role=table`, `grid`, or `treegrid`, <a>no `role`</a> other than <code><a href="#index-aria-row">row</a></code>, which is NOT RECOMMENDED; otherwise <a>any `role`</a>, though <code><a href="#index-aria-row">row</a></code> is NOT RECOMMENDED. <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-track" tabindex="-1"> [^track^] </th> <td> <a>No corresponding role</a> </td> <td> <a>No `role`</a> or `aria-*` attributes </td> </tr> <tr> <th id="el-u" tabindex="-1"> [^u^] </th> <td> <code>role=<a href="#index-aria-generic">generic</a></code> </td> <td> <a>Any `role`</a>, though <code><a href="#index-aria-generic">generic</a></code> SHOULD NOT be used. <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-ul" tabindex="-1"> [^ul^] </th> <td> <code>role=<a href="#index-aria-list">list</a></code> </td> <td> Roles: <a href="#index-aria-group">`group`</a>, <a href="#index-aria-listbox">`listbox`</a>, <a href="#index-aria-menu">`menu`</a>, <a href="#index-aria-menubar">`menubar`</a>, <a href="#index-aria-none">`none`</a>, <a href="#index-aria-presentation">`presentation`</a>, <a href="#index-aria-radiogroup">`radiogroup`</a>, <a href="#index-aria-tablist">`tablist`</a>, <a href="#index-aria-toolbar">`toolbar`</a> or <a href="#index-aria-tree">`tree`</a>. (<code><a href="#index-aria-list">list</a></code> is also allowed, but NOT RECOMMENDED.) <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. <div class="addition proposal"> Authors SHOULD NOT use the <a href="#docconformance-deprecated">deprecated</a> <a href="#index-aria-directory">`directory`</a> role. </div> </td> </tr> <tr> <th id="el-var" tabindex="-1"> [^var^] </th> <td> <a>No corresponding role</a> </td> <td> <a>Any `role`</a> <a>Naming Prohibited</a> Otherwise, <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a> and any `aria-*` attributes applicable to the allowed roles. </td> </tr> <tr> <th id="el-video" tabindex="-1"> [^video^] </th> <td> <a>No corresponding role</a> </td> <td> Role: <a href="#index-aria-application">`application`</a> <a data-cite="wai-aria-1.2#global_states">Global `aria-*` attributes</a> and any `aria-*` attributes applicable to the `application` role. </td> </tr> <tr> <th id="el-wbr" tabindex="-1"> [^wbr^] </th> <td> <a>No corresponding role</a> </td> <td> <div class="correction"> Roles: <a href="#index-aria-none">`none`</a> or <a href="#index-aria-presentation">`presentation`</a> Authors MAY specify the <a data-cite="wai-aria-1.2#aria-hidden">`aria-hidden`</a> attribute on the `wbr` element. Otherwise, no other allowed `aria-*` attributes. </div> </td> </tr> </tbody> </table> The elements marked with <dfn>No corresponding role</dfn>, in the second column of the table do not have any <a>implicit ARIA semantics</a>, but they do have meaning and this meaning may be represented in roles, states and properties not provided by ARIA, and exposed to users of assistive technology via accessibility APIs. It is therefore recommended that authors add a `role` attribute to a semantically neutral element such as a [^div^] or [^span^], rather than overriding the semantics of the listed elements. <div class="note"> Authors are encouraged to make use of the following documents for guidance on using ARIA in HTML beyond that which is provided here: <ul> <li>[[[using-aria]]] - A practical guide for authors on how to add accessibility information to HTML elements using the Accessible Rich Internet Applications specification. </li> <li>[[[wai-aria-practices-1.2]]] - An author's guide to understanding and implementing Accessible Rich Internet Applications. </li> </ul> </div> <aside class="example"> These features can be used to make accessibility tools render content to their users in more useful ways. For example, ASCII art, which is really an image, appears to be text, and in the absence of appropriate roles and properties would end up being rendered by screen readers as a nonsensical string of punctuation characters. Using the features described in this section, one can instead make the ATs skip the ASCII art and just read the caption: <pre> <figure> <pre role="img" aria-label="ASCII Fish"> o .'`/ ' / ( O .-'` ` `'-._ .') _/ (o) '. .' / ) ))) >< < `\ |_\ _.' '. \ '-._ _ .-' '.) jgs `\__\ </pre> <figcaption id="fish-caption"> Joan G. Stark, "<cite>fish</cite>". October 1997. ASCII on electrons. 28×8. </figcaption> </figure> </pre> </aside> <section class="addition"> <h3 id="docconformance-naming"> Requirements for use of ARIA attributes to name  elements </h3>  Authors MAY use <a data-cite="wai-aria-1.2/#aria-label">`aria-label`</a> and <a data-cite="wai-aria-1.2/#aria-labelledby">`aria-labelledby`</a> attributes to specify <a data-cite="accname-1.2/#dfn-accessible-name">accessible names</a> for elements which have an implicit or explicit ARIA role which allows naming from authors. [[[wai-aria-1.2]]] defines <a data-cite="wai-aria-1.2/#namefromauthor">roles which allow naming from authors</a> as well as <a data-cite="wai-aria-1.2/#namefromprohibited">roles where author naming is prohibited</a>. Authors MUST NOT specify `aria-label` or `aria-labelledby` on elements with implicit WAI-ARIA roles which cannot be named. HTML elements whose implicit WAI-ARIA roles prohibit naming from authors are identified in [[[#docconformance]]]. The following markup example demonstrates a selection of HTML elements with implicit ARIA roles that prohibit naming from authors. <pre class="HTML example" title="Elements with implicit ARIA roles which prohibit naming from authors">  ... ... <code aria-label="...">...<code> <div aria-labelledby="...">...</div> </pre> The following markup example demonstrates elements which have explicit WAI-ARIA roles which allow naming from authors. Due to the explicit roles specified on these elements, `aria-label` and `aria-labelledby` attributes are allowed. <pre class="HTML example" title="Elements with explicit ARIA roles which allow naming from authors"> ... ... <div role="article" aria-labelledby="...">...</div> </pre>  </section> <section> <h3 id="docconformance-attr"> Requirements for use of ARIA attributes in place of equivalent HTML attributes </h3> Unless otherwise stated, authors MAY use `aria-*` attributes in place of their HTML equivalents on HTML elements where the `aria-*` semantics would be expected. For example, authors MAY specify `aria-disabled=true` on a [^button^] element, while also implementing the necessary scripting to functionally disable the `button`, rather than the use `disabled` attribute. As stated in <a data-cite="wai-aria-1.2#host_general_conflict">WAI-ARIA's Conflicts with Host Language Semantics</a>, when HTML elements use both `aria-*` attributes and their host language (HTML) equivalents, user agents MUST ignore the WAI-ARIA attributes – the native HTML attributes with the same <a>implicit ARIA semantics</a> take precedence. For this reason, authors SHOULD NOT specify both the native HTML attribute and the equivalent `aria-*` attribute on an element. Please review each attribute for any further author specific requirements. The following table represents HTML elements and their attributes which have `aria-*` attribute parity. Each language feature (element and attribute) in a cell in the first column implies the ARIA semantics (states, and properties) given in the cell in the second column of the same row. The third cell in each row defines how authors can use the native HTML feature, along with requirements for using the `aria-*` attributes that supply the same <a>implicit ARIA semantics</a>. <table class="simple"> <caption> Rules of ARIA attribute usage by HTML feature </caption> <thead> <tr> <th> HTML feature </th> <th> Implicit ARIA semantics </th> <th> HTML feature and `aria-*` attribute author guidance </th> </tr> </thead> <tbody> <tr id="att-checked" tabindex="-1"> <th> Any element where the [^input/checked^] attribute is allowed </th> <td> `aria-checked="true"` </td> <td> <div class="correction"> Use the `checked` attribute on any element that is allowed the `checked` attribute in HTML. Use the <a data-cite="html/input.html#dom-input-indeterminate">`indeterminate`</a> IDL attribute to indicate the "mixed" state for <a data-cite="html/input.html#checkbox-state-(type=checkbox)">`input type=checkbox`</a> elements. Authors MUST NOT use the <a data-cite="wai-aria-1.2#aria-checked">`aria-checked`</a> attribute on any element where the <a data-cite="html/form-control-infrastructure.html#concept-fe-checked">checkedness</a>, or the indeterminate checked value of the element can be in opposition to the current value of the `aria-checked` attribute. </div> Authors MAY use the `aria-checked` attribute on any other element with a WAI-ARIA role which allows the attribute. </td> </tr> <tr id="att-disabled" tabindex="-1"> <th> Any element where the [^input/disabled^] attribute is allowed, including `option` [^option/disabled^] and `optgroup` [^optgroup/disabled^] </th> <td> `aria-disabled="true"` </td> <td> Use the `disabled` attribute on any element that is allowed the `disabled` attribute in HTML. Authors MAY use the <a data-cite="wai-aria-1.2#aria-disabled">`aria-disabled`</a> attribute on any element that is allowed the `disabled` attribute in HTML, or any element with a WAI-ARIA role which allows the `aria-disabled` attribute</a>. Authors SHOULD NOT use `aria-disabled="true"` on any element which also has a `disabled` attribute. Authors MUST NOT use `aria-disabled="false"` on any element which also has a `disabled` attribute. </td> </tr> <tr id="att-hidden" tabindex="-1"> <th> Any element with a [^html-global/hidden^] attribute </th> <td> `aria-hidden="true"` </td> <td> Authors MAY use the <a data-cite="wai-aria-1.2#aria-hidden">`aria-hidden`</a> attribute on any HTML element that allows <a data-cite="wai-aria-1.2#global_states">global `aria-*` attributes</a>, with the following exception: Authors SHOULD NOT use the `aria-hidden="true"` attribute on any element which also has a `hidden` attribute.   </td> </tr> <tr id="att-placeholder" tabindex="-1"> <th> Any element where the [^input/placeholder^] attribute is allowed </th> <td> `aria-placeholder="..."` </td> <td> Use the `placeholder` attribute on any element that is allowed the `placeholder` attribute in HTML. Authors MAY use the <a data-cite="wai-aria-1.2#aria-placeholder">`aria-placeholder`</a> attribute on any element that is allowed the `placeholder` attribute in HTML, or any element with a WAI-ARIA role which allows the `aria-placeholder` attribute. Authors MUST NOT use the `aria-placeholder` attribute on any element which also has a `placeholder` attribute. </td> </tr> <tr id="att-max" tabindex="-1"> <th> Any element where the `max` attribute is allowed: `meter` [^meter/max^], `progress` [^progress/max^], and `input` [^input/max^] </th> <td> `aria-valuemax="..."` </td> <td> Use the `max` attribute on any element that is allowed the `max` attribute in HTML. Authors MAY use the <a data-cite="wai-aria-1.2#aria-valuemax">`aria-valuemax`</a> attribute on any other element with a WAI-ARIA role which allows the `aria-valuemax` attribute. Authors SHOULD NOT use `aria-valuemax` on any element which allows the `max` attribute. Use the `max` attribute instead. Authors MUST NOT use `aria-valuemax` on any element which also has a `max` attribute. </td> </tr> <tr id="att-min" tabindex="-1"> <th> Any element where the `min` attribute is allowed: `meter` [^meter/min^] and `input` [^input/min^] </th> <td> `aria-valuemin="..."` </td> <td> Use the `min` attribute on any element that is allowed the `min` attribute in HTML. Authors MAY use the <a data-cite="wai-aria-1.2#aria-valuemax">`aria-valuemin`</a> attribute on any other element with a WAI-ARIA role which allows the `aria-valuemin` attribute. Authors SHOULD NOT use `aria-valuemin` on any element which allows the `min` attribute. Use the `min` attribute instead. Authors MUST NOT use `aria-valuemin` on any element which also has a `min` attribute. </td> </tr> <tr id="att-readonly" tabindex="-1"> <th> Any element which allows the `readonly` attribute: `input` [^input/readonly^], `textarea` [^textarea/readonly^] and <a>form-associated custom element</a> which allows [^form-associated custom elements/readonly^] </th> <td> `aria-readonly="true"` </td> <td> Use the `readonly` attribute on any element that is allowed the `readonly` attribute in HTML. Authors MAY use the <a data-cite="wai-aria-1.2#aria-readonly">`aria-readonly`</a> attribute on any element with a WAI-ARIA role which allows the attribute</a>. Authors SHOULD NOT use the `aria-readonly="true"` on any element which also has a `readonly` attribute. Authors MUST NOT use `aria-readonly="false"` on any element which also has a `readonly` attribute. </td> </tr> <tr id="att-contenteditable" tabindex="-1"> <th> Element with [^html-global/contenteditable^]`=true` or element without `contenteditable` attribute whose closest ancestor with a `contenteditable` attribute has `contenteditable="true"`. This is equivalent to the <a data-cite= "html/interaction.html#dom-iscontenteditable">`isContentEditable`</a> IDL attribute. </th> <td> `aria-readonly="false"` </td> <td> Authors MUST NOT set `aria-readonly="true"` on an element that has `isContentEditable="true"`. </td> </tr> <tr id="att-required" tabindex="-1"> <th> Any element where the `required` attribute is allowed: `input` [^input/required^], `textarea` [^textarea/required^], and `select` [^select/required^] </th> <td> `aria-required="true"` </td> <td> Use the `required` attribute on any element that is allowed the `required` attribute in HTML. Authors MAY use the <a data-cite="wai-aria-1.2#aria-required">`aria-required`</a> attribute on any element that is allowed the `required` attribute in HTML, or any element with a WAI-ARIA role which allows the `aria-required` attribute. Authors SHOULD NOT use the `aria-required="true"` on any element which also has a `required` attribute. Authors MUST NOT use `aria-required="false"` on any element which also has a `required` attribute. </td> </tr> <tr id="att-colspan" tabindex="-1"> <th> Any element where the [^th/colspan^] attribute is allowed: `td` and `th` </th> <td> `aria-colspan="..."` </td> <td> Use the `colspan` attribute on any element that is allowed the `colspan` attribute in HTML.  Authors SHOULD NOT use the `aria-colspan` attribute on any element which also has a `colspan` attribute. Authors MUST NOT use `aria-colspan` on any element which also has a `colspan` attribute, and the values of each attribute do not match. </td> </tr> <tr id="att-rowspan" tabindex="-1"> <th> Any element where the [^th/rowspan^] attribute is allowed: `td` and `th` </th> <td> `aria-rowspan="..."` </td> <td> Use the `rowspan` attribute on any element that is allowed the `rowspan` attribute in HTML.  Authors SHOULD NOT use the `aria-rowspan` attribute on any element which also has a `rowspan` attribute. Authors MUST NOT use `aria-rowspan` on any element which also has a `rowspan` attribute, and the values of each attribute do not match. </td> </tr> </tbody> </table> </section> <section class="addition"> <h2 id="docconformance-deprecated"> Requirements for deprecated ARIA role, state and property and attributes </h2> The ARIA Specification's <a data-cite="wai-aria-1.2#deprecated">Deprecated Requirements</a> section indicates that if an ARIA feature is marked as deprecated then authors are advised not to use said feature for new content. The following roles and attributes are deprecated features of ARIA and DPub ARIA. Conformance checkers MUST warn authors about the deprecated status of these features. Whenever possible, authors are advised to use alternatives to deprecated features. <h3>Deprecated ARIA roles</h3> <ul> <li><a data-cite="wai-aria-1.2#directory">`directory`</a></li> </ul> <div class="note"> The `directory` role is marked for deprecation in [[wai-aria-1.2|WAI-ARIA 1.2]]. In reality, the `directory` role had no functional difference to an element with an implicit or explicit `list` role. Authors are advised to use one of HTML's native list elements, or an ARIA `list` instead. </div> <h3>Deprecated DPub ARIA roles</h3> <ul> <li><a data-cite="dpub-aria-1.1#doc-biblioentry">`doc-biblioentry`</a></li> <li><a data-cite="dpub-aria-1.1#doc-endnote">`doc-endnote`</a></li> </ul> <div class="note"> The `doc-biblioentry` and `doc-endnote` roles are marked for deprecation in [[[dpub-aria-1.1]]], as they are not valid children for an element with an implicit or explicit role of `list`. Authors can use standard list and child `li` elements without the need for these roles. </div> <h3>Deprecated ARIA attributes</h3> <ul> <li><a data-cite="wai-aria-1.1#aria-dropeffect">`aria-dropeffect`</a></li> <li><a data-cite="wai-aria-1.1#aria-grabbed">`aria-grabbed`</a></li> </ul> <div class="note"> The `aria-dropeffect` and `aria-grabbed` attributes were deprecated in [[wai-aria-1.1|WAI-ARIA 1.1]]. There is presently no feature in ARIA to replace their proposed functionality. </div> </section> <section> <h2 id="case-sensitivity"> Case requirements for ARIA role, state and property attributes </h2> Authors SHOULD use [=ASCII lowercase=] for all `role` token values and any state or property attributes (`aria-*`) whose values are <a data-cite="wai-aria-1.2#propcharacteristic_value">defined as tokens</a>. <div class="note"> While modern browsers treat the `role` or `aria-*` attribute values as [=ASCII case-insensitive=], not all assistive technologies will correctly parse these values. To reduce interoperability issues, authors are strongly encouraged to use [=ASCII lowercase=] for `aria-*` and `role` attribute values. Further, authors are encouraged to rigorously test with different browser and assistive technology combinations to ensure that their content will be correctly exposed to their users. </div> <aside class="example"> Correct (conforming) examples: <pre> <div role="main">...</div> <a href="home/" aria-current="page">home</a> </pre> Incorrect (non-conforming) examples: <pre> <div role="MAIN">...</div> <div role="Main">...</div> <a href="home/" aria-current="Page">home</a> </pre> </aside> </section> </section> <section class="informative"> <h2> Allowed descendants of ARIA roles </h2> The following table maps (and extends) the <a data-cite= "html/dom.html#kinds-of-content">Kinds of content</a> and allowed descendant information (defined in the [[HTML]] specification) to elements that have an equivalent `role`. Column 1 links to the normative [[[wai-aria-1.2]]] definitions for each ARIA `role`. Column 2 identifies the <a data-cite="html/dom.html#kinds-of-content">Kinds of content</a> categories each `role` has when it is used on an HTML element. Column 3 indicates what kinds of HTML elements can be descendants of an element with an explicit `role` specified, often matching the HTML element with the same <a href="#implicit">implicit</a> role. For example, a [^button^] element has an implicit `role=button`. In HTML a `button` element allows [=phrasing content=] as descendants, and does not allow [=interactive content=] or descendants with a `tabindex` attribute. Therefore, any elements specified with a `role=button` would follow the same descendant restrictions, and not allow any interactive content descendants, elements with a `tabindex` specified, or any elements with role values that are in the interactive content category (identified in column 3). <div class="example" id="bad-descendants"> Examples of non-conforming descendants <pre> <button> <div role="button">...</div> </button> <div role="button"> <button>...</button> </div> <div role="link"> <textarea>...</textarea> </div> </pre> </div> Additionally, there are certain roles which [[[wai-aria-1.2]]] has specified specific requirements for their allowed descendants. These have been identified in column 3 (Descendant allowances) by indicating to "Refer to the 'Required Owned Elements'" for those particular roles. <table id="aria-table" class="simple"> <caption> Allowed descendants of ARIA roles </caption> <thead> <tr> <th> Role </th> <th> Kind of content </th> <th> Descendant allowances </th> </tr> </thead> <tbody> <tr> <th tabindex="-1" id="index-aria-alert"> <a data-cite="wai-aria-1.2#alert">`alert`</a> </th> <td> [=Flow content=] </td> <td> [=Flow content=] but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-alertdialog"> <a data-cite="wai-aria-1.2#alertdialog">`alertdialog`</a> </th> <td> [=Flow content=] </td> <td> [=Flow content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-application"> <a data-cite="wai-aria-1.2#application">`application`</a> </th> <td> [=Flow content=] </td> <td> [=Flow content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-article"> <a data-cite="wai-aria-1.2#article">`article`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Sectioning content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Flow content=] but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-banner"> <a data-cite="wai-aria-1.2#banner">`banner`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Flow content=] but with no <a>main</a>, <a>header</a>, or <a>footer</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-blockquote"> <a data-cite="wai-aria-1.2#blockquote">`blockquote`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Flow content=] but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-button"> <a data-cite="wai-aria-1.2#button">`button`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Phrasing content=]</li> <li>[=Interactive content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Phrasing content=], but with no [=interactive content=] descendants, and no descendants with a `tabindex` attribute specified. </td> </tr> <tr> <th tabindex="-1" id="index-aria-caption"> <a data-cite="wai-aria-1.2#caption">`caption`</a> </th> <td> N/A </td> <td> [=Flow content=] but with no <a>main</a> or <a>table</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-cell"> <a data-cite="wai-aria-1.2#cell">`cell`</a> </th> <td> N/A </td> <td> [=Flow content=] but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-checkbox"> <a data-cite="wai-aria-1.2#checkbox">`checkbox`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Phrasing content=]</li> <li>[=Interactive content=]</li> </ul> </td> <td> [=Phrasing content=], but with no [=interactive content=] descendants, and no descendants with a `tabindex` attribute specified. </td> </tr> <tr> <th tabindex="-1" id="index-aria-code"> <a data-cite="wai-aria-1.2#code">`code`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Phrasing content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Phrasing content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-columnheader"> <a data-cite="wai-aria-1.2#columnheader">`columnheader`</a> </th> <td> N/A </td> <td> [=Flow content=] but with no <a>main</a>, <a>header</a>, or <a>footer</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-combobox"> <a data-cite="wai-aria-1.2#combobox">`combobox`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Phrasing content=]</li> <li>[=Interactive content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Flow content=] but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-complementary"> <a data-cite="wai-aria-1.2#complementary">`complementary`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Sectioning content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Flow content=] but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-contentinfo"> <a data-cite="wai-aria-1.2#contentinfo">`contentinfo`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Flow content=] but with no <a>main</a>, <a>header</a>, or <a>footer</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-definition"> <a data-cite="wai-aria-1.2#definition">`definition`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Phrasing content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Phrasing content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-deletion"> <a data-cite="wai-aria-1.2#deletion">`deletion`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Phrasing content=]</li> </ul> </td> <td> [=Phrasing content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-dialog"> <a data-cite="wai-aria-1.2#dialog">`dialog`</a> </th> <td> [=Flow content=] </td> <td> [=Flow content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-directory"> <a data-cite="wai-aria-1.2#directory">`directory`</a> </th> <td> [=Flow content=] </td> <td>  [=Flow content=] but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-document"> <a data-cite="wai-aria-1.2#document">`document`</a> </th> <td> [=Flow content=] </td> <td> [=Flow content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-emphasis"> <a data-cite="wai-aria-1.2#emphasis">`emphasis`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Phrasing content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Phrasing content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-feed"> <a data-cite="wai-aria-1.2#feed">`feed`</a> </th> <td> [=Flow content=] </td> <td> [=Flow content=] but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-figure"> <a data-cite="wai-aria-1.2#figure">`figure`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Flow content=] but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-form"> <a data-cite="wai-aria-1.2#form">`form`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Flow content=], but with no [^form^] element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-generic"> <a data-cite="wai-aria-1.2#generic">`generic`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Phrasing content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Flow content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-grid"> <a data-cite="wai-aria-1.2#grid">`grid`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Interactive content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> Refer to the "Required Owned Elements" as defined for the ARIA <a data-cite="wai-aria-1.2#grid">`grid`</a> role. </td> </tr> <tr> <th tabindex="-1" id="index-aria-gridcell"> <a data-cite="wai-aria-1.2#gridcell">`gridcell`</a> </th> <td> [=Interactive content=] </td> <td> [=Flow content=] but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-group"> <a data-cite="wai-aria-1.2#group">`group`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Flow content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-heading"> <a data-cite="wai-aria-1.2#heading">`heading`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Heading content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Phrasing content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-img"> <a data-cite="wai-aria-1.2#img">`img`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Phrasing content=]</li> <li>[=Embedded content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Phrasing content=], but with no [=interactive content=] descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-insertion"> <a data-cite="wai-aria-1.2#insertion">`insertion`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Phrasing content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Phrasing content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-link"> <a data-cite="wai-aria-1.2#link">`link`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Phrasing content=]</li> <li>[=Interactive content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Flow content=], but with no [=interactive content=] descendants, and no descendants with a `tabindex` attribute specified. </td> </tr> <tr> <th tabindex="-1" id="index-aria-list"> <a data-cite="wai-aria-1.2#list">`list`</a> </th> <td> [=Flow content=] </td> <td> Refer to the "Required Owned Elements" as defined for the ARIA <a data-cite="wai-aria-1.2#list">`list`</a> role. </td> </tr> <tr> <th tabindex="-1" id="index-aria-listbox"> <a data-cite="wai-aria-1.2#listbox">`listbox`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Interactive content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> Refer to the "Required Owned Elements" as defined for the ARIA <a data-cite="wai-aria-1.2#listbox">`listbox`</a> role. </td> </tr> <tr> <th tabindex="-1" id="index-aria-listitem"> <a data-cite="wai-aria-1.2#listitem">`listitem`</a> </th> <td> N/A </td> <td> [=Flow content=] but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-log"> <a data-cite="wai-aria-1.2#log">`log`</a> </th> <td> [=Flow content=] </td> <td> [=Flow content=], but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-main"> <a data-cite="wai-aria-1.2#main">`main`</a> </th> <td> [=Flow content=] </td> <td> [=Flow content=], but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-marquee"> <a data-cite="wai-aria-1.2#marquee">`marquee`</a> </th> <td> [=Flow content=] </td> <td> [=Flow content=], but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-math"> <a data-cite="wai-aria-1.2#math">`math`</a> </th> <td> [=Flow content=] </td> <td> [=Flow content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-menu"> <a data-cite="wai-aria-1.2#menu">`menu`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Interactive content=]</li> </ul> </td> <td> Refer to the "Required Owned Elements" as defined for the ARIA <a data-cite="wai-aria-1.2#menu">`menu`</a> role. </td> </tr> <tr> <th tabindex="-1" id="index-aria-menubar"> <a data-cite="wai-aria-1.2#menubar">`menubar`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Interactive content=]</li> </ul> </td> <td> Refer to the "Required Owned Elements" as defined for the ARIA <a data-cite="wai-aria-1.2#menubar">`menubar`</a> role. </td> </tr> <tr> <th tabindex="-1" id="index-aria-menuitem"> <a data-cite="wai-aria-1.2#menuitem">`menuitem`</a> </th> <td> [=Interactive content=] </td> <td> [=Phrasing content=], but with no [=interactive content=] descendants, and no descendants with a `tabindex` attribute specified. </td> </tr> <tr> <th tabindex="-1" id="index-aria-menuitemcheckbox"> <a data-cite="wai-aria-1.2#menuitemcheckbox">`menuitemcheckbox`</a> </th> <td> [=Interactive content=] </td> <td> [=Phrasing content=], but with no [=interactive content=] descendants, and no descendants with a `tabindex` attribute specified. </td> </tr> <tr> <th tabindex="-1" id="index-aria-menuitemradio"> <a data-cite="wai-aria-1.2#menuitemradio">`menuitemradio`</a> </th> <td> [=Interactive content=] </td> <td> [=Phrasing content=], but with no [=interactive content=] descendants, and no descendants with a `tabindex` attribute specified. </td> </tr> <tr> <th tabindex="-1" id="index-aria-meter"> <a data-cite="wai-aria-1.2#meter">`meter`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Phrasing content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Phrasing content=], but with no <a>meter</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-navigation"> <a data-cite="wai-aria-1.2#navigation">`navigation`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Sectioning content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Flow content=], but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-none"> <a data-cite="wai-aria-1.2#none">`none`</a> </th> <td> N/A </td> <td> <a data-cite="html/dom.html#transparent-content-models">Transparent</a> </td> </tr> <tr> <th tabindex="-1" id="index-aria-note"> <a data-cite="wai-aria-1.2#note">`note`</a> </th> <td> [=Flow content=] </td> <td> [=Flow content=], but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-option"> <a data-cite="wai-aria-1.2#option">`option`</a> </th> <td> [=Interactive content=] </td> <td> [=Phrasing content=], but with no [=interactive content=] descendants, and no descendants with a `tabindex` attribute specified. </td> </tr> <tr> <th tabindex="-1" id="index-aria-paragraph"> <a data-cite="wai-aria-1.2#paragraph">`paragraph`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Phrasing content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-presentation"> <a data-cite="wai-aria-1.2#presentation">`presentation`</a> </th> <td> N/A </td> <td> <a data-cite="html/dom.html#transparent-content-models">Transparent</a> </td> </tr> <tr> <th tabindex="-1" id="index-aria-progressbar"> <a data-cite="wai-aria-1.2#progressbar">`progressbar`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Phrasing content=]</li> </ul> </td> <td> [=Phrasing content=], but with no <a>progress</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-radio"> <a data-cite="wai-aria-1.2#radio">`radio`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Phrasing content=]</li> <li>[=Interactive content=]</li> </ul> </td> <td> [=Phrasing content=], but with no [=interactive content=] descendants, and no descendants with a `tabindex` attribute specified. </td> </tr> <tr> <th tabindex="-1" id="index-aria-radiogroup"> <a data-cite="wai-aria-1.2#radiogroup">`radiogroup`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Flow content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-region"> <a data-cite="wai-aria-1.2#region">`region`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Sectioning content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Flow content=], but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-row"> <a data-cite="wai-aria-1.2#row">`row`</a> </th> <td> N/A </td> <td> Refer to the "Required Owned Elements" as defined for the ARIA <a data-cite="wai-aria-1.2#row">`row`</a> role. </td> </tr> <tr> <th tabindex="-1" id="index-aria-rowgroup"> <a data-cite="wai-aria-1.2#rowgroup">`rowgroup`</a> </th> <td> N/A </td> <td> Refer to the "Required Owned Elements" as defined for the ARIA <a data-cite="wai-aria-1.2#rowgroup">`rowgroup`</a> role. </td> </tr> <tr> <th tabindex="-1" id="index-aria-rowheader"> <a data-cite="wai-aria-1.2#rowheader">`rowheader`</a> </th> <td> N/A </td> <td> [=Flow content=] but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-scrollbar"> <a data-cite="wai-aria-1.2#scrollbar">`scrollbar`</a> </th> <td> [=Interactive content=] </td> <td> [=Phrasing content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-search"> <a data-cite="wai-aria-1.2#search">`search`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Flow content=] but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-searchbox"> <a data-cite="wai-aria-1.2#searchbox">`searchbox`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Phrasing content=]</li> <li>[=Interactive content=]</li> </ul> </td> <td> [=Flow content=] but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-separator"> <a data-cite="wai-aria-1.2#separator">`separator`</a> </th> <td> [=Interactive content=] (if focusable) </td> <td> [=Phrasing content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-slider"> <a data-cite="wai-aria-1.2#slider">`slider`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Phrasing content=]</li> <li>[=Interactive content=]</li> </ul> </td> <td> [=Phrasing content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-spinbutton"> <a data-cite="wai-aria-1.2#spinbutton">`spinbutton`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Phrasing content=]</li> <li>[=Interactive content=]</li> </ul> </td> <td> [=Flow content=] but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-status"> <a data-cite="wai-aria-1.2#status">`status`</a> </th> <td> [=Flow content=] </td> <td> [=Flow content=] but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-strong"> <a data-cite="wai-aria-1.2#strong">`strong`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Phrasing content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Phrasing content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-subscript"> <a data-cite="wai-aria-1.2#subscript">`subscript`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Phrasing content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Phrasing content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-superscript"> <a data-cite="wai-aria-1.2#superscript">`superscript`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Phrasing content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Phrasing content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-switch"> <a data-cite="wai-aria-1.2#switch">`switch`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Phrasing content=]</li> <li>[=Interactive content=]</li> </ul> </td> <td> [=Phrasing content=], but with no [=interactive content=] descendants, and no descendants with a `tabindex` attribute specified. </td> </tr> <tr> <th tabindex="-1" id="index-aria-tab"> <a data-cite="wai-aria-1.2#tab">`tab`</a> </th> <td> [=Interactive content=] </td> <td> [=Phrasing content=], but with no [=interactive content=] descendants, and no descendants with a `tabindex` attribute specified. </td> </tr> <tr> <th tabindex="-1" id="index-aria-table"> <a data-cite="wai-aria-1.2#table">`table`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> Refer to the "Required Owned Elements" as defined for the ARIA <a data-cite="wai-aria-1.2#table">`table`</a> role. </td> </tr> <tr> <th tabindex="-1" id="index-aria-tablist"> <a data-cite="wai-aria-1.2#tablist">`tablist`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> Refer to the "Required Owned Elements" as defined for the ARIA <a data-cite="wai-aria-1.2#tablist">`tablist`</a> role. </td> </tr> <tr> <th tabindex="-1" id="index-aria-tabpanel"> <a data-cite="wai-aria-1.2#tabpanel">`tabpanel`</a> </th> <td> [=Flow content=] </td> <td> [=Flow content=] </td> </tr> <tr> <th id="index-aria-term" tabindex="-1"> <a data-cite="wai-aria-1.2#term">`term`</a> </th> <td> [=Phrasing content=] </td> <td> [=Phrasing content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-textbox"> <a data-cite="wai-aria-1.2#textbox">`textbox`</a> </th> <td> [=Interactive content=] </td> <td> [=Flow content=] but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-time"> <a data-cite="wai-aria-1.2#time">`time`</a> </th> <td> <ul> <li>[=Flow content=]</li> <li>[=Phrasing content=]</li> <li>[=Palpable content=]</li> </ul> </td> <td> [=Phrasing content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-timer"> <a data-cite="wai-aria-1.2#timer">`timer`</a> </th> <td> [=Flow content=] </td> <td> [=Flow content=] but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-toolbar"> <a data-cite="wai-aria-1.2#toolbar">`toolbar`</a> </th> <td> [=Flow content=] </td> <td> [=Flow content=] but with no <a>main</a> element descendants. </td> </tr> <tr> <th tabindex="-1" id="index-aria-tooltip"> <a data-cite="wai-aria-1.2#tooltip">`tooltip`</a> </th> <td> [=Flow content=] </td> <td> [=Phrasing content=] </td> </tr> <tr> <th tabindex="-1" id="index-aria-tree"> <a data-cite="wai-aria-1.2#tree">`tree`</a> </th> <td> [=Flow content=] </td> <td> Refer to the "Required Owned Elements" as defined for the ARIA <code><a data-cite="wai-aria-1.2#tree">tree</a></code> role. </td> </tr> <tr> <th tabindex="-1" id="index-aria-treegrid"> <a data-cite="wai-aria-1.2#treegrid">`treegrid`</a> </th> <td> [=Flow content=] </td> <td> Refer to the "Required Owned Elements" as defined for the ARIA <code><a data-cite="wai-aria-1.2#treegrid">treegrid</a></code> role. </td> </tr> <tr> <th tabindex="-1" id="index-aria-treeitem"> <a data-cite="wai-aria-1.2#treeitem">`treeitem`</a> </th> <td> [=Interactive content=] </td> <td> [=Phrasing content=] </td> </tr> </tbody> </table> </section> <section id="conformance"> <h2>Conformance checking requirements</h2> Conformance checkers that claim support for checking ARIA in HTML documents MUST implement checks for the conformance requirements for use of the ARIA `role` and `aria-*` attributes on [=HTML elements=] as defined in this specification. A conforming document MUST NOT contain any elements with author defined `role` or `aria-*` attributes with values other than those which, per this specification, authors MAY use on each [=HTML element=] in [[[#docconformance]]]. Conformance checkers SHOULD flag instances where authors are explicitly providing an element with a `role` which matches its <a data-cite="wai-aria-1.2#implicit_semantics">implicit ARIA semantics</a> as failures, as it is NOT RECOMMENDED for authors to explicitly set these roles. A conformance checker MAY define their own terminology, and level or levels of severity, when surfacing document failures to conform to this specification. </section> <section id="priv-sec" class="informative"> <h2> Privacy and security considerations </h2> This specification does not define the features of [[wai-aria-1.2]], [[dpub-aria-1.0]] or [[HTML]]. Rather it provides rules and guidance for conformance checkers that claim support for checking ARIA in HTML, as well as providing guidance to authors. Therefore, there are no known privacy or security impacts of this specification, as it defines no new features to introduce potential concern. </section> </body> </html>

CINXE.COM

ARIA in HTML