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

disabled attribute (html)

Screen reader support level: partial (28/30)

Voice Control support level: not applicable

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 9 months ago to 2 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 a year ago. Consider running the associated tests and contributing results.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
MUST convey the disabled statesupportedsupportedsupportedsupportedsupportedsupportedsupportedpartial (1/3)supportedsupported

Voice Control support by expectation

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

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 Recognition
ChromeChromeSafariSafariChrome
HTML button[type="button" disabled] applied to: button elementunknownunknownunknownunknownunknown
HTML select element test applied to: optgroup elementnonesupportedunknownsupportedunknown
HTML select element test applied to: option elementnonesupportedunknownsupportedunknown