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

aria-roledescription attribute (aria)

Support level: partial (7/18)

On this page

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


Expectations are conditions that must be met for the feature to be considered as "supported". Only "MUST" expectations need to be met for minimal "support". "SHOULD" and "MAY" expectations indicates support that goes above and beyond. Note that there is not an explicit standard that dictates these expectations, and as such, they are likely opinionated. As such, a feature might not meet all "MUST" expectations but still be usable (potentially frustratingly so). Additionally, the assistive technology may provide many different commands to read, navigate, or otherwise interact with a feature. Only one command is required to pass for the expectation to be minimally supported.

Summary of support by expectation type

partial (7/18)

Summary of support by expectation and assistive technology

ExpectationDragon Naturally SpeakingJAWSNarratorNVDATalkBackVoiceOver for iOSVoiceOver for macOS
MUST convey the value of the roledescription attribute as the rolenot applicablepartial (1/6)partial (1/2)supported with 2 unknown resultsunknownpartial (1/2)supported

The screen reader MUST convey the value of the roledescription attribute as the role

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

ATBrowserHas Support
Dragon Naturally SpeakingGoogle Chromenot applicable
JAWSGoogle Chromeunknown
JAWSInternet Explorerpartial (1/2)
JAWSFirefox (desktop)unknown
NarratorMicrosoft Edgepartial (1/2)
NVDAGoogle Chromeunknown
NVDAFirefox (desktop)supported
TalkBackGoogle Chrome (android)unknown
VoiceOver for iOSSafari (iOS)partial (1/2)
VoiceOver for macOSSafari (macOS)supported

This expectation is referenced by 2 tests.

Tests that reference this expectation
test namehas support
aria-roledescription attribute with HTML buttonsupported with 4 unknown results
aria-roledescription attribute with HTML sectionpartial (2/9)