Notice: This is a work in progress. Please submit feedback or suggestions.

aria-autocomplete attribute (aria)

Screen reader support level: partial (13/66)

Voice Control support level: unknown

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 month ago to 2 years ago. Detailed dates and version information can be found in associated tests.

Failing and partial results are between 2 years ago and 2 years ago.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
MUST convey the `inline` valuenonenonenonenonepartialpartialpartialnonenonenonenone
MUST convey the `list` valuenonenonenonenonepartialpartialpartialnonenonenonepartial (1/2)
MUST convey the `both` valuenonenonenonenonepartialpartialpartialnonenonenonenone
MUST convey the `none` valuesupportedsupportedsupportedsupportedsupportedsupportednonesupportedsupportedsupportedsupported

Voice Control support by expectation

ExpectationDragon Naturally SpeakingVoice Access (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech Recognition
ChromeChromeSafariSafariChrome
Not applicable

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
Screen Reader support for 'MUST convey the `inline` value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-autocomplete reduced test case applied to: input[type="text"] elementnonenonenonenonepartialpartialpartialnonenonenonenone

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
Screen Reader support for 'MUST convey the `list` value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
DRAFT ARIA 1.2 Editable Combobox With List Autocomplete Example applied to: combobox rolenonenonenonenonepartialpartialpartialnonenonenonesupported
aria-autocomplete reduced test case applied to: combobox rolenonenonenonenonepartialpartialpartialnonenonenonenone

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
Screen Reader support for 'MUST convey the `both` value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-autocomplete reduced test case applied to: combobox rolenonenonenonenonepartialpartialpartialnonenonenonenone

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.
Screen Reader support for 'MUST convey the `none` value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-autocomplete reduced test case applied to: input[type="text"] elementsupportedsupportedsupportedsupportedsupportedsupportednonesupportedsupportedsupportedsupported