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

aria-errormessage attribute (aria)

Screen reader support level: partial (11/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 (iOS)VoiceOver (macOS)
MUST convey that the referenced error message is pertinentpartial (2/3)nonenonesupportednonenonenone
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 (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech Recognition
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
Screen Reader support for 'MUST convey that the referenced error message is pertinent'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
aria-errormessage attribute with aria-invalid="true"supportedsupportedpartialnonenonenonesupportednonenonenone

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
Screen Reader support for 'MUST NOT convey the error when the error message is NOT pertinent'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
aria-errormessage attribute with aria-invalid="true"supportednonesupportedsupportedunknownsupportedsupportedsupportedsupportedsupported