{"id":157,"date":"2024-05-22T14:52:06","date_gmt":"2024-05-22T14:52:06","guid":{"rendered":"https:\/\/html5accessibility.com\/stuff\/?p=157"},"modified":"2025-06-15T14:40:47","modified_gmt":"2025-06-15T14:40:47","slug":"not-so-short-note-on-aria-label-usage-big-table-edition","status":"publish","type":"post","link":"https:\/\/html5accessibility.com\/stuff\/2024\/05\/22\/not-so-short-note-on-aria-label-usage-big-table-edition\/","title":{"rendered":"Not so short note on aria-label usage &#8211; Big Table Edition"},"content":{"rendered":"<figure id=\"attachment_161\" aria-describedby=\"caption-attachment-161\" style=\"width: 833px\" class=\"wp-caption alignnone\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-161 size-full\" src=\"https:\/\/html5accessibility.com\/stuff\/wp-content\/uploads\/2020\/10\/ds2.jpg\" alt=\"David appears in my office through the wonder of the interwebs\" width=\"833\" height=\"469\" srcset=\"https:\/\/html5accessibility.com\/stuff\/wp-content\/uploads\/2020\/10\/ds2.jpg 833w, https:\/\/html5accessibility.com\/stuff\/wp-content\/uploads\/2020\/10\/ds2-300x169.jpg 300w, https:\/\/html5accessibility.com\/stuff\/wp-content\/uploads\/2020\/10\/ds2-768x432.jpg 768w\" sizes=\"auto, (max-width: 833px) 100vw, 833px\" \/><figcaption id=\"caption-attachment-161\" class=\"wp-caption-text\">An audience with Dr David Swallow wherein he outlines the existential threat to native labeling mechanisms posed by the use of aria-label.<\/figcaption><\/figure>\n<p><strong>Updated:<\/strong> 15 June 2025<\/p>\n<p><code>aria-label<\/code> is one of a number of secondary methods to label native HTML UI elements. It works particularly well on interactive elements, it also works well on most block level elements <sup><em>old skool<\/em> term<\/sup> that have explicitly or implicitly defined structural roles. It works less well or <strong>not at all<\/strong> on <a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#text-level-semantics\">text level semantics<\/a>. It is prohibited <em>as are<\/em> any form of accessible name on a <a href=\"https:\/\/w3c.github.io\/aria\/#namefromprohibited\">whole <strong>slew<\/strong> of roles<\/a>.<\/p>\n<p class=\"note\"><strong>Implicit roles<\/strong> are those <a href=\"https:\/\/w3c.github.io\/html-aam\/#html-element-role-mappings\">applied automatically by browsers<\/a> to native HTML elements.<\/p>\n<p class=\"note\"><strong>Explicit roles<\/strong> are those applied by developers using the <code>role<\/code> attribute. When applied they override the implicit role of an element.<\/p>\n<h2>(Somewhat out of place here) general rules\u00a0 for labeling<\/h2>\n<ol>\n<li>Prefer visible over hidden labels\n<ol>\n<li>Prefer text labels over icons<\/li>\n<li>If icons are used provide a supplementary text label ( may be displayed on focus\/hover)<\/li>\n<\/ol>\n<\/li>\n<li>Place visible labels as expected:\n<ol>\n<li>For a checkbox or radio button, place the label immediately after the field.<\/li>\n<li>If\u00a0 not a checkbox or radio button, place the label immediately before the field.<\/li>\n<\/ol>\n<\/li>\n<li>Prefer native HTML labeling mechanisms, for Native HTML controls, over ARIA labeling mechanisms.<\/li>\n<\/ol>\n<p class=\"note\"><strong>Never be tempted<\/strong> to use <a href=\"https:\/\/codepen.io\/stevef\/post\/placeholder-the-piss-take-label\">placeholder text as a label<\/a>. <strong>It SUX<\/strong>.<\/p>\n<h2>Questions on aria-label usage<\/h2>\n<p>I find myself regularly asking these questions in regards to <code>aria-label<\/code>:<\/p>\n<ol>\n<li>Is it a good idea to use <code>aria-label<\/code> on element <em>X<\/em>?<\/li>\n<li>Does <code>aria-label<\/code> work as expected <em>i.e<\/em> is announced by screen readers on element <em>Z?<\/em><\/li>\n<li>Is <code>aria-label<\/code> allowed on element <em>Y<\/em>?<\/li>\n<\/ol>\n<p class=\"note\">FYI <em>empty<\/em> <code>aria-label=\"\"<\/code> does not equal <em>empty<\/em> <code>alt=\"\"<\/code>, the latter signals that an <code>img<\/code> element has no useful information, the former does nothing.<\/p>\n<p class=\"note\"><code>aria-label<\/code> masks any other accessible name source except <code>aria-labelledby<\/code>, which masks all others including <code>aria-label<\/code>.<\/p>\n<p>For HTML elements I have provided some guidance on <code>aria-label<\/code> usage (which by all means you may disagree with):<\/p>\n<p>&nbsp;<\/p>\n<h3><strong>Table header info:<\/strong><\/h3>\n<ul>\n<li><strong>Column 1<\/strong>: name of HTML element linked to HTML specification<\/li>\n<li><strong>Column 2<\/strong>: &#8220;Name from&#8221; info pulled from <a href=\"https:\/\/www.w3.org\/TR\/wai-aria\/\">ARIA 1.2<\/a><\/li>\n<li><strong>Column 3<\/strong>: If &#8220;Name from: Prohibited&#8221; or the element does not have\u00a0 visible UI, or it is not currently well supported, or there is a native HTML attribute that provides the acc name, then it&#8217;s a <strong>No<\/strong><\/li>\n<li><strong>Column 4<\/strong>: Notes<\/li>\n<\/ul>\n<table class=\"simple\" border=\"\">\n<caption>Could I use aria-label?<\/caption>\n<tbody>\n<tr>\n<th width=\"181\">HTML element<\/th>\n<th width=\"125\">Name from:<\/th>\n<th width=\"66\">aria-label<\/th>\n<th width=\"1143\">notes<\/th>\n<\/tr>\n<\/tbody>\n<tbody>\n<tr id=\"el-a\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-a-element\"><code>a<\/code><\/a> with <a href=\"https:\/\/html.spec.whatwg.org\/multipage\/links.html#attr-hyperlink-href\"><code>href<\/code><\/a><\/td>\n<td class=\"yes\">contents or author<\/td>\n<td class=\"yes\">yes<\/td>\n<td>\u26a0 \ud83d\ude37 Masks text content, so only <code>aria-label<\/code> is announced:<\/p>\n<p><code>&lt;a href=\"home.html\" aria-label=\"some text\"&gt;<s>home page<\/s>&lt;\/a&gt;<\/code><\/p>\n<p>Be wary of <a href=\"https:\/\/www.w3.org\/TR\/WCAG21\/#label-in-name\">label in name<\/a> issues<\/td>\n<\/tr>\n<tr id=\"el-a-no-href\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-a-element\"><code>a<\/code><\/a> without <a href=\"https:\/\/html.spec.whatwg.org\/multipage\/links.html#attr-hyperlink-href\"><code>href<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td><code>a<\/code> without <code>href<\/code> is not a link and not exposed as a <code>link<\/code>. Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-abbr\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-abbr-element\"><code>abbr<\/code><\/a><\/td>\n<td class=\"no\"><span class=\"yes\">contents or author<\/span><\/td>\n<td class=\"no\">no<\/td>\n<td>\u26a0<code>title<\/code> attribute works but announcement is a user preference in some screen readers (off by default). Refer to <a href=\"https:\/\/developer.paciellogroup.com\/blog\/2019\/03\/short-note-the-abbreviation-appreciation-society\/\">Short note: The abbreviation appreciation society<\/a><\/td>\n<\/tr>\n<tr id=\"el-address\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/sections.html#the-address-element\"><code>address<\/code><\/a><\/td>\n<td class=\"no\">author<\/td>\n<td class=\"no\">no<\/td>\n<td>\u26a0<code>aria-label<\/code> use not well supported<\/td>\n<\/tr>\n<tr id=\"el-area\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/image-maps.html#the-area-element\"><code>area<\/code><\/a> with <a href=\"https:\/\/html.spec.whatwg.org\/multipage\/links.html#attr-hyperlink-href\"><code>href<\/code><\/a><\/td>\n<td class=\"no\"><span class=\"yes\">contents or author<\/span><\/td>\n<td class=\"no\">no<\/td>\n<td>use <code>alt<\/code><\/td>\n<\/tr>\n<tr id=\"el-area-no-href\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/image-maps.html#the-area-element\"><code>area<\/code><\/a> without <a href=\"https:\/\/html.spec.whatwg.org\/multipage\/links.html#attr-hyperlink-href\"><code>href<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td><code>a<\/code> without <code>href<\/code> is not a link and not exposed as a <code>link<\/code>. Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-article\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/sections.html#the-article-element\"><code>article<\/code><\/a><\/td>\n<td class=\"yes\">author<\/td>\n<td class=\"yes\">yes<\/td>\n<td>Does not mask content: accessible name provided via <code>aria-label<\/code> will generally be announced when the <code>article<\/code> is navigated to.<\/td>\n<\/tr>\n<tr id=\"el-aside\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/sections.html#the-aside-element\"><code>aside<\/code><\/a><\/td>\n<td class=\"yes\">author<\/td>\n<td class=\"yes\">yes<\/td>\n<td>Does not mask content. Accessible name provided via <code>aria-label<\/code> will generally be announced when the <code>aside<\/code> is navigated to.<\/td>\n<\/tr>\n<tr id=\"el-audio\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/media.html#audio\"><code>audio<\/code><\/a><\/td>\n<td class=\"yes\">author<\/td>\n<td class=\"yes\">yes<\/td>\n<td>Prefer visible, a heading <em>perhaps<\/em> (via <code>aria-labelledby<\/code> if you like)<\/td>\n<\/tr>\n<tr id=\"el-b\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-b-element\"><code>b<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-base\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/semantics.html#the-base-element\"><code>base<\/code><\/a><\/td>\n<td class=\"no\">not applicable<\/td>\n<td class=\"no\">no<\/td>\n<td>not UI<\/td>\n<\/tr>\n<tr id=\"el-bdi\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-bdi-element\"><code>bdi<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-bdo\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-bdo-element\"><code>bdo<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-blockquote\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/grouping-content.html#the-blockquote-element\"><code>blockquote<\/code><\/a><\/td>\n<td class=\"no\"><span class=\"yes\">author<\/span><\/td>\n<td class=\"no\">no<\/td>\n<td><code>aria-label<\/code> use not well supported<\/td>\n<\/tr>\n<tr id=\"el-body\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/sections.html#the-body-element\"><code>body<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-br\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-br-element\"><code>br<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-button\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/form-elements.html#the-button-element\"><code>button<\/code><\/a><\/td>\n<td class=\"yes\">contents or author<\/td>\n<td class=\"yes\">yes<\/td>\n<td>\u26a0 \ud83d\ude37 Masks text content, so only <code>aria-label<\/code> is announced:<\/p>\n<p><code>&lt;button  aria-label=\"some text\"&gt;<s>open<\/s>&lt;\/button&gt;<\/code><\/p>\n<p>Be wary of <a href=\"https:\/\/www.w3.org\/TR\/WCAG21\/#label-in-name\">label in name<\/a> issues<\/td>\n<\/tr>\n<tr id=\"el-canvas\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/canvas.html#canvas\"><code>canvas<\/code><\/a><\/td>\n<td class=\"no\">Author<\/td>\n<td class=\"no\">no<\/td>\n<td>Use child content<\/p>\n<p><code>&lt;canvas&gt;&lt;p&gt;&lt;a href=\"https:\/\/www.youtube.com\/watch?v=y8b7f0ivzUo\"&gt;Pictures of Lily&lt;\/a&gt;&lt;\/p&gt;&lt;\/canvas&gt;<\/code><\/td>\n<\/tr>\n<tr id=\"el-caption\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/tables.html#the-caption-element\"><code>caption<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>refer to <a href=\"https:\/\/w3c.github.io\/aria\/#namefromprohibited\">Roles which cannot be named (Name prohibited)<\/a> ARIA 1.2<\/td>\n<\/tr>\n<tr id=\"el-cite\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-cite-element\"><code>cite<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-code\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-code-element\"><code>code<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>refer to <a href=\"https:\/\/w3c.github.io\/aria\/#namefromprohibited\">Roles which cannot be named (Name prohibited)<\/a> ARIA 1.2<\/td>\n<\/tr>\n<tr id=\"el-col\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/tables.html#the-col-element\"><code>col<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>not UI<\/td>\n<\/tr>\n<tr id=\"el-colgroup\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/tables.html#the-colgroup-element\"><code>colgroup<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>not UI<\/td>\n<\/tr>\n<tr id=\"el-data\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-data-element\"><code>data<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-datalist\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/form-elements.html#the-datalist-element\"><code>datalist<\/code><\/a><\/td>\n<td class=\"no\">Author<\/td>\n<td class=\"no\">no<\/td>\n<td>For <code>aria-label<\/code> on <code>&lt;datalist&gt;<\/code> element itself.<\/td>\n<\/tr>\n<tr id=\"el-dd\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/grouping-content.html#the-dd-element\"><code>dd<\/code><\/a><\/td>\n<td class=\"no\">Author<\/td>\n<td class=\"no\">no<\/td>\n<td><code>aria-label<\/code> use not well supported<\/td>\n<\/tr>\n<tr id=\"el-del\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/edits.html#the-del-element\"><code>del<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>refer to <a href=\"https:\/\/w3c.github.io\/aria\/#namefromprohibited\">Roles which cannot be named (Name prohibited)<\/a> ARIA 1.2<\/td>\n<\/tr>\n<tr id=\"el-dfn\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-dfn-element\"><code>dfn<\/code><\/a><\/td>\n<td class=\"no\">Author<\/td>\n<td class=\"no\">no<\/td>\n<td><code>aria-label<\/code> use not well supported<\/td>\n<\/tr>\n<tr id=\"el-details\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/interactive-elements.html#the-details-element\"><code>details<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>Does not mask content: When <code>details<\/code> has an accessible name it is announced as a group along with its accessible name (<a href=\"https:\/\/thepaciellogroup.github.io\/AT-browser-tests\/test-files\/details-summary.html#details10\">test case<\/a>).<\/td>\n<\/tr>\n<tr id=\"el-dialog\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/interactive-elements.html#the-dialog-element\"><code>dialog<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>Does not mask content: accessible name provided via <code>aria-label<\/code> will generally be announced when the <code>dialog<\/code> is navigated to.<\/td>\n<\/tr>\n<tr id=\"el-div\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/grouping-content.html#the-div-element\"><code>div<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>refer to <a href=\"https:\/\/w3c.github.io\/aria\/#namefromprohibited\">Roles which cannot be named (Name prohibited)<\/a> ARIA 1.2<\/td>\n<\/tr>\n<tr id=\"el-dl\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/grouping-content.html#the-dl-element\"><code>dl<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>Fairly good support across browsers\/screenreaders.<\/td>\n<\/tr>\n<tr id=\"el-dt\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/grouping-content.html#the-dt-element\"><code>dt<\/code><\/a><\/td>\n<td class=\"no\">Author<\/td>\n<td class=\"no\">no<\/td>\n<td><code>aria-label<\/code> use not well supported<\/td>\n<\/tr>\n<tr id=\"el-em\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-em-element\"><code>em<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>refer to <a href=\"https:\/\/w3c.github.io\/aria\/#namefromprohibited\">Roles which cannot be named (Name prohibited)<\/a> ARIA 1.2<\/td>\n<\/tr>\n<tr id=\"el-embed\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/iframe-embed-object.html#the-embed-element\"><code>embed<\/code><\/a><\/td>\n<td class=\"no\">not applicable<\/td>\n<td class=\"no\">no<\/td>\n<td><code>aria-label<\/code> use not well supported<\/td>\n<\/tr>\n<tr id=\"el-fieldset\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/form-elements.html#the-fieldset-element\"><code>fieldset<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span> or caption content<\/td>\n<td class=\"yes\">yes<\/td>\n<td><code>aria-label<\/code> overrides accessible name from <code>legend<\/code> content (if present). Otherwise, does not mask content: accessible name provided via <code>aria-label<\/code> will generally be announced when the <code>fieldset<\/code> is navigated to.<\/td>\n<\/tr>\n<tr id=\"el-figcaption\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/grouping-content.html#the-figcaption-element\"><code>figcaption<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>refer to <a href=\"https:\/\/w3c.github.io\/aria\/#namefromprohibited\">Roles which cannot be named (Name prohibited)<\/a> ARIA 1.2<\/td>\n<\/tr>\n<tr id=\"el-figure\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/grouping-content.html#the-figure-element\"><code>figure<\/code><\/a><\/td>\n<td class=\"yes\">Author or figcaption content<\/td>\n<td class=\"yes\">yes<\/td>\n<td><code>aria-label<\/code> \ud83d\ude37 overrides accessible name from <code>figcaption<\/code> content (if present). Otherwise, does not mask content: accessible name provided via <code>aria-label<\/code> will generally be announced when the <code>figure<\/code> is navigated to.<\/td>\n<\/tr>\n<tr id=\"el-footer\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/sections.html#the-footer-element\"><code>footer<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>Does not mask content: accessible name provided via <code>aria-label<\/code> will generally be announced when the <code>footer<\/code> is navigated to.<\/td>\n<\/tr>\n<tr id=\"el-form\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/forms.html#the-form-element\"><code>form<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>Does not mask content: accessible name provided via <code>aria-label<\/code> will generally be announced when the <code>form<\/code> is navigated to.<\/td>\n<\/tr>\n<tr id=\"el-form-associated-custom-element\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/custom-elements.html#form-associated-custom-element\">form-associated custom element<\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>Unless the custom element is an extension of a native HTML interactive element, ARIA labeling (<code>aria-label<\/code>, <code>aria-labelledby<\/code>) is the primary method of labeling.<\/td>\n<\/tr>\n<tr id=\"el-h1-h6\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/sections.html#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements\"><code>h1 to h6<\/code><\/a><\/td>\n<td class=\"no\">Contents or Author<\/td>\n<td class=\"no\">no<\/td>\n<td>\u26a0 <code>aria-label<\/code> use not well supported, works with NVDA\/VoiceOver not with JAWS.<\/p>\n<p>\u26a0 \ud83d\ude37 Masks text content, so only <code>aria-label<\/code> is announced:<\/p>\n<p><code>&lt;h1  aria-label=\"PING\"&gt;<s>PONG<\/s>&lt;\/h1&gt;<\/code><\/td>\n<\/tr>\n<tr id=\"el-head\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/semantics.html#the-head-element\"><code>head<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>not UI<\/td>\n<\/tr>\n<tr id=\"el-header\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/sections.html#the-header-element\"><code>header<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>Does not mask content: accessible name provided via <code>aria-label<\/code> will generally be announced when the <code>header<\/code> is navigated to.<\/td>\n<\/tr>\n<tr id=\"el-hgroup\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/sections.html#the-hgroup-element\"><code>hgroup<\/code><\/a><\/td>\n<td class=\"no\">Author<\/td>\n<td class=\"no\">yes<\/td>\n<td>exposed a <code>role=\"goup\"<\/code> announced by JAWS and NVDA, no other AT tested.<\/td>\n<\/tr>\n<tr id=\"el-hr\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/grouping-content.html#the-hr-element\"><code>hr<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>Will generally be announced when the <code>hr<\/code> is navigated to.<\/td>\n<\/tr>\n<tr id=\"el-html\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/semantics.html#the-html-element\"><code>html<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>not UI<\/td>\n<\/tr>\n<tr id=\"el-i\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-i-element\"><code>i<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-iframe\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/iframe-embed-object.html#the-iframe-element\"><code>iframe<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>Use <code>title<\/code> attribute for accessible name<\/td>\n<\/tr>\n<tr id=\"el-img\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/embedded-content.html#the-img-element\"><code>img<\/code><\/a> with <a href=\"https:\/\/html.spec.whatwg.org\/multipage\/embedded-content.html#attr-img-alt\"><code>alt<\/code><\/a><code>=\"some text\"<\/code><\/td>\n<td class=\"no\">Author<\/td>\n<td class=\"no\">no<\/td>\n<td>Use <code>alt<\/code> attribute for accessible name<\/td>\n<\/tr>\n<tr id=\"el-img-empty-alt\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/embedded-content.html#the-img-element\"><code>img<\/code><\/a> with <a href=\"https:\/\/html.spec.whatwg.org\/multipage\/embedded-content.html#attr-img-alt\"><code>alt<\/code><\/a><code>=\"\"<\/code><\/td>\n<td class=\"no\">not applicable<\/td>\n<td class=\"no\">no<\/td>\n<td>use <code>alt<\/code><\/td>\n<\/tr>\n<tr id=\"el-img-no-alt\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/embedded-content.html#the-img-element\"><code>img<\/code><\/a> without <a href=\"https:\/\/html.spec.whatwg.org\/multipage\/images.html#unknown-images\"><code>alt<\/code><\/a> attribute<\/td>\n<td class=\"no\">Author<\/td>\n<td class=\"no\">no<\/td>\n<td>if you want to add an accessible name to an <code>&lt;img&gt;<\/code> use <code>alt<\/code> attribute for accessible name<\/td>\n<\/tr>\n<tr id=\"el-input-button\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/input.html#button-state-(type=button)\"><code>input type=button<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>value<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-input-checkbox\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/input.html#checkbox-state-(type=checkbox)\"><code>input type=checkbox<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>label<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-input-color\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/input.html#color-state-(type=color)\"><code>input type=color<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>label<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-input-date\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/input.html#date-state-(type=date)\"><code>input type=date<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>label<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-input-datetime-local\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/input.html#local-date-and-time-state-(type=datetime-local)\"><code>input type=datetime-local<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>label<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-input-email\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/input.html#e-mail-state-(type=email)\"><code>input type=email<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>label<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-input-file\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/input.html#file-upload-state-(type=file)\"><code>input type=file<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>label<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-input-hidden\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/input.html#hidden-state-(type=hidden)\"><code>input type=hidden<\/code><\/a><\/td>\n<td class=\"no\">not applicable<\/td>\n<td class=\"no\">no<\/td>\n<td>not UI<\/td>\n<\/tr>\n<tr id=\"el-input-image\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/input.html#image-button-state-(type=image)\"><code>input type=image<\/code><\/a><\/td>\n<td class=\"no\">Author<\/td>\n<td class=\"no\">no<\/td>\n<td>if you want to add an accessible name to an <code>&lt;input type=image&gt;<\/code> use <code>alt<\/code><\/td>\n<\/tr>\n<tr id=\"el-input-month\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/input.html#month-state-(type=month)\"><code>input type=month<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>label<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-input-number\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/input.html#number-state-(type=number)\"><code>input type=number<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>label<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-input-password\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/input.html#password-state-(type=password)\"><code>input type=password<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>label<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-input-radio\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/input.html#radio-button-state-(type=radio)\"><code>input type=radio<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>label<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-input-range\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/input.html#range-state-(type=range)\"><code>input type=range<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>value<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-input-reset\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/input.html#reset-button-state-(type=reset)\"><code>input type=reset<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>value<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-input-search\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/input.html#text-(type=text)-state-and-search-state-(type=search)\"><code>input type=search<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>label<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-input-submit\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/input.html#submit-button-state-(type=submit)\"><code>input type=submit<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>value<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-input-tel\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/input.html#telephone-state-(type=tel)\"><code>input type=tel<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>label<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-input-text\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/input.html#text-(type=text)-state-and-search-state-(type=search)\"><code>input type=text<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>label<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-input-time\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/input.html#time-state-(type=time)\"><code>input type=time<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>label<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-input-url\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/input.html#url-state-(type=url)\"><code>input type=url<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>label<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-input-week\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/input.html#week-state-(type=week)\"><code>input type=week<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>label<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-ins\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/edits.html#the-ins-element\"><code>ins<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-kbd\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-kbd-element\"><code>kbd<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-label\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/forms.html#the-label-element\"><code>label<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed (until ARIA 1.3)<\/td>\n<\/tr>\n<tr id=\"el-legend\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/form-elements.html#the-legend-element\"><code>legend<\/code><\/a><\/td>\n<td class=\"no\">Author<\/td>\n<td class=\"no\">no<\/td>\n<td>provides acc name for parent <code>fieldset<\/code>. <code>aria-label<\/code> use not well supported<\/td>\n<\/tr>\n<tr id=\"el-li\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/grouping-content.html#the-li-element\"><code>li<\/code><\/a><\/td>\n<td class=\"no\">Author<\/td>\n<td class=\"no\">no<\/td>\n<td><code>aria-label<\/code> use not well supported<\/td>\n<\/tr>\n<tr id=\"el-link\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/semantics.html#the-link-element\"><code>link<\/code><\/a> element with a<br \/>\n<a href=\"https:\/\/html.spec.whatwg.org\/multipage\/semantics.html#attr-link-href\"><code>href<\/code><\/a><\/td>\n<td class=\"no\">not applicable<\/td>\n<td class=\"no\">no<\/td>\n<td>Don&#8217;t use <code>link<\/code> in <code>body<\/code><\/td>\n<\/tr>\n<tr id=\"el-main\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/grouping-content.html#the-main-element\"><code>main<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>Does not mask content: accessible name provided via <code>aria-label<\/code> will generally be announced when the <code>main<\/code> is navigated to.<\/td>\n<\/tr>\n<tr id=\"el-map\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/image-maps.html#the-map-element\"><code>map<\/code><\/a><\/td>\n<td class=\"no\">not applicable<\/td>\n<td class=\"no\">no<\/td>\n<td>not UI<\/td>\n<\/tr>\n<tr id=\"el-math\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/embedded-content-other.html#mathml\"><code>math<\/code><\/a><\/td>\n<td class=\"no\">Author<\/td>\n<td class=\"no\">no<\/td>\n<td>The <code>math<\/code> element is not currently supported in some modern browsers.<\/td>\n<\/tr>\n<tr id=\"el-mark\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-mark-element\"><code>mark<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>refer to <a href=\"https:\/\/w3c.github.io\/aria\/#namefromprohibited\">Roles which cannot be named (Name prohibited)<\/a> ARIA 1.2<\/td>\n<\/tr>\n<tr id=\"el-menu\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/grouping-content.html#menus\"><code>menu<\/code><\/a><\/td>\n<td class=\"no\">not applicable<\/td>\n<td class=\"no\">no<\/td>\n<td>This element <em>sucks<\/em> in general, suggest not using.<\/td>\n<\/tr>\n<tr id=\"el-meta\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/semantics.html#meta\"><code>meta<\/code><\/a><\/td>\n<td class=\"no\">not applicable<\/td>\n<td class=\"no\">no<\/td>\n<td>not UI<\/td>\n<\/tr>\n<tr id=\"el-meter\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/form-elements.html#the-meter-element\"><code>meter<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>label<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-nav\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/sections.html#the-nav-element\"><code>nav<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>Does not mask content: accessible name provided via <code>aria-label<\/code> will generally be announced when the <code>nav<\/code> is navigated to.<\/td>\n<\/tr>\n<tr id=\"el-noscript\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/scripting.html#the-noscript-element\"><code>noscript<\/code><\/a><\/td>\n<td class=\"no\">not applicable<\/td>\n<td class=\"no\">no<\/td>\n<td>not UI<\/td>\n<\/tr>\n<tr id=\"el-object\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/iframe-embed-object.html#the-object-element\"><code>object<\/code><\/a><\/td>\n<td class=\"no\">not applicable<\/td>\n<td class=\"no\">no<\/td>\n<td><code>aria-label<\/code> use not well supported<\/td>\n<\/tr>\n<tr id=\"el-ol\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/grouping-content.html#the-ol-element\"><code>ol<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>Fairly good support across browsers\/screenreaders.<\/td>\n<\/tr>\n<tr id=\"el-optgroup\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/form-elements.html#the-optgroup-element\"><code>optgroup<\/code><\/a><\/td>\n<td class=\"no\">Author<\/td>\n<td class=\"no\">no<\/td>\n<td>Use <a href=\"https:\/\/html.spec.whatwg.org\/multipage\/form-elements.html#attr-optgroup-label\"><code>label<\/code><\/a> attribute<\/td>\n<\/tr>\n<tr id=\"el-option\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/form-elements.html#the-option-element\"><code>option<\/code><\/a><\/td>\n<td class=\"no\">contents or author<\/td>\n<td class=\"no\">no<\/td>\n<td>Use text content of <code>option<\/code> or use a <a href=\"https:\/\/html.spec.whatwg.org\/multipage\/form-elements.html#attr-option-label\"><code>label<\/code><\/a> attribute.<\/td>\n<\/tr>\n<tr id=\"el-output\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/form-elements.html#the-output-element\"><code>output<\/code><\/a><\/td>\n<td class=\"no\">Author<\/td>\n<td class=\"no\">no<\/td>\n<td><code>aria-label<\/code> use not supported<\/td>\n<\/tr>\n<tr id=\"el-p\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/grouping-content.html#the-p-element\"><code>p<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>refer to <a href=\"https:\/\/w3c.github.io\/aria\/#namefromprohibited\">Roles which cannot be named (Name prohibited)<\/a> ARIA 1.2<\/td>\n<\/tr>\n<tr id=\"el-param\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/iframe-embed-object.html#the-param-element\"><code>param<\/code><\/a><\/td>\n<td class=\"no\">not applicable<\/td>\n<td class=\"no\">no<\/td>\n<td>not UI<\/td>\n<\/tr>\n<tr id=\"el-picture\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/embedded-content.html#the-picture-element\"><code>picture<\/code><\/a><\/td>\n<td class=\"no\">not applicable<\/td>\n<td class=\"no\">no<\/td>\n<td>not UI<\/td>\n<\/tr>\n<tr id=\"el-pre\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/grouping-content.html#the-pre-element\"><code>pre<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-progress\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/form-elements.html#the-progress-element\"><code>progress<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>label<\/code> preferred or\u00a0 a heading <em>perhaps<\/em> (via <code>aria-labelledby<\/code> if you like).<\/td>\n<\/tr>\n<tr id=\"el-q\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-q-element\"><code>q<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-rp\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-rp-element\"><code>rp<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-rt\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-rt-element\"><code>rt<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-ruby\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-ruby-element\"><code>ruby<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-s\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-s-element\"><code>s<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-samp\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-samp-element\"><code>samp<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-script\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/scripting.html#script\"><code>script<\/code><\/a><\/td>\n<td class=\"no\">not applicable<\/td>\n<td class=\"no\">no<\/td>\n<td>not UI<\/td>\n<\/tr>\n<tr id=\"el-section\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/sections.html#the-section-element\"><code>section<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>Does not mask content: accessible name provided via <code>aria-label<\/code> will generally be announced when the <code>section<\/code> is navigated to.<\/td>\n<\/tr>\n<tr id=\"el-search\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/grouping-content.html#the-search-element\"><code>search<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>Does not mask content: accessible name provided via <code>aria-label<\/code> will generally be announced when the <code>search<\/code> element is navigated to.<\/td>\n<\/tr>\n<tr id=\"el-select\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/form-elements.html#the-select-element\"><code>select<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>label<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-slot\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/scripting.html#the-slot-element\"><code>slot<\/code><\/a><\/td>\n<td class=\"no\">not applicable<\/td>\n<td class=\"no\">no<\/td>\n<td>not UI<\/td>\n<\/tr>\n<tr id=\"el-small\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-small-element\"><code>small<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-source\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/embedded-content.html#the-source-element\"><code>source<\/code><\/a><\/td>\n<td class=\"no\">not applicable<\/td>\n<td class=\"no\">no<\/td>\n<td>not UI<\/td>\n<\/tr>\n<tr id=\"el-span\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-span-element\"><code>span<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>refer to <a href=\"https:\/\/w3c.github.io\/aria\/#namefromprohibited\">Roles which cannot be named (Name prohibited)<\/a> ARIA 1.2<\/td>\n<\/tr>\n<tr id=\"el-strong\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-strong-element\"><code>strong<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>refer to <a href=\"https:\/\/w3c.github.io\/aria\/#namefromprohibited\">Roles which cannot be named (Name prohibited)<\/a> ARIA 1.2<\/td>\n<\/tr>\n<tr id=\"el-style\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/semantics.html#the-style-element\"><code>style<\/code><\/a><\/td>\n<td class=\"no\">not applicable<\/td>\n<td class=\"no\">no<\/td>\n<td>not UI<\/td>\n<\/tr>\n<tr id=\"el-svg\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/embedded-content-other.html#svg-0\"><code>SVG<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td><code>alt=\"some text\"<\/code> <strong>DOES NOT WORK<\/strong> even if the <code>SVG<\/code> (or any other element) has a <code>role=\"img\"<\/code><\/td>\n<\/tr>\n<tr id=\"el-sub\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-sub-element\"><code>sub<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>refer to <a href=\"https:\/\/w3c.github.io\/aria\/#namefromprohibited\">Roles which cannot be named (Name prohibited)<\/a> ARIA 1.2<\/td>\n<\/tr>\n<tr id=\"el-summary\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/interactive-elements.html#the-summary-element\"><code>summary<\/code><\/a><\/td>\n<td class=\"no\">not applicable<\/td>\n<td class=\"no\">no<\/td>\n<td>\u26a0<code>aria-label<\/code> use not well supported<\/td>\n<\/tr>\n<tr id=\"el-sup\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-sup-element\"><code>sup<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>refer to <a href=\"https:\/\/w3c.github.io\/aria\/#namefromprohibited\">Roles which cannot be named (Name prohibited)<\/a> ARIA 1.2<\/td>\n<\/tr>\n<tr id=\"el-table\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/tables.html#the-table-element\"><code>table<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>Prefer visible <code>caption<\/code> element text<\/td>\n<\/tr>\n<tr id=\"el-tbody\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/tables.html#the-tbody-element\"><code>tbody<\/code><\/a><\/td>\n<td class=\"no\">Author<\/td>\n<td class=\"no\">no<\/td>\n<td>\u26a0<code>aria-label<\/code> use not well supported<\/td>\n<\/tr>\n<tr id=\"el-template\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/scripting.html#the-template-element\"><code>template<\/code><\/a><\/td>\n<td class=\"no\">not applicable<\/td>\n<td class=\"no\">no<\/td>\n<td>not UI<\/td>\n<\/tr>\n<tr id=\"el-textarea\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/form-elements.html#the-textarea-element\"><code>textarea<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>accessible name from <code>label<\/code> preferred<\/td>\n<\/tr>\n<tr id=\"el-tfoot\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/tables.html#the-tfoot-element\"><code>tfoot<\/code><\/a><\/td>\n<td class=\"no\">Author<\/td>\n<td class=\"no\">no<\/td>\n<td>\u26a0 <code>aria-label<\/code> use not well supported<\/td>\n<\/tr>\n<tr id=\"el-thead\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/tables.html#the-thead-element\"><code>thead<\/code><\/a><\/td>\n<td class=\"no\">Author<\/td>\n<td class=\"no\">no<\/td>\n<td>\u26a0 <code>aria-label<\/code> use not well supported<\/td>\n<\/tr>\n<tr id=\"el-time\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-time-element\"><code>time<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-title\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/semantics.html#the-title-element\"><code>title<\/code><\/a><\/td>\n<td class=\"no\">not applicable<\/td>\n<td class=\"no\">no<\/td>\n<td>not UI<\/td>\n<\/tr>\n<tr id=\"el-td\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/tables.html#the-td-element\"><code>td<\/code><\/a><\/td>\n<td class=\"no\">Author<\/td>\n<td class=\"no\">no<\/td>\n<td>\u26a0 <code>aria-label<\/code> use not well supported<\/td>\n<\/tr>\n<tr id=\"el-th\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/tables.html#the-th-element\"><code>th<\/code><\/a><\/td>\n<td class=\"no\">Author<\/td>\n<td class=\"no\">no<\/td>\n<td>\u26a0<code>aria-label<\/code> use not well supported<\/td>\n<\/tr>\n<tr id=\"el-tr\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/tables.html#the-tr-element\"><code>tr<\/code><\/a><\/td>\n<td class=\"no\">contents or author<\/td>\n<td class=\"no\">no<\/td>\n<td>\u26a0 \ud83d\ude37<code>aria-label<\/code> use not well supported<\/td>\n<\/tr>\n<tr id=\"el-track\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/media.html#the-track-element\"><code>track<\/code><\/a><\/td>\n<td class=\"no\">not applicable<\/td>\n<td class=\"no\">no<\/td>\n<td>not UI<\/td>\n<\/tr>\n<tr id=\"el-u\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-u-element\"><code>u<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-ul\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/grouping-content.html#the-ul-element\"><code>ul<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>Fairly good support across browsers\/screenreaders.<\/td>\n<\/tr>\n<tr id=\"el-var\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-var-element\"><code>var<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<tr id=\"el-video\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/media.html#video\"><code>video<\/code><\/a><\/td>\n<td class=\"yes\"><span class=\"no\">Author<\/span><\/td>\n<td class=\"yes\">yes<\/td>\n<td>Prefer visible, a heading <em>perhaps<\/em> (via <code>aria-labelledby<\/code> if you like)<\/td>\n<\/tr>\n<tr id=\"el-wbr\" tabindex=\"-1\">\n<td><a href=\"https:\/\/html.spec.whatwg.org\/multipage\/text-level-semantics.html#the-wbr-element\"><code>wbr<\/code><\/a><\/td>\n<td class=\"no\">Prohibited<\/td>\n<td class=\"no\">no<\/td>\n<td>Maps to <a href=\"https:\/\/w3c.github.io\/aria\/#generic\"><code>role=generic<\/code><\/a> naming not allowed<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Thanks to <a href=\"https:\/\/mobile.twitter.com\/carmacleod\">@carmacleod<\/a> for feedback.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Updated: 15 June 2025 aria-label is one of a number of secondary methods to label native HTML UI elements. It works particularly well on interactive elements, it also works well on most block level elements old skool term that have explicitly or implicitly defined structural roles. It works less well or not at all on [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-157","post","type-post","status-publish","format-standard","hentry","category-htmlaccessibility"],"_links":{"self":[{"href":"https:\/\/html5accessibility.com\/stuff\/wp-json\/wp\/v2\/posts\/157","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/html5accessibility.com\/stuff\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/html5accessibility.com\/stuff\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/html5accessibility.com\/stuff\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/html5accessibility.com\/stuff\/wp-json\/wp\/v2\/comments?post=157"}],"version-history":[{"count":52,"href":"https:\/\/html5accessibility.com\/stuff\/wp-json\/wp\/v2\/posts\/157\/revisions"}],"predecessor-version":[{"id":1636,"href":"https:\/\/html5accessibility.com\/stuff\/wp-json\/wp\/v2\/posts\/157\/revisions\/1636"}],"wp:attachment":[{"href":"https:\/\/html5accessibility.com\/stuff\/wp-json\/wp\/v2\/media?parent=157"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/html5accessibility.com\/stuff\/wp-json\/wp\/v2\/categories?post=157"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/html5accessibility.com\/stuff\/wp-json\/wp\/v2\/tags?post=157"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}