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-roledescription attribute (aria)

Screen Reader support level: partial (17/22)

On this page

About this feature

Defines a human-readable, author-localized description for the role of an element.

Age of results

Results across all tests for this feature range from 3 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 5 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 value of the roledescription attribute as the rolesupportedsupportedpartial (1/2)supportedsupportedsupportedsupportedsupportednonenonesupported

Expectation: convey the value of the roledescription attribute as the role

Rationale:

A screen reader user needs to know the current value of the input.

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: NA
Screen Reader support for 'MUST convey the value of the roledescription attribute as the role'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
aria-roledescription attribute with HTML button applied to: button elementsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportednonenonesupported
aria-roledescription attribute with HTML section applied to: section elementsupportedsupportednonesupportedsupportedsupportedsupportedsupportednonenonesupported