aria-roledescription attribute (aria)
Screen reader support level: partial (17/23)
Voice Control support level: unknown
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 a year ago to 4 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 4 years ago. Consider running the associated tests and contributing results.
Expectations
Screen Reader support by expectation
| Expectation | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| MUST convey the value of the roledescription attribute as the role | supported | supported | partial (1/2) | supported | supported | supported | supported | supported | none | none | supported |
Voice Control support by expectation
| Expectation | Dragon Naturally Speaking | Voice Access (Android) | Voice Control (iOS) | Voice Control (MacOS) | Windows Speech Recognition | Windows Voice Access | ||
|---|---|---|---|---|---|---|---|---|
| Chrome | Chrome | Safari | Safari | Edge | Chrome | Edge | Chrome | |
| 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 this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| aria-roledescription attribute with HTML button applied to: button element | supported | supported | supported | supported | supported | supported | supported | supported | none | none | supported |
| aria-roledescription attribute with HTML section applied to: section element | supported | supported | none | supported | supported | supported | supported | supported | none | none | supported |