listbox
Characteristics
Superclass Role:
- list
- select
Related Concepts:
- HTML select
- XForms select
See Related:
- combobox
- list
Required Owned Elements:
- option
Supported States and Properties:
- aria-multiselectable
- aria-required
Inherited States and Properties:
- aria-activedescendant
- 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
Accessible Name Required:
- True
A widget that allows the user to select one or more items from a list of choices.
Listbox (role) is similar to a combobox role or a checkbox role. Unlike a combobox role, in listbox role the user can select more than one option.
Items within the list are static and, unlike standard HTML select elements, may contain images. List boxes contain children whose role is option.
To be keyboard accessible, authors should manage focus of descendants for all instances of this role.
Microsoft Active Accessibility accRole Property:
- ROLE_SYSTEM_LIST
UI Automation ControlType Property:
- List
UI Automation AriaRole Property:
- listbox