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.

Test: ARIA button name from aria-label

Screen Reader support level: supported

Voice Control support level: supported with 4 unknown results

About this test

This test ensures that the accessible name is derived from the aria-label attribute.

Submit new test results

Age of results

Results in this test range from 3 years ago to 5 years ago. See detailed information about test dates and versions for more information.

Test HTML

Open the test case HTML file

<!DOCTYPE html>
<html lang="en">
<head>
    <title>ARIA button examples</title>
    <style>
        *[role="button"] {
            padding: .5em;
            border: 1px solid #000;
            display: inline-block;
        }
    </style>
</head>
<body>
<h1>ARIA Button Examples</h1>
<p>This page contains various ARIA button examples</p>

<h2>Target 0: inner text</h2>
<p>button name should be "target 0"</p>
<div role="button" id="target-0" onclick="alert('target 0 clicked')" tabindex="0">target 0</div>

<h2>Target 1: aria-label</h2>
<p>button name should be "target 1"</p>
<div role="button" id="target-1" onclick="alert('target 1 clicked')" tabindex="0" aria-label="target 1">sample text</div>
</body>
</html>

Summary of Screen Reader support by expectation

button role
Expectation	JAWS			Narrator	NVDA			Orca	TalkBack	VoiceOver (iOS)	VoiceOver (macOS)
Expectation	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

* means that some support is hidden behind settings

Summary of Voice Control support by expectation

button role
Expectation	Dragon Naturally Speaking	Voice Access (Android)	Voice Control (iOS)	Voice Control (MacOS)	Windows Speech Recognition		Windows Voice Access
Expectation	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

* means that some support is hidden behind settings

Detailed support results by expectation

Expectation for the button role: convey its name

This expectation is from the button role feature.

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

Grading method:

Just one of the listed commands must pass for the expectation to pass.

AT	Browser	Has Support	Output
Dragon Naturally Speaking	Chrome	yes	Result: (pass) Test Case: Use "Click <text>" (Activate item by name) Launch Dragon Naturally Speaking and Chrome. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Issue the command: `"Click <text>"` (Activate item by name) Record results for the relevant expectations Output:* (target was clicked)
JAWS	Chrome	yes	Result: (pass) Test Case: Use Down arrow (Read next item) to navigate forward to `[role="button"]` Launch JAWS and Chrome. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Down arrow` (Read next item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button" Result: (pass) Test Case: Use Tab (Read next focusable item) to navigate forward to `[role="button"]` Launch JAWS and Chrome. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Tab` (Read next focusable item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button, to activate press enter"
JAWS	Edge	yes	Result: (pass) Test Case: Use Down arrow (Read next item) to navigate forward to `[role="button"]` Launch JAWS and Edge. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Down arrow` (Read next item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button" Result: (pass) Test Case: Use Tab (Read next focusable item) to navigate forward to `[role="button"]` Launch JAWS and Edge. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Tab` (Read next focusable item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button, to activate press enter"
JAWS	Firefox	yes	Result: (pass) Test Case: Use Down arrow (Read next item) to navigate forward to `[role="button"]` Launch JAWS and Firefox. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Down arrow` (Read next item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button" Result: (pass) Test Case: Use Tab (Read next focusable item) to navigate forward to `[role="button"]` Launch JAWS and Firefox. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Tab` (Read next focusable item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button, to activate press space bar"
Narrator	Edge	yes	Result: (pass) Test Case: Use Down arrow (Jump to next item (scan mode)) to navigate forward to `[role="button"]` Launch Narrator and Edge. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Down arrow` (Jump to next item (scan mode)) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "button, target 1" Result: (pass) Test Case: Use Tab (Read next focusable item) to navigate forward to `[role="button"]` Launch Narrator and Edge. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Tab` (Read next focusable item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button"
NVDA	Chrome	yes	Result: (pass) Test Case: Use down arrow (Read next item) to navigate forward to `[role="button"]` Launch NVDA and Chrome. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `down arrow` (Read next item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "button, target 1" Result: (pass) Test Case: Use Tab (Read next focusable item) to navigate forward to `[role="button"]` Launch NVDA and Chrome. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Tab` (Read next focusable item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button"
NVDA	Edge	yes	Result: (pass) Test Case: Use down arrow (Read next item) to navigate forward to `[role="button"]` Launch NVDA and Edge. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `down arrow` (Read next item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "button, target 1" Result: (pass) Test Case: Use Tab (Read next focusable item) to navigate forward to `[role="button"]` Launch NVDA and Edge. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Tab` (Read next focusable item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button"
NVDA	Firefox	yes	Result: (pass) Test Case: Use down arrow (Read next item) to navigate forward to `[role="button"]` Launch NVDA and Firefox. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `down arrow` (Read next item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "button, target 1" Result: (pass) Test Case: Use Tab (Read next focusable item) to navigate forward to `[role="button"]` Launch NVDA and Firefox. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Tab` (Read next focusable item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button"
Orca	Firefox	yes	Result: (pass) Test Case: Use down arrow (Read next item) to navigate forward to `[role="button"]` Launch Orca and Firefox. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `down arrow` (Read next item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, push button" Result: (pass) Test Case: Use Tab (Read next focusable item) to navigate forward to `[role="button"]` Launch Orca and Firefox. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Tab` (Read next focusable item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, push button"
TalkBack	Chrome	yes	Result: (pass) Test Case: Use Swipe right (or alt+right arrow) (Read next item) to navigate forward to `[role="button"]` Launch TalkBack and Chrome. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Swipe right (or alt+right arrow)` (Read next item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button, double tap to activate"
Voice Access (Android)	Chrome	yes	Result: (pass) Test Case: Use "Tap <text>" or just "<text>" (Activate item by name) Launch Voice Access (Android) and Chrome. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Issue the command: `"Tap <text>" or just "<text>"` (Activate item by name) Record results for the relevant expectations Output:* button was activated Command Notes: said "tap target 1"
Voice Control (iOS)	Safari	yes	Result: (pass) Test Case: Use "Tap <text>" (Activate item by name) Launch Voice Control (iOS) and Safari. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Issue the command: `"Tap <text>"` (Activate item by name) Record results for the relevant expectations Output:* button was tapped Command Notes: said "tap target 1"
Voice Control (MacOS)	Safari	yes	Result: (pass) Test Case: Use "Click <text>" (Activate item by name) Launch Voice Control (MacOS) and Safari. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Issue the command: `"Click <text>"` (Activate item by name) Record results for the relevant expectations Output:* button was clicked Command Notes: said "click target one"
VoiceOver (iOS)	Safari	yes	Result: (pass) Test Case: Use Swipe Right (Next item) to navigate forward to `[role="button"]` Launch VoiceOver (iOS) and Safari. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Swipe Right` (Next item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button"
VoiceOver (macOS)	Safari	yes	Result: (pass) Test Case: Use VO + Right arrow (Read next item) to navigate forward to `[role="button"]` Launch VoiceOver (macOS) and Safari. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `VO + Right arrow` (Read next item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button" Result: (pass) Test Case: Use Tab (Read next focusable item) to navigate forward to `[role="button"]` Launch VoiceOver (macOS) and Safari. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Tab` (Read next focusable item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button"
Windows Speech Recognition	Edge	yes	Result: (pass) Test Case: Use "Click <text>" (Activate item by name) Launch Windows Speech Recognition and Edge. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Issue the command: `"Click <text>"` (Activate item by name) Record results for the relevant expectations Output:* role was activated Command Notes: said "click target 1"
Windows Speech Recognition	Chrome	yes	Result: (pass) Test Case: Use "Click <text>" (Activate item by name) Launch Windows Speech Recognition and Chrome. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Issue the command: `"Click <text>"` (Activate item by name) Record results for the relevant expectations Output:* role was activated Command Notes: said "click target 1"
Windows Voice Access	Edge	unknown	-
Windows Voice Access	Chrome	unknown	-
Windows Keyboard	Chrome	not applicable	-
Windows Keyboard	Firefox	not applicable	-
Windows Keyboard	Edge	not applicable	-
Mac Keyboard	Chrome	not applicable	-
Mac Keyboard	Safari	not applicable	-
iOS Keyboard	Safari	not applicable	-
Android Keyboard	Chrome	not applicable	-

Extended Support for: button role: convey its name

These are less common combinations

AT	Browser	Has Support	Output
Dragon Naturally Speaking 15.30	IE 11.253	yes	Result: (pass) Test Case: Use "Click <text>" (Activate item by name) Launch Dragon Naturally Speaking and IE. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Issue the command: `"Click <text>"` (Activate item by name) Record results for the relevant expectations Output:* (target was clicked)
Dragon Naturally Speaking	Firefox	unknown	-
JAWS 2019.1907.42	IE 11	yes	Result: (pass) Test Case: Use Down arrow (Read next item) to navigate forward to `[role="button"]` Launch JAWS and IE. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Down arrow` (Read next item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button" Result: (pass) Test Case: Use Tab (Read next focusable item) to navigate forward to `[role="button"]` Launch JAWS and IE. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Tab` (Read next focusable item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button, to activate press space bar"
Narrator	Firefox	unknown	-
Narrator	Chrome	unknown	-
Narrator	IE	unknown	-
NVDA	IE	unknown	-
TalkBack	Firefox	unknown	-
Voice Access (Android)	Firefox	unknown	-
VoiceOver (iOS)	Chrome	unknown	-
VoiceOver (macOS)	Chrome	unknown	-
VoiceOver (macOS)	Firefox	unknown	-
Orca	Chrome	unknown	-
Voice Control (MacOS)	Chrome	unknown	-
Voice Control (MacOS)	Firefox	unknown	-
Mac Keyboard	Firefox	not applicable	-
Android Keyboard	Firefox	not applicable	-

Expectation for the button role: convey its role

This expectation is from the button role feature.

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.

Grading method:

Just one of the listed commands must pass for the expectation to pass.

AT	Browser	Has Support	Output
Dragon Naturally Speaking	Chrome	yes	Result: (pass) Test Case: Use Click <role> (Click Type) Launch Dragon Naturally Speaking and Chrome. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Issue the command: `Click <role>` (Click Type) Record results for the relevant expectations Output:* (all elements of type were flagged)
JAWS	Chrome	yes	Result: (pass) Test Case: Use Down arrow (Read next item) to navigate forward to `[role="button"]` Launch JAWS and Chrome. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Down arrow` (Read next item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button" Result: (pass) Test Case: Use Tab (Read next focusable item) to navigate forward to `[role="button"]` Launch JAWS and Chrome. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Tab` (Read next focusable item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button, to activate press enter"
JAWS	Edge	yes	Result: (pass) Test Case: Use Down arrow (Read next item) to navigate forward to `[role="button"]` Launch JAWS and Edge. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Down arrow` (Read next item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button" Result: (pass) Test Case: Use Tab (Read next focusable item) to navigate forward to `[role="button"]` Launch JAWS and Edge. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Tab` (Read next focusable item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button, to activate press enter"
JAWS	Firefox	yes	Result: (pass) Test Case: Use Down arrow (Read next item) to navigate forward to `[role="button"]` Launch JAWS and Firefox. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Down arrow` (Read next item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button" Result: (pass) Test Case: Use Tab (Read next focusable item) to navigate forward to `[role="button"]` Launch JAWS and Firefox. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Tab` (Read next focusable item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button, to activate press space bar"
Narrator	Edge	yes	Result: (pass) Test Case: Use Down arrow (Jump to next item (scan mode)) to navigate forward to `[role="button"]` Launch Narrator and Edge. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Down arrow` (Jump to next item (scan mode)) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "button, target 1" Result: (pass) Test Case: Use Tab (Read next focusable item) to navigate forward to `[role="button"]` Launch Narrator and Edge. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Tab` (Read next focusable item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button"
NVDA	Chrome	yes	Result: (pass) Test Case: Use down arrow (Read next item) to navigate forward to `[role="button"]` Launch NVDA and Chrome. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `down arrow` (Read next item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "button, target 1" Result: (pass) Test Case: Use Tab (Read next focusable item) to navigate forward to `[role="button"]` Launch NVDA and Chrome. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Tab` (Read next focusable item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button"
NVDA	Edge	yes	Result: (pass) Test Case: Use down arrow (Read next item) to navigate forward to `[role="button"]` Launch NVDA and Edge. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `down arrow` (Read next item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "button, target 1" Result: (pass) Test Case: Use Tab (Read next focusable item) to navigate forward to `[role="button"]` Launch NVDA and Edge. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Tab` (Read next focusable item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button"
NVDA	Firefox	yes	Result: (pass) Test Case: Use down arrow (Read next item) to navigate forward to `[role="button"]` Launch NVDA and Firefox. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `down arrow` (Read next item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "button, target 1" Result: (pass) Test Case: Use Tab (Read next focusable item) to navigate forward to `[role="button"]` Launch NVDA and Firefox. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Tab` (Read next focusable item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button"
Orca	Firefox	yes	Result: (pass) Test Case: Use down arrow (Read next item) to navigate forward to `[role="button"]` Launch Orca and Firefox. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `down arrow` (Read next item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, push button" Result: (pass) Test Case: Use Tab (Read next focusable item) to navigate forward to `[role="button"]` Launch Orca and Firefox. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Tab` (Read next focusable item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, push button"
TalkBack	Chrome	yes	Result: (pass) Test Case: Use Swipe right (or alt+right arrow) (Read next item) to navigate forward to `[role="button"]` Launch TalkBack and Chrome. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Swipe right (or alt+right arrow)` (Read next item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button, double tap to activate"
Voice Access (Android)	Chrome	yes	Result: (pass) Test Case: Use "Tap <text>" or just "<text>" (Activate item by name) Launch Voice Access (Android) and Chrome. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Issue the command: `"Tap <text>" or just "<text>"` (Activate item by name) Record results for the relevant expectations Output:* button was activated Command Notes: said "tap target 1"
Voice Control (iOS)	Safari	not applicable	-
Voice Control (MacOS)	Safari	yes	Result: (pass) Test Case: Use "Show numbers" (Turn on the numbers overlay) Launch Voice Control (MacOS) and Safari. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Issue the command: `"Show numbers"` (Turn on the numbers overlay) Record results for the relevant expectations Output:* role was flagged with a number Command Notes: said "show numbers"
VoiceOver (iOS)	Safari	yes	Result: (pass) Test Case: Use Swipe Right (Next item) to navigate forward to `[role="button"]` Launch VoiceOver (iOS) and Safari. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Swipe Right` (Next item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button"
VoiceOver (macOS)	Safari	yes	Result: (pass) Test Case: Use VO + Right arrow (Read next item) to navigate forward to `[role="button"]` Launch VoiceOver (macOS) and Safari. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `VO + Right arrow` (Read next item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button" Result: (pass) Test Case: Use Tab (Read next focusable item) to navigate forward to `[role="button"]` Launch VoiceOver (macOS) and Safari. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Tab` (Read next focusable item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button"
Windows Speech Recognition	Edge	yes	Result: (pass) Test Case: Use "Show numbers" (Turn on the numbers overlay) Launch Windows Speech Recognition and Edge. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Issue the command: `"Show numbers"` (Turn on the numbers overlay) Record results for the relevant expectations Output:* role was flagged with a number Command Notes: said "show numbers"
Windows Speech Recognition	Chrome	yes	Result: (pass) Test Case: Use "Show numbers" (Turn on the numbers overlay) Launch Windows Speech Recognition and Chrome. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Issue the command: `"Show numbers"` (Turn on the numbers overlay) Record results for the relevant expectations Output:* role was flagged with a number Command Notes: said "show numbers"
Windows Voice Access	Edge	unknown	-
Windows Voice Access	Chrome	unknown	-
Windows Keyboard	Chrome	not applicable	-
Windows Keyboard	Firefox	not applicable	-
Windows Keyboard	Edge	not applicable	-
Mac Keyboard	Chrome	not applicable	-
Mac Keyboard	Safari	not applicable	-
iOS Keyboard	Safari	not applicable	-
Android Keyboard	Chrome	not applicable	-

Extended Support for: button role: convey its role

These are less common combinations

AT	Browser	Has Support	Output
Dragon Naturally Speaking 15.30	IE 11.253	yes	Result: (pass) Test Case: Use Click <role> (Click Type) Launch Dragon Naturally Speaking and IE. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Issue the command: `Click <role>` (Click Type) Record results for the relevant expectations Output:* (all elements of type were flagged)
Dragon Naturally Speaking	Firefox	unknown	-
JAWS 2019.1907.42	IE 11	yes	Result: (pass) Test Case: Use Down arrow (Read next item) to navigate forward to `[role="button"]` Launch JAWS and IE. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Down arrow` (Read next item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button" Result: (pass) Test Case: Use Tab (Read next focusable item) to navigate forward to `[role="button"]` Launch JAWS and IE. Navigate to the test page. Find the target element(s) that you will test against. Identify all elements that match this selector:`[role="button"]` If multiple elements match the selector, repeat this test for all instances. However, choose a single instance to report against. If you feel that the selector should be more specific, please open a GitHub Issue. Position and configure the screen reader so that the following conditions are met Virtual focus is: before target Keyboard focus is: before target Mode is: auto (do not explicitly change the mode) Issue the command: `Tab` (Read next focusable item) After issuing the command, virtual focus should be: target Record results for the relevant expectations Output: "target 1, button, to activate press space bar"
Narrator	Firefox	unknown	-
Narrator	Chrome	unknown	-
Narrator	IE	unknown	-
NVDA	IE	unknown	-
TalkBack	Firefox	unknown	-
Voice Access (Android)	Firefox	unknown	-
VoiceOver (iOS)	Chrome	unknown	-
VoiceOver (macOS)	Chrome	unknown	-
VoiceOver (macOS)	Firefox	unknown	-
Orca	Chrome	unknown	-
Voice Control (MacOS)	Chrome	unknown	-
Voice Control (MacOS)	Firefox	unknown	-
Mac Keyboard	Firefox	not applicable	-
Android Keyboard	Firefox	not applicable	-

Dates and Versions of tested combinations

AT	AT Version	Browser	Browser version	OS version	Date tested
Dragon Naturally Speaking	15.30	Chrome	76	Windows 10 version 1903	2019-09-13
JAWS	2021.2107.12	Chrome	92	Windows 10 version 21h1	2021-07-28
JAWS	2021.2107.12	Edge	92	Windows 10 version 21h1	2021-07-28
JAWS	2019.1907.42	Firefox	69	Windows 10 version 1903	2019-09-13
Narrator	Windows 10 version 1903	Edge	44	Windows 10 version 1903	2019-09-13
NVDA	2021.1	Chrome	92	Windows 10 version 21h1	2021-07-28
NVDA	2021.1	Edge	92	Windows 10 version 21h1	2021-07-28
NVDA	2019.2	Firefox	69	Windows 10 version 1903	2019-09-13
Orca	3.31.4	Firefox	69	Ubuntu 19.04	2019-09-13
TalkBack	7.3.0	Chrome	76	7	2019-09-13
Voice Access (Android)	3.1	Chrome	77	7	2019-10-02
Voice Control (iOS)	13.0	Safari	13.0	13.0	2019-09-23
Voice Control (MacOS)	10.15	Safari	13.0.2	10.15	2019-10-07
VoiceOver (iOS)	12.4.1	Safari	12.4.1	12.4.1	2019-09-13
VoiceOver (macOS)	10.14.6	Safari	12.1.2	10.14.6	2019-09-13
Windows Speech Recognition	Windows 10 version 1903	Edge	44	Windows 10 version 1903	2019-10-18
Windows Speech Recognition	Windows 10 version 1903	Chrome	77	Windows 10 version 1903	2019-10-18

History

2019-02-08 Test created
2019-09-13 Missing combinations added
2019-09-23 added vc_ios results
2019-10-02 Add va_and results
2019-10-07 Add vc_macos results
2019-10-18 Add wsr results
2021-07-28 Added Narrator results for NVDA and JAWS, updated NVDA+Chrome results.

Test: ARIA button name from aria-label

On this page

About this test

Age of results

Test HTML

Summary of Screen Reader support by expectation

Summary of Voice Control support by expectation

Detailed support results by expectation

Expectation for the button role: convey its name

Rationale:

Strength of this expectation for different types of assistive technologies:

Grading method:

Extended Support for: button role: convey its name

Expectation for the button role: convey its role

Rationale:

Strength of this expectation for different types of assistive technologies:

Examples:

Grading method:

Extended Support for: button role: convey its role

Dates and Versions of tested combinations

History

Feedback and Contribute

Other

Test: ARIA button name from aria-label

On this page

About this test

Age of results

Test HTML

Summary of Screen Reader support by expectation

Summary of Voice Control support by expectation

Detailed support results by expectation

Expectation for the button role: convey its name

Rationale:

Strength of this expectation for different types of assistive technologies:

Grading method:

Extended Support for: button role: convey its name

Expectation for the button role: convey its role

Rationale:

Strength of this expectation for different types of assistive technologies:

Examples:

Grading method:

Extended Support for: button role: convey its role

Dates and Versions of tested combinations

History

Related Features

Feedback and Contribute

Other