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

Test: HTML button[type="button" disabled]

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 not be focusable, per the HTML5 spec.

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 a disabled attribute</title>
</head>
<body>
<p>Use the screen reader to announce the target element.</p>

<button id="target" disabled>target</button>
</body>
</html>

Dates and Versions of tested combinations

ATAT VersionBrowserBrowser versionOS versionDate tested
JAWS2019.1907.42Chrome7719032019-09-24
JAWS2018.1808.10IE11.13418092018-11-30
JAWS2018.1808.10Firefox6318092018-11-30
Narrator1809Edge44.1776318092018-11-30
NVDA2019.2Chrome7719032019-09-24
NVDA2018.3.2Firefox63.0.118092018-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)
disabled attribute
MUST convey the disabled statesupportedsupportedsupportedsupportedsupportedsupportedsupported

* 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
disabled attribute
MAY convey the disabled stateunknownunknownunknownunknownunknown

* means that some support is hidden behind settings

Detailed support results by expectation

Expectation for the disabled attribute: convey the disabled state

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 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 was not focused)
  • 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 was not focused)
  • 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 was not focused)
  • 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 was not focused)
  • 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 was not focused)
  • 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 was not focused)
  • 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: 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
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
Notes: Target is in tab order even with the disabled attribute.
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 was not focused)
  • 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, button, dimmed
More information
Windows Speech RecognitionChromeunknown-More information

Extended Support for: disabled attribute: convey the disabled state

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
  • 2019-07-27 Talkback results added
  • 2019-09-16 add orca results
  • 2019-09-24 add chrome results for Jaws and NVDA