aria-expanded attribute (aria)
Screen reader support level: partial (76/87)
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 2 years ago to 3 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
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 "false" value | supported | supported | supported | supported | supported | supported | supported | partial (2/3) | supported | supported | partial (2/3) |
| MUST convey the "true" value | partial (2/3) | partial (2/3) | partial (2/3) | supported | supported | supported | supported | supported | supported | supported | partial (2/3) |
| MUST convey change in value | partial (1/2) | partial (1/2) | supported | supported | supported | supported | supported | supported | supported | partial (1/2) | partial (1/2) |
Voice Control support by expectation
| Expectation | Dragon Naturally Speaking | Voice Access (Android) | Voice Control (iOS) | Voice Control (MacOS) | Windows Speech Recognition | Windows Voice Access | ||
|---|---|---|---|---|---|---|---|---|
| Chrome | Chrome | Safari | Safari | Edge | Chrome | Edge | Chrome | |
| 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"
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| DRAFT ARIA 1.2 Editable Combobox With List Autocomplete Example applied to: combobox role | supported | supported | supported | supported | supported | supported | supported | none | supported | supported | none |
| DRAFT ARIA 1.2 Editable Combobox With List Autocomplete Example applied to: button element | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
| Disclosure widget (show/hide) applied to: button element | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
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"
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| DRAFT ARIA 1.2 Editable Combobox With List Autocomplete Example applied to: button element | supported | supported | supported | not applicable | supported | supported | supported | supported | supported | supported | supported |
| DRAFT ARIA 1.2 Editable Combobox With List Autocomplete Example applied to: combobox role | none | none | none | not applicable | supported | supported | supported | supported | supported | supported | none |
| Disclosure widget (show/hide) applied to: button element | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
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.
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| DRAFT ARIA 1.2 Editable Combobox With List Autocomplete Example applied to: combobox role | supported | supported | supported | supported | supported | supported | supported | supported | supported | partial | none |
| Disclosure widget (show/hide) applied to: button element | partial | partial | supported | supported | supported | supported | supported | supported | supported | supported | supported |