listbox role (aria)
Screen Reader support level: partial (21/22)
Voice Control support level: unknown
On this page
About this feature
A widget that allows the user to select one or more items from a list of choices. See related combobox and list.
Age of results
Results across all tests for this feature range from 8 months ago to 3 years ago. Detailed dates and version information can be found in associated tests.
Failing and partial results are between 8 months ago and 8 months ago.
Expectations
Screen Reader support by expectation
| Expectation | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| MUST convey its name | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
| MUST convey its role | supported | supported | supported | none | supported | supported | supported | supported | supported | supported | supported |
| SHOULD convey its boundaries | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | none |
Voice Control support by expectation
| Expectation | Dragon Naturally Speaking | Voice Access (Android) | Voice Control (iOS) | Voice Control (MacOS) | Windows Speech Recognition | Windows Voice Access | ||
|---|---|---|---|---|---|---|---|---|
| Chrome | Chrome | Safari | Safari | Edge | Chrome | Edge | Chrome | |
| Not applicable | ||||||||
Expectation: convey its name
Rationale:
A screen reader user needs to know what to enter.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- A screen reader might convey the name when entering the listbox
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| APG Editable Combobox With List Autocomplete Example | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
Expectation: convey its role
Rationale:
A screen reader user needs to know how they can interact with the element. Voice control software might use the role to help users activate controls that do not have a visible name.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- A screen reader might explicitly convey the role as something like "list box", "list", or imply it by explicitly conveying "option" roles
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| APG Editable Combobox With List Autocomplete Example | supported | supported | supported | none | supported | supported | supported | supported | supported | supported | supported |
Expectation: convey its boundaries
Rationale:
The user needs to know when they enter and leave the listbox.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: SHOULD
- Voice Control: NA
Examples:
- A screen reader might convey the listbox name and role when entering, and something like "out of list" when exiting
- A screen reader might convey information about the position in the options, such as "4 of 4" to indicate the start and end of the options
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| APG Editable Combobox With List Autocomplete Example | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | none |