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

Indicates the current "selected" state of various widgets. See related aria-checked and aria-pressed.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
MUST convey undefined value by indicating that the element is not selectablepartial (2/3)supportednonesupportedsupportedsupportedsupported
MUST convey false value by indicating that the element can be selectednonenonesupportedsupportednonenonenone
MUST convey true value by indicating that the element is currently selectedpartial (1/3)supportednoneunknownsupportednonenone
MUST convey changes to aria-selected valuenonesupportedpartial (1/2)nonepartialnonenone

Voice Control support by expectation

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

Expectation: convey undefined value by indicating that the element is not selectable

Strength of these expectations 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-selectednonesupportedsupportedsupportednonenonesupportedsupportedsupportedsupported

Expectation: convey false value by indicating that the element can be selected

Strength of these expectations 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-selectednonenonenonenonesupportedsupportedsupportednonenonenone

Expectation: convey true value by indicating that the element is currently selected

Strength of these expectations 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-selectedsupportednonenonesupportednonenoneunknownsupportednonenone

Expectation: convey changes to aria-selected value

Rationale: The user needs to know that the value was successfully changed.

Strength of these expectations 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-selectednonenonenonesupportedsupportednonenonepartialnonenone