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

aria-expanded attribute (aria)

Screen reader support level: partial (90/103)

Voice Control support level: unknown

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

Failing and partial results are between a year ago and a year ago.

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" valuepartial (2/3)partial (4/6)partial (2/3)supportedsupportedsupportedsupportedsupportedsupportedsupportedpartial (2/3)
MUST convey change in valuepartial (1/2)partial (2/4)supportedsupportedsupportedsupportedsupportedsupportedsupportedpartial (1/2)partial (1/2)

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

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"

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.