CARVIEW |
Important: This website does not attempt to establish a standard for how assistive technologies must behave. Read the FAQ for more information. Additionally, this is a work in progress. Please submit feedback or suggestions.
combobox role (aria)
Screen Reader support level: supported
Voice Control support level: supported
On this page
About this feature
A composite widget containing a single-line textbox and another element, such as a listbox or grid, that can dynamically pop up to help the user set the value of the textbox.
Age of results
Results across all tests for this feature range from a year ago to 5 years ago. Detailed dates and version information can be found in associated tests.
Caution
Failing or partial results may be out of date. The oldest result is from 2 years ago. Consider running the associated tests and contributing results.
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 | supported | supported | supported | supported | supported | supported | supported | supported |
MUST convey that the combobox is editable | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
MUST convey changes in value | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
MUST convey the current value | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
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 | |
MUST convey its name | supported | supported | supported | supported | supported | supported | supported | supported |
MUST convey its role | supported | supported | not applicable | supported | supported | supported | supported | supported |
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: MUST
Examples:
- A screen reader might convey the name as something like "<role>, <name>, <value>" (order varies by screen reader and settings)
- Voice control software might allow the user to say "click <name>" to focus the combobox
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 applied to: input[type="text"] element | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
Test | 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 | |
APG Editable Combobox With List Autocomplete Example applied to: input[type="text"] element | 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: MUST
Examples:
- A screen reader might convey the role as something like "combo box"
- Voice control software might allow the user to say "click text box" to focus an editable combobox
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 applied to: input[type="text"] element | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
Test | 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 | |
APG Editable Combobox With List Autocomplete Example applied to: input[type="text"] element | supported | supported | not applicable | supported | supported | supported | supported | supported |
Expectation: convey that the combobox is editable
Rationale:
users should be made aware that they can type into a combobox. Not all comboboxes are editable.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- A screen reader might convey that the combobox is editable by announcing something like "editable"
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 applied to: input[type="text"] element | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
Expectation: convey changes in value
Rationale:
The user needs to know that the value was successfully changed.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- A screen reader might announce the new value after it has been changed
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 applied to: input[type="text"] element | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
Expectation: convey the current value
Rationale:
A screen reader user needs to know the current value of the input.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Notes:
Historically, this has not been a requirement explicitly defined in the ARIA spec. However, native counterparts do this, the value us displayed visually, and ARIA 1.2 (draft) does explicitly state this requirement.
Examples:
- A screen reader might convey the value as something like "<role>, <name>, <value>" (order varies by screen reader and settings)
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 applied to: input[type="text"] element | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
Expectation: provide shortcuts to jump to this role
Rationale:
Screen reader users might want to quickly navigate to elements of this type.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: SHOULD
- Voice Control: NA
Examples:
- A screen reader might provide a keyboard shortcut to jump to the next form control or provide a list of all form controls
No tests reference this expectation yet.
Tests
Test | Last update |
---|---|
APG Editable Combobox With List Autocomplete Example | 2025-08-15 |
Is something not right?
We use our GitHub repository to manage our issue tracking. Please provide as much information as you can for issues, and please leave the id in the issue title intact.
Create an issue for this feature