list attribute (html)
Screen Reader support level: partial (10/11)
On this page
About this feature
The list attribute is used to identify an element that lists predefined options suggested to the user.
Age of results
Results across all tests for this feature range from 3 years 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 5 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 the presence of the list attribute | supported | supported | supported | supported | supported | supported | supported | none | supported | supported | supported |
Expectation: convey the presence of the list attribute
Rationale:
The user needs to know that the input will provide suggestions.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- might announce that suggestions are available when the input receives focus.
- might announce that the input has auto complete functionality.
- might modify the role of the associated input to convey datalist functionality, such as changing "edit text" to "Combo box".
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| HTML input with datalist test applied to: input[type="text"] element | supported | supported | supported | supported | supported | supported | supported | none | supported | supported | supported |
Related features
These are features that are usually used in combination with this feature.
datalist element (html)
| Dragon | JAWS | Narrator | NVDA | Orca | TalkBack | Voice Access | VC iOS | VC MacOS | VoiceOver (iOS) | VoiceOver (macOS) | Speech Recognition | Windows Voice Access | Windows | Mac | iOS | Android Keyboard |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| supported with 1 unknown result | supported with 1 unknown result | supported with 1 unknown result | supported with 1 unknown result | partial (1/3) | supported with 1 unknown result | unknown | unknown | unknown | supported with 1 unknown result | no known support | unknown | unknown | unknown | unknown | unknown | unknown |
We are missing data on some combinations.