Notice: This is a work in progress. Please submit feedback or suggestions.

aria-describedby attribute (aria)

Screen reader support level: partial (19/23)

Voice Control support level: unknown

On this page

About this feature

Identifies the element (or elements) that describes the object. See related aria-labelledby.

Age of results

Results across all tests for this feature range from 7 months ago to 3 years ago. Detailed dates and version information can be found in associated tests.

Failing and partial results are between 7 months ago and 3 years ago.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
MUST contribute to the descriptionsupportedsupportedsupportedsupportedsupportedsupportedsupportedpartial (1/2)supportedpartial (1/2)partial (1/2)
SHOULD convey description changes when in focussupportedsupportedsupportednonesupportedsupportedsupportednonenonenonepartial

Voice Control support by expectation

ExpectationDragon Naturally SpeakingVoice Access (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech Recognition
ChromeChromeSafariSafariChrome
Not applicable

Expectation: contribute to the description

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA
Screen Reader support for 'MUST contribute to the description'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-describedby attribute that references role="alert" applied to: input[type="text"] elementsupportedsupportedsupportedsupportedsupportedsupportedsupportedpartialsupportednonenone
aria-describedby attribute on a text input applied to: input[type="text"] elementsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported

Expectation: convey description changes when in focus

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: SHOULD
  • Voice Control: NA
Screen Reader support for 'SHOULD convey description changes when in focus'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-describedby attribute on a text input applied to: input[type="text"] elementsupportedsupportedsupportednonesupportedsupportedsupportednonenonenonepartial
TestLast update
aria-describedby attribute that references role="alert"2021-07-23
aria-describedby attribute on a text input2021-10-19

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