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

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

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
MUST convey the value of the roledescription attribute as the rolepartial (3/6)partial (1/2)supportedsupportednonepartial (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)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
aria-roledescription attribute with HTML buttonpartial (1/2)partial (1/2)partial (1/2)partial (1/2)supportedsupportedsupportednonepartial (1/2)supported
aria-roledescription attribute with HTML sectionpartial (1/2)partial (1/2)partial (1/2)partial (1/2)supportedsupportedsupportednonepartial (1/2)supported