list
Characteristics
Superclass Role:
- region
Subclass Roles:
- directory
- listbox
- menu
Base Concept:
- HTML ul
- HTML ol
Required Owned Elements:
- group → listitem
- listitem
See Related:
- listbox
Inherited States and Properties:
- aria-atomic
- aria-busy (state)
- aria-controls
- aria-describedby
- aria-disabled (state)
- aria-dropeffect
- aria-expanded (state)
- aria-flowto
- aria-grabbed (state)
- aria-haspopup
- aria-hidden (state)
- aria-invalid (state)
- aria-label
- aria-labelledby
- aria-live
- aria-owns
- aria-relevant
Name From:
- author
A group of non-interactive list items.
Sometimes content developers want to put together few bulleted points. As per HTML semantics, any related elements having more than 3 items should be wrapped in HTML lists. Due to various reasons, HTML lists might not be possible. In such scenarios, aria list role can be used. In the < div>
containing the items just add the role="list" and that should do the magic.
Lists contain children whose role is listitem, or elements whose role is group which in turn contains children whose role is listitem.
Syntax
<div role="list">List Items</div>
Microsoft Active Accessibility accRole Property:
- ROLE_SYSTEM_LIST
UI Automation ControlType Property:
- List
UI Automation AriaRole Property:
- list