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-expanded attribute (aria)

Screen Reader support level: partial (80/88)

On this page

About this feature

Indicates whether the element, or another grouping element it controls, is currently expanded or collapsed.

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 3 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 "false" valuesupportedsupportedsupportedsupportedsupportedsupportedsupportedpartial (2/3)supportedsupportedpartial (2/3)
MUST convey the "true" valuesupportedsupportedsupportedsupportedsupportedsupportedsupportedpartial (2/3)supportedsupportedpartial (2/3)
MUST convey change in valuepartial (1/2)partial (1/2)supportedsupportedsupportedsupportedsupportedsupportedsupportedpartial (1/2)partial (1/2)

Expectation: convey the "false" value

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples:

  • Most screen readers will announce the state as "collapsed"
Screen Reader support for 'MUST convey the "false" value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
APG Editable Combobox With List Autocomplete Example applied to: combobox rolesupportedsupportedsupportedsupportedsupportedsupportedsupportednonesupportedsupportednone
APG Editable Combobox With List Autocomplete Example applied to: button elementsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported
Disclosure widget (show/hide) applied to: button elementsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported

Expectation: convey the "true" value

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples:

  • Most screen readers will announce the state as "expanded"
Screen Reader support for 'MUST convey the "true" value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
APG Editable Combobox With List Autocomplete Example applied to: combobox rolesupportedsupportedsupportedsupportedsupportedsupportedsupportednonesupportedsupportednone
APG Editable Combobox With List Autocomplete Example applied to: button elementsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported
Disclosure widget (show/hide) applied to: button elementsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported

Expectation: convey change 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:

  • If the element with aria-expanded has focus when its expanded state changes, the new state value will be announced (either "expanded" or "collapsed"). Some screen readers will re-announce the entire element, including name, role, and other properties and states.
Screen Reader support for 'MUST convey change in value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
APG Editable Combobox With List Autocomplete Example applied to: combobox rolesupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportednonenone
Disclosure widget (show/hide) applied to: button elementpartialpartialsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported
TestLast update
APG Editable Combobox With List Autocomplete Example2023-08-22
Disclosure widget (show/hide)2021-07-23

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