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.42Google Chrome7719032019-09-24
JAWS2018.1808.10Internet Explorer11.13418092018-11-30
JAWS2018.1808.10Firefox (desktop)6318092018-11-30
Narrator1809Microsoft Edge44.1776318092018-11-30
NVDA2019.2Google Chrome7719032019-09-24
NVDA2018.3.2Firefox (desktop)63.0.118092018-11-30
Orca3.31.4Firefox (desktop)69Ubuntu 19.042019-09-16
TalkBack7.3.0Google Chrome (android)757.02019-07-27
VoiceOver for iOS12.1Safari (iOS)12.112.12018-11-30
VoiceOver for macOS10.14.1Safari (macOS)12.0.110.14.12018-11-30

Summary of Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver for iOSVoiceOver for 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 for AndroidVoice Control for iOSVoice Control for MacOS
disabled attribute
MAY convey the disabled stateunknownunknownunknownunknown

* 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 SpeakingGoogle Chromeunknown-More information
JAWSGoogle Chromeyes
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • Output: (target was not focused)
  • Result: (pass)
    • command: Down arrow (Read next item)
    • Output: target button unavailable
More information
JAWSInternet Exploreryes
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • Output: (target was not focused)
  • Result: (pass)
    • command: Down arrow (Read next item)
    • Output: target button unavailable
More information
JAWSFirefox (desktop)yes
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • Output: (target was not focused)
  • Result: (pass)
    • command: Down arrow (Read next item)
    • Output: target button unavailable
More information
NarratorMicrosoft Edgeyes
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • Output: (target was not focused)
  • Result: (pass)
    • command: Down arrow (Read next item (scan mode))
    • Output: button, disabled, target
More information
NVDAGoogle Chromeyes
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • Output: (target was not focused)
  • Result: (pass)
    • command: down arrow (Read next item)
    • Output: button, unavailable, target
More information
NVDAFirefox (desktop)yes
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • Output: (target was not focused)
  • Result: (pass)
    • command: down arrow (Read next item)
    • Output: button, unavailable, target
More information
OrcaFirefox (desktop)yes
  • Result: (pass)
    • command: down arrow (Read next item)
    • Output: "target, push button, grayed"
More information
TalkBackGoogle Chrome (android)yes
  • Result: (pass)
    • command: Swipe right (Read next item)
    • Output: target, button, disabled
More information
Voice Access for AndroidGoogle Chrome (android)unknown-More information
Voice Control for iOSSafari (iOS)unknown-More information
Voice Control for MacOSSafari (macOS)unknown-More information
VoiceOver for iOSSafari (iOS)yes
  • Result: (pass)
    • command: Swipe down (Next item (as set by the rotor))
    • Output: target, dimmed, button
  • Result: (pass)
    • command: Swipe Right (Next item)
    • Output: target, dimmed, button
Notes: Target is in tab order even with the disabled attribute.
More information
VoiceOver for macOSSafari (macOS)yes
  • Result: (pass)
    • command: Tab (Read next focusable item)
    • Output: (target was not focused)
  • Result: (pass)
    • command: VO + Right arrow (Read next item)
    • Output: target, button, dimmed
More information

Extended Support for: disabled attribute: convey the disabled state

These are less common combinations

ATBrowserHas SupportOutputAction
Dragon Naturally SpeakingInternet Explorerunknown-More information
Dragon Naturally SpeakingFirefox (desktop)unknown-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)unknown-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 Chromeunknown-More information
Voice Control for MacOSFirefox (desktop)unknown-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