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 10 months 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 10 months 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 |