diff --git a/index.html b/index.html index 82e24a8cb..2c510e386 100644 --- a/index.html +++ b/index.html @@ -4785,7 +4785,19 @@

Definition of Roles

listviewitem

An item in a listview.

-

A listviewitem can be focusable and selectable.

+

+ A listviewitem can be focusable and selectable. + As described in the definition of listview, if a listviewitem contains a single interactive element, authors SHOULD set focus on the contained element in lieu of focusing the listviewitem. + Otherwise, authors SHOULD ensure a listviewitem is focusable. +

+

+ If a listviewitem 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 id for the item and reference it with aria-labelledby. + However, for more complex rich content where authors have provided a method for moving focus inside of the listviewitem as described in listview, 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 aria-labelledby or aria-label to specify a sufficiently distinct and concise name. + In addition, authors MAY apply aria-describedby to listviewitem elements in a listview to suggest to screen readers which elements contained by the listviewitem to announce after its label when users navigate by listviewitem. + 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. +

A listviewitem element can contain a nested collection of listviewitem elements. A nested collection of listviewitem elements is enclosed in an element with the group role. @@ -4874,16 +4886,11 @@

Definition of Roles

Name From: - - - + author Accessible Name Required: - + When Focusable Inherits Name Required: