Skip to content

Commit

Permalink
change naming requirements
Browse files Browse the repository at this point in the history
  • Loading branch information
mcking65 committed Sep 16, 2024
1 parent bcc00a5 commit d91e5fd
Showing 1 changed file with 15 additions and 8 deletions.
23 changes: 15 additions & 8 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -4785,7 +4785,19 @@ <h2>Definition of Roles</h2>
<rdef>listviewitem</rdef>
<div class="role-description">
<p>An item in a <rref>listview</rref>.</p>
<p>A <code>listviewitem</code> can be focusable and selectable.</p>
<p>
A <code>listviewitem</code> can be focusable and selectable.
As described in the definition of <rref>listview</rref>, if a <code>listviewitem</code> contains a single interactive element, authors SHOULD set focus on the contained element in lieu of focusing the <code>listviewitem</code>.
Otherwise, authors SHOULD ensure a <code>listviewitem</code> is focusable.
</p>
<p>
If a <code>listviewitem</code> is focusable, authors MUST specify an accessible name.
For simple items, authors MAY simply specify a label that contains all the item's content, e.g., specify an <code>id</code> for the item and reference it with <pref>aria-labelledby</pref>.
However, for more complex rich content where authors have provided a method for moving focus inside of the <code>listviewitem</code> as described in <rref>listview</rref>, authors can provide assistive technology users with a more efficient navigation experience by providing a concise accessible name and description.
In such implementations, authors MAY use <pref>aria-labelledby</pref> or <pref>aria-label</pref> to specify a sufficiently distinct and concise name.
In addition, authors MAY apply <pref>aria-describedby</pref> to <rref>listviewitem</rref> elements in a <code>listview</code> to suggest to screen readers which elements contained by the <code>listviewitem </code> to announce after its label when users navigate by <rref>listviewitem</rref>.
This enables authors to create a navigation experience that filters out repetitive or less important elements, such as embedded interaction widgets that appear in every item.
</p>
<p>
A <code>listviewitem</code> <a>element</a> can contain a nested collection of <code>listviewitem</code> elements.
A nested collection of <code>listviewitem</code> elements is enclosed in an element with the <rref>group</rref> <a>role</a>.
Expand Down Expand Up @@ -4874,16 +4886,11 @@ <h2>Definition of Roles</h2>
</tr>
<tr>
<th class="role-namefrom-head" scope="row">Name From:</th>
<td class="role-namefrom">
<ul>
<li>contents</li>
<li>author</li>
</ul>
</td>
<td class="role-namefrom">author</td>
</tr>
<tr>
<th class="role-namerequired-head" scope="row">Accessible Name Required:</th>
<td class="role-namerequired"> </td>
<td class="role-namerequired">When Focusable</td>
</tr>
<tr>
<th class="role-namerequired-inherited-head" scope="row">Inherits Name Required:</th>
Expand Down

0 comments on commit d91e5fd

Please sign in to comment.