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
+4-4
Original file line number
Diff line number
Diff line change
@@ -6739,7 +6739,7 @@ <h3>Range properties with spin buttons</h3>
6739
6739
<h2>Describing Hierarchical Structure with <code>aria-level</code></h2>
6740
6740
<p>
6741
6741
When elements have a hierarchical relationship, such as headings of nested sections or data in tree structures, the value of <ahref="#aria-level" class="property-reference">aria-level</a> communicates an element's level within the hierarchy to assistive technologies.
6742
-
The value of <code>aria-level</code> is numeric, with <code>1</code> indicating the top level of the structure.
6742
+
The value of <code>aria-level</code> is an integer greater than or equal to 1, with <code>1</code> indicating the top level of the structure.
6743
6743
The number increases for each level of nesting.
6744
6744
</p>
6745
6745
<p>
@@ -6826,7 +6826,7 @@ <h3>Using <code>aria-level</code> with the <code>listitem</code> Role</h3>
6826
6826
<sectionid="aria-level_treeitem_role">
6827
6827
<h3>Using <code>aria-level</code> with the <code>treeitem</code> Role</h3>
6828
6828
<p>
6829
-
As with <code>listitem</code> elements, browsers automatically compute an <code>aria-level</code> value for elements with role <code>treeitem</code>.
6829
+
Browsers automatically compute an <code>aria-level</code> value for elements with role <code>treeitem</code>.
6830
6830
The computed level for a <code>treeitem</code> element is based on the number of <code>group</code> elements in the ancestor chain between that <code>treeitem</code> and the element with role <code>tree</code>.
6831
6831
The top-level <code>treeitem</code> elements, which are immediate descendants of the <code>tree</code> with no intervening <code>group</code>, have <code>aria-level</code> of <code>1</code>.
6832
6832
However, in some implementations of the <ahref="#TreeView">Tree View Design Pattern</a>, it is necessary to explicitly declare the <code>aria-level</code>.
@@ -6848,7 +6848,7 @@ <h3>Using <code>aria-level</code> with the <code>treeitem</code> Role</h3>
6848
6848
6849
6849
<sectionid="aria-level_row_role">
6850
6850
<h3>Using <code>aria-level</code> with the <code>row</code> Role</h3>
6851
-
<p>The <code>aria-level</code> attribute can be used on an element with <code>row</code> role to describe nesting of rows in a <code>treegrid</code>, as is explained in the <ahref="#treegrid">treegrid pattern</a>. In this example, the DOM tree does not represent the hierarchical relationship between rows. Each email is in a <code>tr</code> element, which are siblings in the DOM tree, therefore <code>aria-level</code> is necessary to communicate that the emails form a tree structure.</p>
6851
+
<p>The <code>aria-level</code> attribute can be used on an element with <code>row</code> role to describe nesting of rows in a <code>treegrid</code>, as explained in the <ahref="#treegrid">treegrid pattern</a>. In this example, the DOM tree does not represent the hierarchical relationship between rows. Each email is in a <code>tr</code> element, which are siblings in the DOM tree, therefore <code>aria-level</code> is necessary to communicate that the emails form a tree structure.</p>
6852
6852
<pre><code><table role='treegrid'>
6853
6853
<tr>
6854
6854
<th>From:</th>
@@ -6864,7 +6864,7 @@ <h3>Using <code>aria-level</code> with the <code>row</code> Role</h3>
6864
6864
</tr>
6865
6865
</table>
6866
6866
</code></pre>
6867
-
<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>
6867
+
<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> are expected to have a hierarchical relationship.</p>
0 commit comments