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

Test: aria-roledescription attribute with HTML section

Screen Reader support level: partial (5/10)

Voice Control support level: not applicable

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
<!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>
    <p>Content after target</p>
</body>
</html>

Dates and Versions of tested combinations

ATAT VersionBrowserBrowser versionOS versionDate tested
JAWS2019.1907.42Google Chrome7619032019-09-09
JAWS2019.1907.42Internet Explorer1119032019-09-09
JAWS2019.1907.42Firefox (desktop)6919032019-09-09
Narrator1903Microsoft Edge4419032019-09-09
NVDA2019.2Google Chrome7619032019-09-09
NVDA2019.2Firefox (desktop)7619032019-09-09
Orca3.31.4Firefox (desktop)69Ubuntu 19.042019-09-09
TalkBack7.3.0Google Chrome (android)7672019-09-09
VoiceOver for iOS12.4.1Safari (iOS)12.4.112.4.12019-09-09
VoiceOver for macOS10.14.6Safari (macOS)12.1.210.14.62019-09-09

Summary of Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver for iOSVoiceOver for macOS
aria-roledescription attribute
MUST convey the value of the roledescription attribute as the rolenonesupportedsupportedsupportednonenonesupported

* means that some support is hidden behind settings

Summary of Voice Control support by expectation

ExpectationDragon Naturally SpeakingVoice Access for AndroidVoice Control for iOSVoice Control for MacOS
Not applicable

* means that some support is hidden behind settings

Detailed support results by expectation

Expectation for the aria-roledescription attribute: 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

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 Chromenone
  • Result: (fail)
    • command: Down arrow (Read next item)
    • location before command: before target
    • location after command: target
    • Output: "target"
    • Notes: no information about the section was conveyed
  • Result: (fail)
    • command: Insert + F3 (Open element list)
    • Output: "section name, region"
    • Notes: in list of regions, but role was not changed.
More information
JAWSInternet Explorernone
  • Result: (fail)
    • command: Down arrow (Read next item)
    • location before command: before target
    • location after command: target
    • Output: "target"
    • Notes: no information about the section was conveyed
  • Result: (fail)
    • command: Insert + F3 (Open element list)
    • Output: "no regions were found on the page"
More information
JAWSFirefox (desktop)none
  • Result: (fail)
    • command: Down arrow (Read next item)
    • location before command: before target
    • location after command: target
    • Output: "target"
    • Notes: no information about the section was conveyed
  • Result: (fail)
    • command: Insert + F3 (Open element list)
    • Output: "section name, region"
    • Notes: in list of regions, but role was not changed.
More information
NarratorMicrosoft Edgeyes
  • Result: (fail)
    • command: Down arrow (Read next item (scan mode))
    • location before command: before target
    • location after command: target
    • Output: "Target"
  • Result: (pass)
    • command: d (next landmarkd)
    • location before command: before target
    • location after command: target
    • Output: "section name, custom section role, region landmark"
More information
NVDAGoogle Chromeyes
  • Result: (pass)
    • command: down arrow (Read next item)
    • location before command: before target
    • location after command: target
    • Output: "section name, custom section role, target."
More information
NVDAFirefox (desktop)yes
  • Result: (pass)
    • command: down arrow (Read next item)
    • location before command: before target
    • location after command: target
    • Output: "Section name, custom section role, target."
More information
OrcaFirefox (desktop)yes
  • Result: (pass)
    • command: down arrow (Read next item)
    • location before command: before target
    • location after command: target
    • Output: "target, custom section role"
More information
TalkBackGoogle Chrome (android)none
  • Result: (fail)
    • command: Swipe right (Read next item)
    • location before command: before target
    • location after command: target
    • Output: "section name, region"
    • Notes: Contents of the section could not be announced.
  • Result: (fail)
    • command: LCM, landmarks, swipe right (Next landmark)
    • location before command: before target
    • location after command: target
    • Output: "section name, region"
    • Notes: Contents of the section could not be announced.
More information
Voice Access for AndroidGoogle Chrome (android)not applicable-More information
Voice Control for iOSSafari (iOS)not applicable-More information
Voice Control for MacOSSafari (macOS)not applicable-More information
VoiceOver for iOSSafari (iOS)none
  • Result: (fail)
    • command: Swipe Right (Next item)
    • location before command: before target
    • location after command: target
    • Output: "Target, section name, landmark"
More information
VoiceOver for macOSSafari (macOS)yes
  • Result: (pass)
    • command: VO + Right arrow (Read next item)
    • location before command: before target
    • location after command: target
    • Output: "Section name, custom section role"
More information

Extended Support for: aria-roledescription attribute: 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
JAWSMicrosoft Edgeunknown-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
Voice Access for AndroidFirefox (Android)not applicable-More information
VoiceOver for iOSGoogle Chrome (ios)unknown-More information
VoiceOver for macOSGoogle Chromeunknown-More information
VoiceOver for macOSFirefox (desktop)unknown-More information
OrcaGoogle Chromeunknown-More information
Voice Control for MacOSGoogle Chromenot applicable-More information
Voice Control for MacOSFirefox (desktop)not applicable-More information
Back to top

History

  • 2018-11-12 Test created
  • 2019-09-09 Updated support info and added data for talkback and orca