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

Test: aria-roledescription attribute with HTML section

Current support: partial (2/9)

This test ensures that the value of aria-roledescription is announced by screen readers

Run this test and and submit your results

On this page

Test HTML

open the test page in a new tab
<!DOCTYPE html>
<html lang="en">
<head>
    <title>aria-roledescription attribute with the HTML section element</title>
</head>
<body>
    <p>Use the screen reader to announce the target element.</p>
    <section aria-roledescription="custom section role" id="target" aria-label="section name">
        Target
    </section>
</body>
</html>

Support tables

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

MUSTSHOULDMAY
partial (2/9)

Summary of support by expectation and assistive technology

ExpectationDragon Naturally SpeakingJAWSNarratorNVDATalkBackVoiceOver for iOSVoiceOver for macOS
aria-roledescription attribute
MUST convey the value of the roledescription attribute as the rolenot applicableno known supportnonesupported with 1 unknown resultunknownnonesupported

* means that some support is hidden behind settings

Detailed support results by expectation

aria-roledescription attribute: 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.

Grading method: Just one of the listed commands must pass for the expectation to pass.

This expectation is from the aria-roledescription attribute feature.

ATBrowserHas SupportOutputAction
Dragon Naturally SpeakingGoogle Chromenot applicable-More information
JAWSGoogle Chromeunknown-More information
JAWSInternet Explorernone
  • Result: (fail)
    • command: Down arrow (Read next item)
    • Output: Target
More information
JAWSFirefox (desktop)unknown-More information
NarratorMicrosoft Edgenone
  • Result: (fail)
    • command: Down arrow (Read next item (scan mode))
    • Output: Target
More information
NVDAGoogle Chromeunknown-More information
NVDAFirefox (desktop)yes
  • Result: (pass)
    • command: down arrow (Read next item)
    • Output: Section name custom section role. Target.
More information
TalkBackGoogle Chrome (android)unknown-More information
VoiceOver for iOSSafari (iOS)none
  • Result: (fail)
    • command: Swipe Right (Next item)
    • Output: Target, section name, landmark
More information
VoiceOver for macOSSafari (macOS)yes
  • Result: (pass)
    • command: VO + Right arrow (Read next item)
    • Output: Section name, custom section role
More information

Extended Support for: aria-roledescription attribute: The screen reader MUST convey the value of the roledescription attribute as the role

These are less common combinations

ATBrowserHas SupportOutputAction
Dragon Naturally SpeakingInternet Explorernot applicable-More information
Dragon Naturally SpeakingFirefox (desktop)not applicable-More information
JAWS 2018.1808.10Microsoft Edge 44.17763.1.0none
  • Result: (fail)
    • command: Down arrow (Read next item)
    • Output: Target
More information
NarratorFirefox (desktop)unknown-More information
NarratorGoogle Chromeunknown-More information
NarratorInternet Explorerunknown-More information
NVDAInternet Explorerunknown-More information
NVDAMicrosoft Edgeunknown-More information
TalkBackFirefox (Android)unknown-More information
VoiceOver for iOSGoogle Chrome (ios)unknown-More information
VoiceOver for macOSGoogle Chromeunknown-More information
VoiceOver for macOSFirefox (desktop)unknown-More information
Back to top

Dates and Versions

ATAT VersionBrowserBrowser versionOS versionDate tested
JAWS2018.1808.10Internet Explorer11.55177632018-11-12
Narrator17763Microsoft Edge44.17763.1.0177632018-11-12
NVDA2018.3.2Firefox (desktop)63.0.1177632018-11-12
VoiceOver for iOS12.1Safari (iOS)12.112.12018-11-12
VoiceOver for macOS10.14.1Safari (macOS)12.0.110.14.12018-10-19

History

  • 2018-11-12 Test created