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.42Chrome7619032019-09-09
JAWS2019.1907.42IE1119032019-09-09
JAWS2019.1907.42Firefox6919032019-09-09
Narrator1903Edge4419032019-09-09
NVDA2019.2Chrome7619032019-09-09
NVDA2019.2Firefox7619032019-09-09
Orca3.31.4Firefox69Ubuntu 19.042019-09-09
TalkBack7.3.0Chrome7672019-09-09
VoiceOver (iOS)12.4.1Safari12.4.112.4.12019-09-09
VoiceOver (macOS)10.14.6Safari12.1.210.14.62019-09-09

Summary of Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (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 (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech Recognition
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 SpeakingChromenot applicable-More information
JAWSChromeyes
  • 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
JAWSIEyes
  • 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
JAWSFirefoxyes
  • 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
NarratorEdgeyes
  • 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
NVDAChromeyes
  • 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
NVDAFirefoxyes
  • 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
OrcaFirefoxyes
  • 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
TalkBackChromenone
  • 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 (Android)Chromenot applicable-More information
Voice Control (iOS)Safarinot applicable-More information
Voice Control (MacOS)Safarinot applicable-More information
VoiceOver (iOS)Safariyes
  • Result: (pass)
    • command: Swipe Right (Next item)
    • location before command: before target
    • location after command: target
    • Output: Target, custom button
More information
VoiceOver (macOS)Safariyes
  • 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
Windows Speech RecognitionChromenot applicable-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 SpeakingIEnot applicable-More information
Dragon Naturally SpeakingFirefoxnot applicable-More information
JAWSEdgeunknown-More information
NarratorFirefoxunknown-More information
NarratorChromeunknown-More information
NarratorIEunknown-More information
NVDAIEunknown-More information
NVDAEdgeunknown-More information
TalkBackFirefoxunknown-More information
Voice Access (Android)Firefoxnot applicable-More information
VoiceOver (iOS)Chromeunknown-More information
VoiceOver (macOS)Chromeunknown-More information
VoiceOver (macOS)Firefoxunknown-More information
OrcaChromeunknown-More information
Voice Control (MacOS)Chromenot applicable-More information
Voice Control (MacOS)Firefoxnot applicable-More information
Windows Speech RecognitionEdgenot 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