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

aria-roledescription attribute (aria)

Screen reader support level: partial (14/20)

Voice Control support level: not applicable

On this page

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


What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver for iOSVoiceOver for macOS
MUST convey the value of the roledescription attribute as the rolepartial (3/6)supportedsupportedsupportednonepartial (1/2)supported

Voice Control support by expectation

ExpectationDragon Naturally SpeakingVoice Access for AndroidVoice Control for iOSVoice Control for MacOS
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
ATBrowserHas Support
Dragon Naturally SpeakingGoogle Chromenot applicable
JAWSGoogle Chromepartial (1/2)
JAWSInternet Explorerpartial (1/2)
JAWSFirefox (desktop)partial (1/2)
NarratorMicrosoft Edgesupported
NVDAGoogle Chromesupported
NVDAFirefox (desktop)supported
OrcaFirefox (desktop)supported
TalkBackGoogle Chrome (android)none
Voice Access for AndroidGoogle Chrome (android)not applicable
Voice Control for iOSSafari (iOS)not applicable
Voice Control for MacOSSafari (macOS)not applicable
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 nameScreen Reader supportVoice Control support
aria-roledescription attribute with HTML buttonpartial (9/10)not applicable
aria-roledescription attribute with HTML sectionpartial (5/10)not applicable