Skip to content

Commit 7f599ad

Browse files
mcking65carmacleod
andcommitted
Apply suggestions from Carolyn's code review
Co-authored-by: Carolyn MacLeod <[email protected]>
1 parent eb0de9b commit 7f599ad

File tree

1 file changed

+4
-4
lines changed

1 file changed

+4
-4
lines changed

aria-practices.html

+4-4
Original file line numberDiff line numberDiff line change
@@ -6739,7 +6739,7 @@ <h3>Range properties with spin buttons</h3>
67396739
<h2>Describing Hierarchical Structure with <code>aria-level</code></h2>
67406740
<p>
67416741
When elements have a hierarchical relationship, such as headings of nested sections or data in tree structures, the value of <a href="#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.
67436743
The number increases for each level of nesting.
67446744
</p>
67456745
<p>
@@ -6826,7 +6826,7 @@ <h3>Using <code>aria-level</code> with the <code>listitem</code> Role</h3>
68266826
<section id="aria-level_treeitem_role">
68276827
<h3>Using <code>aria-level</code> with the <code>treeitem</code> Role</h3>
68286828
<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>.
68306830
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>.
68316831
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>.
68326832
However, in some implementations of the <a href="#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>
68486848

68496849
<section id="aria-level_row_role">
68506850
<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 <a href="#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 <a href="#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>
68526852
<pre><code>&lt;table role='treegrid'&gt;
68536853
&lt;tr&gt;
68546854
&lt;th&gt;From:&lt;/th&gt;
@@ -6864,7 +6864,7 @@ <h3>Using <code>aria-level</code> with the <code>row</code> Role</h3>
68646864
&lt;/tr&gt;
68656865
&lt;/table&gt;
68666866
</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>
68686868
</section>
68696869
</section>
68706870

0 commit comments

Comments
 (0)