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

aria-errormessage attribute (aria)

Screen reader support level: partial (12/20)

Voice Control support level: not applicable

On this page

Identifies the element that provides an error message for the object. See related aria-invalid and aria-describedby.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver for iOSVoiceOver for macOS
MUST convey that the referenced error message is pertinentsupportednonenonesupportednonenonenone
MUST NOT convey the error when the error message is NOT pertinentpartial (2/3)supportedsupported with 1 unknown resultsupportedsupportedsupportedsupported

Voice Control support by expectation

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

Expectation: convey that the referenced error message is pertinent

Rationale: Users need to know that the error message exists when the input is in an aria-invalid="true" state

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 Edgenone
NVDAGoogle Chromenone
NVDAFirefox (desktop)none
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-errormessage attribute with aria-invalid="true"partial (12/20)not applicable

Expectation: convey the error when the error message is NOT pertinent

Rationale: Users should not be made aware of the error message when the input is not in an error state

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: MUST NOT
  • Voice Control: NA
ATBrowserHas Support
Dragon Naturally SpeakingGoogle Chromenot applicable
JAWSGoogle Chromesupported
JAWSInternet Explorernone
JAWSFirefox (desktop)supported
NarratorMicrosoft Edgesupported
NVDAGoogle Chromeunknown
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
aria-errormessage attribute with aria-invalid="true"partial (12/20)not applicable