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

aria-checked attribute (aria)

Screen reader support level: supported

Voice Control support level: not applicable

On this page

Indicates the current "checked" state of checkboxes, radio buttons, and other widgets. See related aria-pressed and aria-selected.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver for iOSVoiceOver for macOS
MUST convey the "false" valuesupportedsupportedsupportedsupportedsupportedsupportedsupported
MUST convey the "true" valuesupportedsupportedsupportedsupportedsupportedsupportedsupported
MUST convey a change in value when changed by the usersupportedsupportedsupportedsupportedsupportedsupportedsupported

Voice Control support by expectation

ExpectationDragon Naturally SpeakingVoice Access for AndroidVoice Control for iOSVoice Control for MacOS
Not applicable

Expectation: convey the "false" value

Rationale: The user needs to be able to tell that the element is not checked

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 Explorersupported
JAWSFirefox (desktop)supported
NarratorMicrosoft Edgesupported
NVDAGoogle Chromesupported
NVDAFirefox (desktop)supported
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
APG 1.1 Checkbox Example (Two State)partial (102/140)supported

Expectation: convey the "true" value

Rationale: The user needs to be able to tell that the element is checked

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 Explorersupported
JAWSFirefox (desktop)supported
NarratorMicrosoft Edgesupported
NVDAGoogle Chromesupported
NVDAFirefox (desktop)supported
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
APG 1.1 Checkbox Example (Two State)partial (102/140)supported

Expectation: convey the "mixed" value

Rationale: The user needs to be able to tell that the element is mixed

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

No tests reference this expectation yet.

Expectation: convey a change in value when changed by the user

Rationale: The user needs to know what the new value is and that the change was successful

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 Explorersupported
JAWSFirefox (desktop)supported
NarratorMicrosoft Edgesupported
NVDAGoogle Chromesupported
NVDAFirefox (desktop)supported
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
APG 1.1 Checkbox Example (Two State)partial (102/140)supported