button element (html)
Screen reader support level: supported with 1 unknown result
Voice Control support level: partial (26/28)
On this page
- About this feature
- Age of results
- Expectations
- Related tests
- Related AT or browser issues
- Is something not right?
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 4 months ago to 2 years ago. Detailed dates and version information can be found in associated tests.
Failing and partial results are between a year ago and a year ago.
Expectations
Screen Reader support by expectation
Expectation | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | |||
---|---|---|---|---|---|---|---|---|---|---|
Chrome | IE | Firefox | Edge | Chrome | Firefox | Firefox | Chrome | Safari | Safari | |
MUST convey its name | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
MUST convey its role | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
SHOULD provide shortcuts to jump to this role | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
MAY convey inner-text name changes when in focus | none | supported | none | supported | none | none | none | none | supported | partial |
Voice Control support by expectation
Expectation | Dragon Naturally Speaking | Voice Access (Android) | Voice Control (iOS) | Voice Control (MacOS) | Windows Speech Recognition |
---|---|---|---|---|---|
Chrome | Chrome | Safari | Safari | Chrome | |
MUST convey its name | supported | supported | supported | partial (2/3) | supported |
MUST convey its role | supported | supported | not applicable | supported | supported |
Expectation: convey its name
Rationale:
A screen reader user needs to know what to enter.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: MUST
Examples:
- 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.
Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | |||
---|---|---|---|---|---|---|---|---|---|---|
Chrome | IE | Firefox | Edge | Chrome | Firefox | Firefox | Chrome | Safari | Safari | |
DRAFT ARIA 1.2 Editable Combobox With List Autocomplete Example | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
APG Actions Menu Button Example Using aria-activedescendant | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
Disclosure widget (show/hide) | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
Basic HTML button test | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
Test | Dragon Naturally Speaking | Voice Access (Android) | Voice Control (iOS) | Voice Control (MacOS) | Windows Speech Recognition |
---|---|---|---|---|---|
Chrome | Chrome | Safari | Safari | Chrome | |
DRAFT ARIA 1.2 Editable Combobox With List Autocomplete Example | unknown | unknown | unknown | unknown | unknown |
APG Actions Menu Button Example Using aria-activedescendant | supported | supported | supported | none | supported |
Disclosure widget (show/hide) | supported | supported | supported | supported | supported |
Basic HTML button test | supported | supported | supported | supported | supported |
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 this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: MUST
Examples:
- A screen reader might be announce the role as something like "button".
- Voice control software will let the user say something like "click button".
Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | |||
---|---|---|---|---|---|---|---|---|---|---|
Chrome | IE | Firefox | Edge | Chrome | Firefox | Firefox | Chrome | Safari | Safari | |
DRAFT ARIA 1.2 Editable Combobox With List Autocomplete Example | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
APG Actions Menu Button Example Using aria-activedescendant | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
Disclosure widget (show/hide) | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
Basic HTML button test | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
Test | Dragon Naturally Speaking | Voice Access (Android) | Voice Control (iOS) | Voice Control (MacOS) | Windows Speech Recognition |
---|---|---|---|---|---|
Chrome | Chrome | Safari | Safari | Chrome | |
DRAFT ARIA 1.2 Editable Combobox With List Autocomplete Example | unknown | unknown | not applicable | unknown | unknown |
APG Actions Menu Button Example Using aria-activedescendant | supported | supported | not applicable | supported | supported |
Disclosure widget (show/hide) | supported | supported | not applicable | supported | supported |
Basic HTML button test | supported | supported | not applicable | supported | supported |
Expectation: provide shortcuts to jump to this role
Rationale:
Screen reader users might want to quickly navigate to elements of this type.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: SHOULD
- Voice Control: NA
Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | |||
---|---|---|---|---|---|---|---|---|---|---|
Chrome | IE | Firefox | Edge | Chrome | Firefox | Firefox | Chrome | Safari | Safari | |
Basic HTML button test | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
Expectation: convey inner-text name changes when in focus
Rationale:
The user needs to know that that the name of a control has changed after interacting with it. This may be to convey a new purpose or to convey a state change which is provided by the name.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MAY
- Voice Control: NA
Notes:
This expectation is only for when the button is focused by a screen reader (either keyboard focus or virtual focus). It is not meant to act like a live region.