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.

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

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

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
APG 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