Important: This website does not attempt to establish a standard for how assistive technologies must behave. Read the FAQ for more information. Additionally, this is a work in progress. Please submit feedback or suggestions.

aria-invalid attribute (aria)

Screen Reader support level: partial (57/66)

On this page

About this feature

Indicates the entered value does not conform to the format expected by the application. See related aria-errormessage.

Age of results

Results across all tests for this feature range from 2 years ago to 4 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 4 years ago. Consider running the associated tests and contributing results.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
MUST convey the "false" valuesupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported
MUST convey the "true" valuesupportedsupportedsupportedsupportedsupportedsupportedsupportedpartial (1/2)nonepartial (1/2)supported
MUST NOT convey the "grammar" valuesupportedsupportedpartialpartialsupportedsupportedsupportedsupportednonesupportedsupported
MUST NOT convey the "spelling" valuesupportedsupportedsupportedpartialsupportedsupportedsupportedsupportednonesupportedsupported

Expectation: convey the "false" value

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples:

  • The "false" value indicates that the input does not have an error.
  • Screen readers may imply this by not conveying the presence of the attribute at all. Most screen readers do not explicitly indicate that the input is valid.
Screen Reader support for 'MUST convey the "false" value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-invalid test suite applied to: input[type="text"] elementsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported
aria-invalid test suite applied to: select elementsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported

Expectation: convey the "true" value

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA

Examples:

  • The "true" value indicates that the input is invalid.
Screen Reader support for 'MUST convey the "true" value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-invalid test suite applied to: input[type="text"] elementsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportednonesupportedsupported
aria-invalid test suite applied to: select elementsupportedsupportedsupportedsupportedsupportedsupportedsupportednonenonenonesupported

Expectation: convey the "grammar" value

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST NOT
  • Voice Control: NA

Examples:

  • The "grammar" value indicates that the input has a grammar error.
Screen Reader support for 'MUST NOT convey the "grammar" value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-invalid test suite applied to: input[type="text"] elementsupportedsupportedpartialpartialsupportedsupportedsupportedsupportednonesupportedsupported

Expectation: convey the "spelling" value

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST NOT
  • Voice Control: NA

Examples:

  • The "spelling" value indicates that the input has a spelling error.
Screen Reader support for 'MUST NOT convey the "spelling" value'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-invalid test suite applied to: input[type="text"] elementsupportedsupportedsupportedpartialsupportedsupportedsupportedsupportednonesupportedsupported
TestLast update
aria-invalid test suite2021-11-10

Is something not right?

We use our GitHub repository to manage our issue tracking. Please provide as much information as you can for issues, and please leave the id in the issue title intact.

Create an issue for this feature