aria-roledescription attribute (aria)

On this page

• Expectations
  • convey the value of the roledescription attribute as the role
• Related tests
• Related AT or browser issues
• Is something not right?

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

Expectations

What are expectations?

Screen Reader support by expectation

Voice Control support by expectation

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

AT	Browser	Has Support
Dragon Naturally Speaking	Google Chrome	not applicable
JAWS	Google Chrome	partial (1/2)
JAWS	Internet Explorer	partial (1/2)
JAWS	Firefox (desktop)	partial (1/2)
Narrator	Microsoft Edge	supported
NVDA	Google Chrome	supported
NVDA	Firefox (desktop)	supported
Orca	Firefox (desktop)	supported
TalkBack	Google Chrome (android)	none
Voice Access for Android	Google Chrome (android)	not applicable
Voice Control for iOS	Safari (iOS)	not applicable
Voice Control for MacOS	Safari (macOS)	not applicable
VoiceOver for iOS	Safari (iOS)	partial (1/2)
VoiceOver for macOS	Safari (macOS)	supported

This expectation is referenced by 2 tests.

Tests that reference this expectation

Test name	Screen Reader support	Voice Control support
aria-roledescription attribute with HTML button	partial (9/10)	not applicable
aria-roledescription attribute with HTML section	partial (5/10)	not applicable