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

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

Current support: partial (6/9)

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 in a new tab
<!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>

Support tables

Assertions are conditions that must be met for the feature to be considered as "supported". Only "MUST" assertions need to be met for minimal "support". "SHOULD" and "MAY" assertions indicates support that goes above and beyond. Note that there is not an explicit standard that dictates these assertions, and as such, they are likely opinionated. Minimal support reflects that the structure, relationships, and functionality of the feature are conveyed and operable by assistive technology rather than minimal conformance to any specific WCAG SC. As such, a feature might not meet all "MUST" assertions but still be usable (potentially frustratingly so).

Assertion support summary by type of assertion
MUSTSHOULDMAY
partial (6/9)nana

Assertion support summary by assertion

FeatureAssertionSupportHas failing tests
disabled attributeThe screen reader MUST convey the disabled statepartial (6/9)No

disabled attribute: The screen reader MUST convey the disabled state

This assertion is from the disabled attribute feature.

ATBrowserHas SupportOutputAction
Dragon Naturally SpeakingInternet Explorernot applicable-More information
JAWSGoogle Chromeunknown-More information
JAWS 2018.1808.10Internet Explorer 11.134yes
  • Result: (pass)
    • command: Tab
    • Output: (target was not focused)
  • Result: (pass)
    • command: Down arrow
    • Output: target button unavailable
More information
JAWS 2018.1808.10Firefox (desktop) 63yes
  • Result: (pass)
    • command: Tab
    • Output: (target was not focused)
  • Result: (pass)
    • command: Down arrow
    • Output: target button unavailable
More information
Narrator 1809Microsoft Edge 44.17763yes
  • Result: (pass)
    • command: Tab
    • Output: (target was not focused)
  • Result: (pass)
    • command: Down arrow
    • Output: button, disabled, target
More information
NVDAGoogle Chromeunknown-More information
NVDA 2018.3.2Firefox (desktop) 63.0.1yes
  • Result: (pass)
    • command: Tab
    • Output: (target was not focused)
  • Result: (pass)
    • command: down arrow
    • Output: button, unavailable, target
More information
TalkBackGoogle Chrome (android)unknown-More information
VoiceOver for iOS 12.1Safari (iOS) 12.1yes
  • Result: (pass)
    • command: Swipe down
    • Output: target, dimmed, button
  • Result: (pass)
    • command: Swipe Right
    • Output: target, dimmed, button
Notes: Target is in tab order even with the disabled attribute.
More information
VoiceOver for macOS 10.14.1Safari (macOS) 12.0.1yes
  • Result: (pass)
    • command: Tab
    • Output: (target was not focused)
  • Result: (pass)
    • command: VO + Right arrow
    • Output: target, button, dimmed
More information

Extended Support for: disabled attribute: The screen reader MUST convey the disabled state

These are less common combinations

ATBrowserHas SupportOutputAction
Dragon Naturally SpeakingFirefox (desktop)not applicable-More information
Dragon Naturally SpeakingGoogle Chromenot 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 (desktop)unknown-More information
VoiceOver for iOSGoogle Chrome (ios)unknown-More information
VoiceOver for macOSGoogle Chromeunknown-More information
VoiceOver for macOSFirefox (desktop)unknown-More information

History

  • 2018-11-08 Test created