| CARVIEW |
Select Language
HTTP/2 200
date: Fri, 10 Oct 2025 19:44:09 GMT
content-type: text/html; charset=utf-8
report-to: {"group":"cf-nel","max_age":604800,"endpoints":[{"url":"https://a.nel.cloudflare.com/report/v4?s=eOqbxV028ULD5Y20goIyMjrKl5oHhAuvI%2FCjvxWJzO8z2dn3FDLv6ys08foShCFdbhjzP%2BsG6I4YxzVVR0DRLUoD%2BOnjcM7or0rmFKB5"}]}
x-powered-by: Express
cf-cache-status: DYNAMIC
nel: {"report_to":"cf-nel","success_fraction":0.0,"max_age":604800}
content-encoding: gzip
server: cloudflare
cf-ray: 98c89c503bc0ff6a-BOM
alt-svc: h3=":443"; ma=86400
button_role (aria) | Accessibility Support Skip to main content
Will your code work with assistive technologies?
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.
button role (aria)
Screen Reader support level: supported
Voice Control support level: supported with 8 unknown results
On this page
About this feature
An input that allows for user-triggered actions when clicked or pressed. See related link.
Age of results
Results across all tests for this feature range from 10 months ago to 7 years ago. Detailed dates and version information can be found in associated tests.
Expectations
Screen Reader support by expectation
| Expectation | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| MUST convey its name | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
| MUST convey its role | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
Voice Control support by expectation
| Expectation | Dragon Naturally Speaking | Voice Access (Android) | Voice Control (iOS) | Voice Control (MacOS) | Windows Speech Recognition | Windows Voice Access | ||
|---|---|---|---|---|---|---|---|---|
| Chrome | Chrome | Safari | Safari | Edge | Chrome | Edge | Chrome | |
| MUST convey its name | supported | supported | supported | supported | supported | supported | unknown | unknown |
| MUST convey its role | supported | supported | not applicable | supported | supported | supported | unknown | unknown |
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
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| ARIA button name from inner text | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
| ARIA button name from aria-label | supported | 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 | Windows Voice Access | ||
|---|---|---|---|---|---|---|---|---|
| Chrome | Chrome | Safari | Safari | Edge | Chrome | Edge | Chrome | |
| ARIA button name from inner text | supported | supported | supported | supported | supported | supported | unknown | unknown |
| ARIA button name from aria-label | supported | supported | supported | supported | supported | supported | unknown | unknown |
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 announce an element as something like "<name>, <role>"
- A screen reader might imply the role by the presence of certain context roles
- Voice Control software might let the user say something like "click, <role>".
- Voice Control software might let the user say something like "show numbers", and interactive roles will be flagged with numbers.
| Test | JAWS | Narrator | NVDA | Orca | TalkBack | VoiceOver (iOS) | VoiceOver (macOS) | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Edge | Chrome | Edge | Firefox | Firefox | Chrome | Safari | Safari | |
| ARIA button name from inner text | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported | supported |
| ARIA button name from aria-label | supported | 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 | Windows Voice Access | ||
|---|---|---|---|---|---|---|---|---|
| Chrome | Chrome | Safari | Safari | Edge | Chrome | Edge | Chrome | |
| ARIA button name from inner text | supported | supported | not applicable | supported | supported | supported | unknown | unknown |
| ARIA button name from aria-label | supported | supported | not applicable | supported | supported | supported | unknown | unknown |
Tests
| Test | Last update |
|---|---|
| ARIA button name from inner text | 2024-12-08 |
| ARIA button name from aria-label | 2024-12-08 |
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