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

About this feature

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

Age of results

Results across all tests for this feature range from a year ago to 2 years ago. Detailed dates and version information can be found in associated tests.

Caution

Failing or partial results may be out of date. The oldest result is from 2 years ago. Consider running the associated tests and contributing results.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
MUST convey that the referenced error message is pertinentsupportedsupportedpartialnonenonenonesupportednonenonenone
MUST NOT convey the error when the error message is NOT pertinentsupportednonesupportedsupportedunknownsupportedsupportedsupportedsupportedsupported

Voice Control support by expectation

ExpectationDragon Naturally SpeakingVoice Access (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech Recognition
ChromeChromeSafariSafariChrome
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 this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples:

  • screen readers might convey the accessible name of the referenced ID
  • screen readers might announce that an error message is present and provide a shortcut to jump to the error message
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" applied to: input[type="text"] elementsupportedsupportedpartialnonenonenonesupportednonenonenone

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 this expectation for different types of assistive technologies:

  • Screen Readers: MUST NOT
  • Voice Control: NA

Examples:

  • when an input has an error message but also has aria-invalid="false", the error message will not be conveyed because it is not pertinent
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" applied to: input[type="text"] elementsupportednonesupportedsupportedunknownsupportedsupportedsupportedsupportedsupported