aria-errormessage attribute (aria)
Screen Reader support level: partial (15/22)
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 2 years ago to 5 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
Screen Reader support by expectation
| Expectation | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| MUST convey that the referenced error message is pertinent | supported | supported | none | none | none | none | none | supported | none | supported | none |
| MUST NOT convey the error when the error message is NOT pertinent | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
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
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| aria-errormessage attribute with aria-invalid="true" applied to: input[type="text"] element | supported | supported | none | none | none | none | none | supported | none | supported | none |
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
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| aria-errormessage attribute with aria-invalid="true" applied to: input[type="text"] element | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |