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
Copy file name to clipboardExpand all lines: aria-practices.html
+3-9
Original file line number
Diff line number
Diff line change
@@ -3742,7 +3742,7 @@ <h3>What ARE Accessible Names and Descriptions?</h3>
3742
3742
For example, a switch button named <q>Mute Conversation</q> in the <q>off</q> state could be announced as <q>Mute Conversation switch button off</q>.
3743
3743
Because descriptions are optional strings that are usually significantly longer than names, they are presented last, sometimes after a slight delay.
3744
3744
For example, <q>Mute Conversation Switch button off, Silences alerts and notifications about activity in this conversation.</q>
3745
-
To reduce verbosity, some screen readers do not announce descriptions by default but instead inform users of their presence so that users can press a key that will announce the description.
3745
+
To reduce verbosity, some screen readers do not announce descriptions by default but instead inform users of their presence so that users can press a key that will announce the description.
3746
3746
</p>
3747
3747
</section>
3748
3748
@@ -4074,7 +4074,7 @@ <h5>Naming Tables and Figures with Captions</h5>
4074
4074
</figure></code></pre>
4075
4075
<p>
4076
4076
Like with <code>table</code> elements, if a <code>figure</code> is not named using <code>aria-label</code> or <code>aria-labelledby</code>, the content of the <code>figcaption</code> element will be used as the accessible name.
4077
-
However unlike <code>table</code> elements, if the <code>figcaption</code> element is not used for the name, it does not become an accessible description unless it is referenced by <code>aria-describedby</code>.
4077
+
However unlike <code>table</code> elements, if the <code>figcaption</code> element is not used for the name, it does not become an accessible description unless it is referenced by <code>aria-describedby</code>.
4078
4078
Nevertheless, assistive technologies will render the content of a <code>figcaption</code> regardless of whether it is used as a name, description, or neither.
4079
4079
</p>
4080
4080
<p>Using the <code>caption</code> element to name a <code>table</code> element, or a <code>figcaption</code> element to name a <code>figure</code> element, satisfies <ahref="#naming_rule_visible_text">Rule 2: Prefer Visible Text</a> and <ahref="#naming_rule_native_techniques">Rule 3: Prefer Native Techniques</a>.</p>
@@ -6287,9 +6287,8 @@ <h2>Describing Hierarchical Structure with <code>aria-level</code></h2>
<p>Do not use <code>aria-level</code> on rows that are in a <code>grid</code> or a <code>table</code> because only rows in a <code>treegrid</code> table are expected to have a hierarchical relationship.</p>
6392
6391
</section>
6393
6392
6394
-
<sectionid="aria-level_grid_role">
6395
-
<h3><code>grid</code> Role</h3>
6396
-
<p>The attribute <code>aria-level</code> can be used on elements with role <code>grid</code> to represent nested grids but it is not recommended.</p>
0 commit comments