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

aria-selected attribute (aria)

Screen reader support level: partial (15/40)

Voice Control support level: not applicable

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 a year 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 a year ago. Consider running the associated tests and contributing results.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
MUST convey undefined value by indicating that the element is not selectablenonesupportedsupportedsupportednonenonesupportedsupportedsupportedsupported
MUST convey false value by indicating that the element can be selectednonenonenonenonesupportedsupportedsupportednonenonenone
MUST convey true value by indicating that the element is currently selectedsupportednonenonesupportednonenoneunknownsupportednonenone
MUST convey changes to aria-selected valuenonenonenonesupportedsupportednonenonepartialnonenone

Voice Control support by expectation

ExpectationDragon Naturally SpeakingVoice Access (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech Recognition
ChromeChromeSafariSafariChrome
Not applicable

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
Screen Reader support for 'MUST convey undefined value by indicating that the element is not selectable'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
ARIA gridcell role with aria-selected applied to: gridcell rolenonesupportedsupportedsupportednonenonesupportedsupportedsupportedsupported

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
Screen Reader support for 'MUST convey false value by indicating that the element can be selected'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
ARIA gridcell role with aria-selected applied to: gridcell rolenonenonenonenonesupportedsupportedsupportednonenonenone

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
Screen Reader support for 'MUST convey true value by indicating that the element is currently selected'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
ARIA gridcell role with aria-selected applied to: gridcell rolesupportednonenonesupportednonenoneunknownsupportednonenone

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
Screen Reader support for 'MUST convey changes to aria-selected value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
ARIA gridcell role with aria-selected applied to: gridcell rolenonenonenonesupportedsupportednonenonepartialnonenone