You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<h2>Excluding Elements from the Accessibility Tree</h2>
13193
13193
<p>The following <a>elements</a> are not exposed via the <a>accessibility <abbr title="Application Programing Interfaces">API</abbr></a> and user agents MUST NOT include them in the <a class="termref">accessibility tree</a>:</p>
13194
13194
<ul>
13195
-
<li>Elements with <rref>none</rref> or <rref>presentation</rref> as the first role in the role attribute. However, their exclusion is conditional and depends on other factors. In addition, the element's descendants and text content are generally included. These exceptions and conditions are documented in the <a href="#conflict_resolution_presentation_none">Presentational Roles Conflict Resolution</a> section.</li>
13196
13195
<li>Elements, including their descendent elements, that have host language semantics specifying that the element is not displayed, such as CSS <code>display:none</code>, <code>visibility:hidden</code>, or the HTML <code>hidden</code> attribute.</li>
13197
-
</ul>
13196
+
<li>Elements with <rref>none</rref> or <rref>presentation</rref> as the first role in the role attribute. However, their exclusion is conditional. In addition, the element's descendants and text content are generally included. These exceptions and conditions are documented in the <a href="#presentation">presentation (role)</a> section.</li>
13197
+
</ul>
13198
13198
<p>If not already excluded from the accessibility tree per the above rules, user agents SHOULD NOT include the following elements in the accessibility tree:</p>
13199
13199
<ul>
13200
13200
<li>Elements, including their descendants, that have <sref>aria-hidden</sref> set to <code>true</code>. In other words, <code>aria-hidden="true"</code> on a parent overrides <code>aria-hidden="false"</code> on descendants.</li>
13201
13201
<li>
13202
13202
<p>Any descendants of elements that have the characteristic "<a href="#childrenArePresentational">Children Presentational: True</a>" unless the descendant is not allowed to be presentational because it meets one of the conditions for exception described in <a href="#conflict_resolution_presentation_none">Presentational Roles Conflict Resolution</a>. However, the text content of any excluded descendants is included.</p>
13203
-
<p>Elements having one of the following roles have the characteristic "Children Presentational: True":</p>
13203
+
<p>Elements with the following roles have the characteristic "Children Presentational: True":</p>
13204
13204
<ul>
13205
13205
<li><rref>button</rref></li>
13206
13206
<li><rref>checkbox</rref></li>
13207
13207
<li><rref>img</rref></li>
13208
-
<li><rref>math</rref></li>
13209
13208
<li><rref>menuitemcheckbox</rref></li>
13210
13209
<li><rref>menuitemradio</rref></li>
13210
+
<li><rref>meter</rref></li>
13211
13211
<li><rref>option</rref></li>
13212
13212
<li><rref>progressbar</rref></li>
13213
13213
<li><rref>radio</rref></li>
@@ -13222,14 +13222,17 @@ <h2>Excluding Elements from the Accessibility Tree</h2>
13222
13222
</section>
13223
13223
<section id="tree_inclusion">
13224
13224
<h2>Including Elements in the Accessibility Tree</h2>
13225
-
<p>If not already excluded from the accessibility tree per the rules above in <a href="#tree_exclusion">Excluding Elements in the Accessibility Tree</a>, user agents MUST provide an <a>accessible object</a> in the <a>accessibility tree</a> for <abbr title="Document Object Model">DOM</abbr> <a>elements</a> that meet any of the following criteria:</p>
13225
+
<p>If not excluded from the accessibility tree per the rules above in <a href="#tree_exclusion">Excluding Elements in the Accessibility Tree</a>, user agents MUST provide an <a>accessible object</a> in the <a>accessibility tree</a> for <abbr title="Document Object Model">DOM</abbr> <a>elements</a> that meet any of the following criteria:</p>
13226
13226
<ul>
13227
-
<li><a>Text nodes</a></li>
13228
-
<li>Elements that may fire an <a>accessibility <abbr title="Application Program Interface">API</abbr></a> <a>event</a>.</li>
13229
-
<li>Elements that are focusable, or have an ID <a>attribute</a> and an ancestor with the <pref>aria-activedescendant</pref> attribute that matches the implicit or explicit <a>semantics</a> of the required context role. In either case, the element may receive focus and may fire an <a>accessibility <abbr title="Application Program Interface">API</abbr></a> focus event.</li>
13227
+
<li>Elements that are not <a>hidden</a> and may fire an <a>accessibility <abbr title="Application Program Interface">API</abbr></a> <a>event</a>:
13228
+
<ul>
13229
+
<li>Elements that are <a>focusable</a> even if the element or one of its ancestor elements has its <sref>aria-hidden</sref> attribute set to <code>true</code>.</li>
13230
+
<li>Elements that are a valid target of an <pref>aria-activedescendant</pref> attribute.</li>
13231
+
</ul>
13232
+
</li>
13230
13233
<li>Elements that have an explicit role or a global <abbr title="Accessible Rich Internet Application">WAI-ARIA</abbr> attribute and do not have <sref>aria-hidden</sref> set to <code>true</code>. (See <a href="#tree_exclusion">Excluding Elements in the Accessibility Tree</a> for additional guidance on <sref>aria-hidden</sref>.)</li>
13231
-
<li>Elements that have an ID which is referenced by another element via a <abbr title="Accessible Rich Internet Application">WAI-ARIA</abbr> property and are not <a>hidden</a>.
13232
-
<p class="note">Text equivalents for hidden referenced objects may still be used in the <a href="#mapping_additional_nd" class="accname">name and description computation</a> even when not included in the accessibility tree.</p>
13234
+
<li>Elements that are not <a>hidden</a> and have an ID that is referenced by another element via a <abbr title="Accessible Rich Internet Application">WAI-ARIA</abbr> property.
13235
+
<p class="note">Text equivalents for hidden referenced objects may still be used in the <a href="#mapping_additional_nd" class="accname">name and description computation</a> even when not included in the accessibility tree.</p>
0 commit comments