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

button element (html)

Screen reader support level: supported

Voice Control support level: partial (26/27)

On this page

About this feature

The button element represents a button labeled by its contents.

Age of results

Results across all tests for this feature range from 2 months ago to 10 months ago. Detailed dates and version information can be found in associated tests.

Failing and partial results are between 2 months ago and 2 months ago.

Expectations

What are expectations?

Screen Reader support by expectation

ExpectationJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
MUST convey its namesupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported
MUST convey its rolesupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported
SHOULD provide shortcuts to jump to this rolesupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported

Voice Control support by expectation

ExpectationDragon Naturally SpeakingVoice Access (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech Recognition
ChromeChromeSafariSafariChrome
MUST convey its namesupportedsupportedsupportedpartial (2/3)supported
MUST convey its rolesupportedsupportednot applicablesupportedsupported

Expectation: convey its name

Rationale: A screen reader user needs to know what to enter.

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: MUST

Examples of assistive technologies support this expectation:

  • A screen reader might announce the button as something like "<name>, button".
  • Voice control software will let the user say something like "click <name>" to activate the control.
Screen Reader support for 'MUST convey its name'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
APG Actions Menu Button Example Using aria-activedescendantsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported
Disclosure widget (show/hide)supportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported
Basic HTML button testsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported
Voice Control support for 'MUST convey its name'
TestDragon Naturally SpeakingVoice Access (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech Recognition
ChromeChromeSafariSafariChrome
APG Actions Menu Button Example Using aria-activedescendantsupportedsupportedsupportednonesupported
Disclosure widget (show/hide)supportedsupportedsupportedsupportedsupported
Basic HTML button testsupportedsupportedsupportedsupportedsupported

Expectation: convey its role

Rationale: A screen reader user needs to know how they can interact with the element. Voice control software might use the role to help users activate controls that do not have a visible name.

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: MUST
  • Voice Control: MUST

Examples of assistive technologies support this expectation:

  • A screen reader might be announce the role as something like "button".
  • Voice control software will let the user say something like "click button".
Screen Reader support for 'MUST convey its role'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
APG Actions Menu Button Example Using aria-activedescendantsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported
Disclosure widget (show/hide)supportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported
Basic HTML button testsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported
Voice Control support for 'MUST convey its role'
TestDragon Naturally SpeakingVoice Access (Android)Voice Control (iOS)Voice Control (MacOS)Windows Speech Recognition
ChromeChromeSafariSafariChrome
APG Actions Menu Button Example Using aria-activedescendantsupportedsupportednot applicablesupportedsupported
Disclosure widget (show/hide)supportedsupportednot applicablesupportedsupported
Basic HTML button testsupportedsupportednot applicablesupportedsupported

Expectation: provide shortcuts to jump to this role

Rationale: Screen reader users might want to quickly navigate to elements of this type.

Strength of these expectations for different types of assistive technologies:

  • Screen Readers: SHOULD
  • Voice Control: NA
Screen Reader support for 'SHOULD provide shortcuts to jump to this role'
TestJAWSNarratorNVDAOrcaTalkBackVoiceOver (iOS)VoiceOver (macOS)
ChromeIEFirefoxEdgeChromeFirefoxFirefoxChromeSafariSafari
Basic HTML button testsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupportedsupported
TestLast update
APG Actions Menu Button Example Using aria-activedescendant2020-03-30
Disclosure widget (show/hide)2020-03-30
Basic HTML button test2019-10-18

Is something not right?

We use our GitHub repository to manage our issue tracking. Please provide as much information as you can for issues, and please leave the id in the issue title intact.

Create an issue for this feature