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

Test: HTML button[type="button" aria-disabled="true"]

Screen Reader support level: supported

Voice Control support level: not applicable

This test ensures that the disabled state is communicated to screen readers. The button should be focusable.

Run this test and and submit your results

On this page

Test HTML

open the test page
<!DOCTYPE html>
<html lang="en">
<head>
    <title>HTML button[type="button"] element with an aria-disabled="true" attribute</title>
</head>
<body>
<p>Use the screen reader to announce the target element.</p>

<button id="target" aria-disabled="true">target</button>
</body>
</html>

Dates and Versions of tested combinations

ATAT VersionBrowserBrowser versionOS versionDate tested
JAWS2019.1909.28Chrome7719032019-09-27
JAWS2018.1808.10IE11.13418092018-11-30
JAWS2018.1808.10Firefox63.0.118092018-11-30
Narrator1809Edge44.1776318092018-11-30
NVDA2019.2Chrome7719032019-09-27
NVDA2018.3.2Firefox6318092018-11-30
Orca3.31.4Firefox69Ubuntu 19.042019-09-16
TalkBack8.1Chrome787.02020-01-13
VoiceOver (iOS)12.1Safari12.112.12018-11-30
VoiceOver (macOS)10.14.1Safari12.0.110.14.12018-11-30

Summary of Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
aria-disabled attribute
MUST convey the "true" valuesupportedsupportedsupportedsupportedsupportedsupportedsupported

* 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
aria-disabled attribute
MAY convey the "true" valueunknownunknownunknownunknownunknown

* means that some support is hidden behind settings

Detailed support results by expectation

Expectation for the aria-disabled attribute: convey the "true" value

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: MAY

Examples of assistive technologies support this expectation:

  • Screen readers might convey the disabled state by announcing "disabled", "unavailable", or "dimmed"
  • Screen readers might convey the disabled state of certain embedded controls, such as the option element, by skipping it when navigating embedded controls
  • Voice control software might not include the element in operations, for example it might not flag the element with a number or respond to name commands

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

This expectation is from the aria-disabled attribute feature.

ATBrowserHas SupportOutputAction
Dragon Naturally SpeakingChromeunknown-More information
JAWSChromeyes
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: target button unavailable
  • Result: (pass)
    • command: Down arrow (Read next item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: target button unavailable
More information
JAWSIEyes
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: target button unavailable
  • Result: (pass)
    • command: Down arrow (Read next item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: target button unavailable
More information
JAWSFirefoxyes
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: target button unavailable
  • Result: (pass)
    • command: Down arrow (Read next item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: target button unavailable
More information
NarratorEdgeyes
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: target, button, disabled
  • Result: (pass)
    • command: Down arrow (Read next item (scan mode))
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: button, disabled, target
More information
NVDAChromeyes
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: Target, button, unavailable
  • Result: (pass)
    • command: down arrow (Read next item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: button, unavailable, target
More information
NVDAFirefoxyes
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: Target, button, unavailable
  • Result: (pass)
    • command: down arrow (Read next item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: button, unavailable, target
More information
OrcaFirefoxyes
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: "target, push button, grayed"
  • Result: (pass)
    • command: down arrow (Read next item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: "target, push button, grayed"
More information
TalkBackChromeyes
  • Result: (pass)
    • command: Swipe right (Read next item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: "target, button, disabled"
Notes: did not announce "double tap to activate"
More information
Voice Access (Android)Chromeunknown-More information
Voice Control (iOS)Safariunknown-More information
Voice Control (MacOS)Safariunknown-More information
VoiceOver (iOS)Safariyes
  • Result: (pass)
    • command: Swipe down (Next item (as set by the rotor))
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: target, dimmed, button
  • Result: (pass)
    • command: Swipe Right (Next item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: target, dimmed, button
More information
VoiceOver (macOS)Safariyes
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: target, dimmed, button
  • Result: (pass)
    • command: VO + Right arrow (Read next item)
    • before the command was executed
      • mode: auto (mode not explicitly)
      • keyboard focus location: before target
      • virtual cursor location: before target
    • location after command: target
    • Output: target, dimmed, button
More information
Windows Speech RecognitionChromeunknown-More information

Extended Support for: aria-disabled attribute: convey the "true" value

These are less common combinations

ATBrowserHas SupportOutputAction
Dragon Naturally SpeakingIEunknown-More information
Dragon Naturally SpeakingFirefoxunknown-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)Firefoxunknown-More information
VoiceOver (iOS)Chromeunknown-More information
VoiceOver (macOS)Chromeunknown-More information
VoiceOver (macOS)Firefoxunknown-More information
OrcaChromeunknown-More information
Voice Control (MacOS)Chromeunknown-More information
Voice Control (MacOS)Firefoxunknown-More information
Windows Speech RecognitionEdgeunknown-More information
Back to top

History

  • 2018-11-08 Test created
  • 2018-11-30 support updated
  • 2019-07-27 Talkback results added
  • 2019-09-16 add orca results
  • 2019-09-27 add missing chrome results
  • 2020-01-13 update talkback results