aria-selected attribute (aria)
Screen Reader support level: partial (21/54)
On this page
About this feature
Indicates the current "selected" state of various widgets. See related aria-checked and aria-pressed.
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
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 undefined value by indicating that the element is not selectable | supported | supported | supported | supported | supported | supported | none | supported | supported | supported | supported |
| MUST convey false value by indicating that the element can be selected | none | none | none | none | supported | supported | supported | none | none | none | none |
| MUST convey true value by indicating that the element is currently selected | partial (1/2) | partial (1/2) | none | supported | none | none | none | none | supported | none | none |
| MUST convey changes to aria-selected value | none | none | none | supported | supported | supported | none | none | partial | none | none |
Expectation: convey undefined value by indicating that the element is not selectable
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- A screen reader might imply that the the element is not selectable by not announcing the selected state at all.
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| ARIA gridcell role with aria-selected applied to: gridcell role | supported | supported | supported | supported | supported | supported | none | supported | supported | supported | supported |
Expectation: convey false value by indicating that the element can be selected
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- A screen reader might announce something like "not selected".
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| ARIA gridcell role with aria-selected applied to: gridcell role | none | none | none | none | supported | supported | supported | none | none | none | none |
Expectation: convey true value by indicating that the element is currently selected
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- A screen reader might announce something like "selected".
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| APG Editable Combobox With List Autocomplete Example applied to: option role | none | none | none | supported | none | none | none | none | not applicable | none | none |
| ARIA gridcell role with aria-selected applied to: gridcell role | supported | supported | none | supported | none | none | none | none | supported | none | none |
Expectation: convey changes to aria-selected 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
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| ARIA gridcell role with aria-selected applied to: gridcell role | none | none | none | supported | supported | supported | none | none | partial | none | none |