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 3 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.

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.

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