diff --git a/index.html b/index.html index b887e641d..735388ea4 100644 --- a/index.html +++ b/index.html @@ -4551,6 +4551,277 @@
+ A composite
+ A listview
contains listview
to present a wide variety of collections.
+ For example, each item in a collection might contain:
+
+ A listview
can be used to present a hierarchical collection.
+ a
+ The primary purpose of a listview
is to make a collection navigable and interactive.
+ Elements in A listview can also be selectable, but they are not selectable by default.
+ Authors MAY specify either listview
allows multiple true
on the element with role listview
.
+
+ To be keyboard accessible, authors SHOULD manage focus of descendants of a listview
as described in Managing Focus.
+ When users are moving focus among items in a listview
, authors SHOULD set focus as follows:
+
Authors SHOULD provide a mechanism for moving focus into and out of a
+ Depending on the implementation, pressing Enter, Space, or another key would move focus from the listview
.
+ For example, if an item in a list of video preview cards contains a video player, the Enter key might be used to move focus from the
+ The listview
role does not assume any particular form of visual presentation.
+ A listview
can scroll in any direction as users move focus.
+ Items can be arranged in a single column, a single row, or in multiple columns or rows.
+ Authors SHOULD indicate whether the order of the collection is presented horizontally or vertically with vertical
.
+ This would inform assistive technology users that moving focus with the down arrow key would move focus from the first card to the second card whereas pressing the right arrow key (if supported) would move focus from the first card to the fifth card.
+
+ Since WAI-ARIA can augment an element of the host language, a listview
can reuse the elements and attributes of a native list, such as an HTML ul
element.
+ For example, if an author applies the listview
role to an HTML ul
element, the author does not need to apply the li
elements because the user agent will automatically make the appropriate translations.
+
Characteristic | +Value | +
---|---|
Is Abstract: | ++ |
Superclass Role: | +
+
|
+
Subclass Roles: | +Placeholder | +
Base Concept: | +<[^ul^]> in HTML |
+
Related Concepts: | ++ |
Required Accessibility Parent Roles: | ++ |
Allowed Accessibility Child Roles: | +|
Required States and Properties: | ++ |
Supported States and Properties: | +
+
|
+
Inherited States and Properties: | +Placeholder | +
Name From: | +author | +
Accessible Name Required: | +True | +
Inherits Name Required: | ++ |
Children Presentational: | ++ |
Inherits Presentational: | ++ |
An item in a
+ A listviewitem
can be focusable and selectable.
+ As described in the definition of 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 listviewitem
as described in listview
to suggest to screen readers which elements contained by the listviewitem
to announce after its label when users navigate by
+ A listviewitem
element can contain a nested collection of listviewitem
elements.
+ A nested collection of listviewitem
elements is enclosed in an element with the listviewitem
elements can be expanded and collapsed, authors MUST specify a value for listviewitem
+
Authors MUST ensure [=elements=] with role listviewitem
are accessibility children of an element with role
+ Authors MAY indicate selection for
User agents MUST NOT provide an implicit value for listviewitem
elements.
Characteristic | +Value | +
---|---|
Is Abstract: | ++ |
Superclass Role: | +
+
|
+
Subclass Roles: | +Placeholder | +
Base Concept: | +<[^li^]> in HTML |
+
Related Concepts: | ++ |
Required Accessibility Parent Roles: | +
+
|
+
Allowed Accessibility Child Roles: | ++ |
Required States and Properties: | ++ |
Supported States and Properties: | +
+
|
+
Inherited States and Properties: | +Placeholder | +
Name From: | +author | +
Accessible Name Required: | +When Focusable | +
Inherits Name Required: | ++ |
Children Presentational: | ++ |
Inherits Presentational: | ++ |