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

aria-roledescription attribute (aria)

Screen reader support level: partial (13/20)

Voice Control support level: not applicable

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 9 months ago to 9 months ago. Detailed dates and version information can be found in associated tests.

Failing and partial results are between 9 months ago and 9 months ago.


What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
MUST convey the value of the roledescription attribute as the rolepartial (1/2)partial (1/2)partial (1/2)partial (1/2)supportedsupportedsupportednonepartial (1/2)supported

Voice Control support by expectation

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

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 these expectations 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)
aria-roledescription attribute with HTML button applied to: button elementsupportedsupportedsupportedsupportedsupportedsupportedsupportednonesupportedsupported
aria-roledescription attribute with HTML section applied to: section elementnonenonenonepartialsupportedsupportedsupportednonenonesupported