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 for iOSVoiceOver for 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 for AndroidVoice Control for iOSVoice Control for MacOS
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
ATBrowserHas Support
Dragon Naturally SpeakingGoogle Chromenot applicable
JAWSGoogle Chromenone
JAWSInternet Explorersupported
JAWSFirefox (desktop)supported
NarratorMicrosoft Edgesupported
NVDAGoogle Chromenone
NVDAFirefox (desktop)none
OrcaFirefox (desktop)supported
TalkBackGoogle Chrome (android)supported
Voice Access for AndroidGoogle Chrome (android)not applicable
Voice Control for iOSSafari (iOS)not applicable
Voice Control for MacOSSafari (macOS)not applicable
VoiceOver for iOSSafari (iOS)supported
VoiceOver for macOSSafari (macOS)supported

This expectation is referenced by 1 tests.

Tests that reference this expectation
Test nameScreen Reader supportVoice Control support
ARIA gridcell role with aria-selectedpartial (15/40)not applicable

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
ATBrowserHas Support
Dragon Naturally SpeakingGoogle Chromenot applicable
JAWSGoogle Chromenone
JAWSInternet Explorernone
JAWSFirefox (desktop)none
NarratorMicrosoft Edgenone
NVDAGoogle Chromesupported
NVDAFirefox (desktop)supported
OrcaFirefox (desktop)supported
TalkBackGoogle Chrome (android)none
Voice Access for AndroidGoogle Chrome (android)not applicable
Voice Control for iOSSafari (iOS)not applicable
Voice Control for MacOSSafari (macOS)not applicable
VoiceOver for iOSSafari (iOS)none
VoiceOver for macOSSafari (macOS)none

This expectation is referenced by 1 tests.

Tests that reference this expectation
Test nameScreen Reader supportVoice Control support
ARIA gridcell role with aria-selectedpartial (15/40)not applicable

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
ATBrowserHas Support
Dragon Naturally SpeakingGoogle Chromenot applicable
JAWSGoogle Chromesupported
JAWSInternet Explorernone
JAWSFirefox (desktop)none
NarratorMicrosoft Edgesupported
NVDAGoogle Chromenone
NVDAFirefox (desktop)none
OrcaFirefox (desktop)unknown
TalkBackGoogle Chrome (android)supported
Voice Access for AndroidGoogle Chrome (android)not applicable
Voice Control for iOSSafari (iOS)not applicable
Voice Control for MacOSSafari (macOS)not applicable
VoiceOver for iOSSafari (iOS)none
VoiceOver for macOSSafari (macOS)none

This expectation is referenced by 1 tests.

Tests that reference this expectation
Test nameScreen Reader supportVoice Control support
ARIA gridcell role with aria-selectedpartial (15/40)not applicable

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
ATBrowserHas Support
Dragon Naturally SpeakingGoogle Chromenot applicable
JAWSGoogle Chromenone
JAWSInternet Explorernone
JAWSFirefox (desktop)none
NarratorMicrosoft Edgesupported
NVDAGoogle Chromesupported
NVDAFirefox (desktop)none
OrcaFirefox (desktop)none
TalkBackGoogle Chrome (android)partial
Voice Access for AndroidGoogle Chrome (android)not applicable
Voice Control for iOSSafari (iOS)not applicable
Voice Control for MacOSSafari (macOS)not applicable
VoiceOver for iOSSafari (iOS)none
VoiceOver for macOSSafari (macOS)none

This expectation is referenced by 1 tests.

Tests that reference this expectation
Test nameScreen Reader supportVoice Control support
ARIA gridcell role with aria-selectedpartial (15/40)not applicable