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

Test: aria-roledescription attribute with HTML button

Screen Reader support level: partial (9/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 button element</title>
</head>
<body>
    <p>Use the screen reader to announce the target element.</p>
    <button type="button" aria-roledescription="custom button">
        Target
    </button>
    <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 rolesupportedsupportedsupportedsupportednonesupportedsupported

* 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 Chromeyes
  • Result: (pass)
    • command: Down arrow (Read next item)
    • location before command: before target
    • location after command: target
    • Output: "target, custom button"
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • location before command: before target
    • location after command: target
    • Output: "target, custom button. To activate press space bar."
More information
JAWSInternet Exploreryes
  • Result: (pass)
    • command: Down arrow (Read next item)
    • location before command: before target
    • location after command: target
    • Output: "target, custom button."
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • location before command: before target
    • location after command: target
    • Output: "Target, custom button. To activate press space bar."
More information
JAWSFirefox (desktop)yes
  • Result: (pass)
    • command: Down arrow (Read next item)
    • location before command: before target
    • location after command: target
    • Output: "target, custom button."
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • location before command: before target
    • location after command: target
    • Output: "target, custom button. To activate press space bar."
More information
NarratorMicrosoft Edgeyes
  • Result: (pass)
    • command: Down arrow (Read next item (scan mode))
    • location before command: before target
    • location after command: target
    • Output: "custom button, target"
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • location before command: before target
    • location after command: target
    • Output: "Target. Custom button."
More information
NVDAGoogle Chromeyes
  • Result: (pass)
    • command: down arrow (Read next item)
    • location before command: before target
    • location after command: target
    • Output: "custom button, target"
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • location before command: before target
    • location after command: target
    • Output: "custom button, target"
More information
NVDAFirefox (desktop)yes
  • Result: (pass)
    • command: down arrow (Read next item)
    • location before command: before target
    • location after command: target
    • Output: "custom button, target"
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • location before command: before target
    • location after command: target
    • Output: "Target, custom button."
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 button"
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • location before command: before target
    • location after command: target
    • Output: "target, custom button"
More information
TalkBackGoogle Chrome (android)none
  • Result: (fail)
    • command: Swipe right (Read next item)
    • location before command: before target
    • location after command: target
    • Output: "target, button, double tap to activate"
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)yes
  • Result: (pass)
    • command: Swipe Right (Next item)
    • location before command: before target
    • location after command: target
    • Output: Target, custom button
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: "Target, custom button"
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • location before command: before target
    • location after command: target
    • Output: Target, custom button
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