Important: This website does not attempt to establish a standard for how assistive technologies must behave. Read the FAQ for more information. Additionally, this is a work in progress. Please submit feedback or suggestions.

disabled attribute (html)

Screen Reader support level: partial (30/33)

Voice Control support level: unknown

On this page

About this feature

The HTML disabled attribute lets authors disable form controls. Note, adding the disabled attribute to form controls will generally cause them to not be focusable.

Age of results

Results across all tests for this feature range from a year ago to 6 years ago. Detailed dates and version information can be found in associated tests.

Caution

Failing or partial results may be out of date. The oldest result is from 5 years ago. Consider running the associated tests and contributing results.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeEdgeFirefoxEdgeChromeEdgeFirefoxFirefoxChromeSafariSafari
MUST convey the disabled statesupportedsupportedsupportedpartial (1/3)supportedsupportedsupportedsupportedsupportedpartial (2/3)supported

Voice Control support by expectation

ExpectationDragon Naturally SpeakingVoice Access (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech RecognitionWindows Voice Access
ChromeChromeSafariSafariEdgeChromeEdgeChrome
MAY convey the disabled stateno known supportsupported with 1 unknown resultunknownsupported with 1 unknown resultunknownunknownunknownunknown

Expectation: convey the disabled state

Strength of this expectation for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: MAY

Examples:

  • 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
Voice Control support for 'MAY convey the disabled state'
TestDragon Naturally SpeakingVoice Access (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech RecognitionWindows Voice Access
ChromeChromeSafariSafariEdgeChromeEdgeChrome
HTML button[type="button" disabled] applied to: button elementunknownunknownunknownunknownunknownunknownunknownunknown
HTML select element test applied to: option elementnonesupportedunknownsupportedunknownunknownunknownunknown
HTML select element test applied to: optgroup elementnonesupportedunknownsupportedunknownunknownunknownunknown