aria-autocomplete attribute (aria)
Screen Reader support level: partial (11/55)
On this page
About this feature
Indicates whether inputting text could trigger display of one or more predictions of the user's intended value for an input and specifies how predictions would be presented if they are made.
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 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 `inline` value | none | none | none | none | partial | partial | partial | none | none | none | none |
| MUST convey the `list` value | none | none | none | none | partial | partial | partial | none | none | none | partial (1/2) |
| MUST convey the `both` value | none | none | none | none | partial | partial | partial | none | none | none | none |
| MUST convey the `none` value | supported | supported | supported | supported | supported | supported | none | supported | supported | supported | supported |
Expectation: convey the `inline` value
Rationale:
Screen reader users need to be aware that a form control has inline autocomplete behavior before they start typing so that the behavior is not unexpected.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| aria-autocomplete reduced test case applied to: input[type="text"] element | none | none | none | none | partial | partial | partial | none | none | none | none |
Expectation: convey the `list` value
Rationale:
Screen reader users need to be aware that a form control has list autocomplete behavior before they start typing so that the behavior is not unexpected. When used on a combobox, this value should hint to users that the popup contains auto complete suggestions rather than a static set of options.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
| 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: combobox role | none | none | none | none | partial | partial | partial | none | none | none | supported |
| aria-autocomplete reduced test case applied to: combobox role | none | none | none | none | partial | partial | partial | none | none | none | none |
Expectation: convey the `both` value
Rationale:
Screen reader users need to be aware that a form control has both inline and list autocomplete behavior before they start typing so that the behavior is not unexpected. When used on a combobox, this value should hint to users that the popup contains auto complete suggestions rather than a static set of options.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Expectation: convey the `none` value
Rationale:
Screen reader users should not be informed that auto complete behavior exists when the behavior does not exist.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- Screen readers will omit any announcements about autocomplete behavior.
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| aria-autocomplete reduced test case applied to: input[type="text"] element | supported | supported | supported | supported | supported | supported | none | supported | supported | supported | supported |