Test: APG Editable Combobox With List Autocomplete Example
Screen Reader support level: partial (189/248)
Voice Control support level: partial (41/44)
On this page
About this test
This is a test of the Aria Authoring Practices Editable Combobox With List Autocomplete Example
Age of results
Results in this test range from a year ago to 2 years ago. See detailed information about test dates and versions for more information.
Caution
Failing or partial results may be out of date. The oldest result is from 2 years ago. Consider running this test and contributing results.
Test HTML
view the external testSummary of Screen Reader support by expectation
* means that some support is hidden behind settings
Summary of Voice Control support by expectation
aria-activedescendant attribute| 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 | 
|---|
| Not applicable | 
aria-autocomplete attribute| 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 | 
|---|
| Not applicable | 
aria-controls attribute| 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 | 
|---|
| Not applicable | 
aria-expanded attribute| 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 | 
|---|
| Not applicable | 
aria-haspopup attribute| 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 | 
|---|
| Not applicable | 
aria-selected attribute| 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 | 
|---|
| Not applicable | 
listbox role| 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 | 
|---|
| Not applicable | 
* means that some support is hidden behind settings
Summary of Keyboard support by expectation
aria-activedescendant attribute| Expectation | Windows Keyboard | Mac Keyboard | iOS Keyboard | Android Keyboard | 
|---|
| Chrome | Firefox | Edge | Chrome | Safari | Safari | Chrome | 
|---|
| Not applicable | 
aria-autocomplete attribute| Expectation | Windows Keyboard | Mac Keyboard | iOS Keyboard | Android Keyboard | 
|---|
| Chrome | Firefox | Edge | Chrome | Safari | Safari | Chrome | 
|---|
| Not applicable | 
aria-controls attribute| Expectation | Windows Keyboard | Mac Keyboard | iOS Keyboard | Android Keyboard | 
|---|
| Chrome | Firefox | Edge | Chrome | Safari | Safari | Chrome | 
|---|
| Not applicable | 
aria-expanded attribute| Expectation | Windows Keyboard | Mac Keyboard | iOS Keyboard | Android Keyboard | 
|---|
| Chrome | Firefox | Edge | Chrome | Safari | Safari | Chrome | 
|---|
| Not applicable | 
aria-haspopup attribute| Expectation | Windows Keyboard | Mac Keyboard | iOS Keyboard | Android Keyboard | 
|---|
| Chrome | Firefox | Edge | Chrome | Safari | Safari | Chrome | 
|---|
| Not applicable | 
aria-selected attribute| Expectation | Windows Keyboard | Mac Keyboard | iOS Keyboard | Android Keyboard | 
|---|
| Chrome | Firefox | Edge | Chrome | Safari | Safari | Chrome | 
|---|
| Not applicable | 
combobox role| Expectation | Windows Keyboard | Mac Keyboard | iOS Keyboard | Android Keyboard | 
|---|
| Chrome | Firefox | Edge | Chrome | Safari | Safari | Chrome | 
|---|
| Not applicable | 
listbox role| Expectation | Windows Keyboard | Mac Keyboard | iOS Keyboard | Android Keyboard | 
|---|
| Chrome | Firefox | Edge | Chrome | Safari | Safari | Chrome | 
|---|
| Not applicable | 
option role| Expectation | Windows Keyboard | Mac Keyboard | iOS Keyboard | Android Keyboard | 
|---|
| Chrome | Firefox | Edge | Chrome | Safari | Safari | Chrome | 
|---|
| Not applicable | 
button element| Expectation | Windows Keyboard | Mac Keyboard | iOS Keyboard | Android Keyboard | 
|---|
| Chrome | Firefox | Edge | Chrome | Safari | Safari | Chrome | 
|---|
| Not applicable | 
* means that some support is hidden behind settings
Detailed support results by expectation
Expectation for the aria-activedescendant attribute: convey the referenced element as active - applied to the combobox role
 This expectation is applied to the combobox role. Expectations and results might differ when the the feature is applied to different roles.
This expectation is from the aria-activedescendant attribute feature.
Rationale:
A screen reader user needs to be aware of which descendant is currently active
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- When navigating to an element with this attribute, screen readers will also announce the referenced element
Grading method:
Just one of the listed commands must pass for the expectation to pass.
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | Chrome | not applicable | - | 
| JAWS | Chrome | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska, 1 of 6, to move to an item press the arrow keys"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| JAWS | Edge | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska, 1 of 6, to move to an item press the arrow keys"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| JAWS | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska, 1 of 6, to move to an item press the arrow keys"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Narrator | Edge | partial | issue commandResult:  (partial)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "scan, states, nebraska, 1 of 6, selected"Result Notes: Partial because Narrator switched to scan mode, and is no longer respecting the activedescendant. However, if you manually exit scan mode, activedescendant works as expected.summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Chrome | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states, list, nebraska, 1 of 6"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Edge | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states, list, nebraska, 1 of 6"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list, nebraska, 1 of 6"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Orca | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| TalkBack | Chrome | not applicable | issue commandResult:  (na)Test Case: Navigate into listbox from the combobox input using Select next option (Swipe right)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="listbox"]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 commandsummary: navigate forward to the comboboxUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
 is the expectation met?Output: "states, list box" (swipe right again) "end of example, splitter"Result Notes: na because touch was usedsummary: navigate into the listboxUsing the command: "Swipe right" (Select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`virtual cursor location: within target
 | 
| Voice Access (Android) | Chrome | not applicable | - | 
| Voice Control (iOS) | Safari | not applicable | - | 
| Voice Control (MacOS) | Safari | not applicable | - | 
| VoiceOver (iOS) | Safari | not applicable | issue commandResult:  (na)Test Case: Navigate into listbox from the combobox input using select next option (Swipe down)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="listbox"]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 commandsummary: navigate forward to the comboboxUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
 is the expectation met?Output: "states, nebraska, list start"Result Notes: na because touch was usedsummary: navigate into the listboxUsing the command: "Swipe down" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`virtual cursor location: within target
 | 
| VoiceOver (macOS) | Safari | none | issue commandResult:  (fail)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: nothing was conveyedGrading note: This command may be expected to fail. This result simply indicates that it did not yield support.Result:  (fail)summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 issue commandTest Case: Navigate into listbox from the combobox input when the combobox has no value using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: nothing was conveyed, but the list of options was displayed. Nothing was conveyed even when continuing to navigate through the options.Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Windows Speech Recognition | Edge | not applicable | - | 
| Windows Speech Recognition | Chrome | not applicable | - | 
| Windows Voice Access | Edge | not applicable | - | 
| Windows Voice Access | Chrome | not applicable | - | 
| 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: aria-activedescendant attribute: convey the referenced element as active
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | not applicable | - | 
| Dragon Naturally Speaking | Firefox | not applicable | - | 
| JAWS 2021.2011.16 | IE 11 | not applicable | issue commandResult: (na)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: Command Notes: example does not support IE; can't test dynamic functionalitysummary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Narrator | Firefox | unknown | - | 
| Narrator | Chrome | unknown | - | 
| Narrator | IE | unknown | - | 
| NVDA | IE | unknown | - | 
| TalkBack | Firefox | unknown | - | 
| Voice Access (Android) | Firefox | not applicable | - | 
| VoiceOver (iOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Firefox | unknown | - | 
| Orca | Chrome | unknown | - | 
| Voice Control (MacOS) | Chrome | not applicable | - | 
| Voice Control (MacOS) | Firefox | not applicable | - | 
| Mac Keyboard | Firefox | not applicable | - | 
| Android Keyboard | Firefox | not applicable | - | 
Expectation for the aria-activedescendant attribute: convey when the referenced element changes - applied to the combobox role
 This expectation is applied to the combobox role. Expectations and results might differ when the the feature is applied to different roles.
This expectation is from the aria-activedescendant attribute feature.
Rationale:
A screen reader user needs to be aware of which descendant is currently active
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- When navigating within an element with this attribute, screen readers will also announce the referenced element as the reference changes
Grading method:
All of the listed commands must pass for the expectation to pass.
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | Chrome | not applicable | - | 
| JAWS | Chrome | yes | issue commandResult:  (pass)Test Case: Navigate through listbox using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: each option was conveyed. After last option was conveyed, focus was looped back to the first option.summary: navigate through all options in the listboxUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| JAWS | Edge | yes | issue commandResult:  (pass)Test Case: Navigate through listbox using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: each option was conveyed. After last option was conveyed, focus was looped back to the first option.summary: navigate through all options in the listboxUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| JAWS | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate through listbox using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: each option was conveyed. After last option was conveyed, focus was looped back to the first option.summary: navigate through all options in the listboxUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Narrator | Edge | partial | issue commandResult:  (partial)Test Case: Navigate through listbox using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: each option was conveyed. After last option was conveyed, the cursor exited the listbox, but the end boundary was conveyed.Result Notes: partial because Narrator stayed in scan mode and did not respect activedescendant. However, if you manually exit scan mode, activedescendant works as expected.summary: navigate through all options in the listboxUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Chrome | yes | issue commandResult:  (pass)Test Case: Navigate through listbox using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: each option was conveyed. After last option was conveyed, focus was looped back to the first option.summary: navigate through all options in the listboxUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Edge | yes | issue commandResult:  (pass)Test Case: Navigate through listbox using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: each option was conveyed. After last option was conveyed, focus was looped back to the first option.summary: navigate through all options in the listboxUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate through listbox using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: each option was conveyed. After last option was conveyed, focus was looped back to the first option.summary: navigate through all options in the listboxUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Orca | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate through listbox using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: each option was conveyed. After last option was conveyed, focus was looped back to the first option.summary: navigate through all options in the listboxUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| TalkBack | Chrome | not applicable | issue commandResult:  (na)Test Case: Navigate through listbox using Select next option (Swipe right)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="listbox"]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 commandsummary: navigate forward to the comboboxUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
 is the expectation met?Output: all options were skippedResult Notes: na because touch was usedsummary: navigate through all options in the listboxUsing the command: "Swipe right" (Select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`virtual cursor location: within target
 | 
| Voice Access (Android) | Chrome | not applicable | - | 
| Voice Control (iOS) | Safari | not applicable | - | 
| Voice Control (MacOS) | Safari | not applicable | - | 
| VoiceOver (iOS) | Safari | not applicable | issue commandResult:  (na)Test Case: Navigate through listbox using select next option (Swipe down)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="listbox"]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 commandsummary: navigate forward to the comboboxUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
 is the expectation met?Output: new york, list endResult Notes: na because touch was usedsummary: navigate through all options in the listboxUsing the command: "Swipe down" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`virtual cursor location: within target
 | 
| VoiceOver (macOS) | Safari | none | issue commandResult:  (fail)Test Case: Navigate through listbox using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: contents of listbox were skipped entirelyResult:  (fail)summary: navigate through all options in the listboxUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 issue commandTest Case: Navigate through listbox when combobox has no value using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: nothing was conveyed even though visually options were selectedGrading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.summary: navigate through all options in the listboxUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Windows Speech Recognition | Edge | not applicable | - | 
| Windows Speech Recognition | Chrome | not applicable | - | 
| Windows Voice Access | Edge | not applicable | - | 
| Windows Voice Access | Chrome | not applicable | - | 
| 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: aria-activedescendant attribute: convey when the referenced element changes
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | not applicable | - | 
| Dragon Naturally Speaking | Firefox | not applicable | - | 
| JAWS 2021.2011.16 | IE 11 | not applicable | issue commandResult: (na)Test Case: Navigate through listbox using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: Command Notes: example does not support IE; can't test dynamic functionalitysummary: navigate through all options in the listboxUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Narrator | Firefox | unknown | - | 
| Narrator | Chrome | unknown | - | 
| Narrator | IE | unknown | - | 
| NVDA | IE | unknown | - | 
| TalkBack | Firefox | unknown | - | 
| Voice Access (Android) | Firefox | not applicable | - | 
| VoiceOver (iOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Firefox | unknown | - | 
| Orca | Chrome | unknown | - | 
| Voice Control (MacOS) | Chrome | not applicable | - | 
| Voice Control (MacOS) | Firefox | not applicable | - | 
| Mac Keyboard | Firefox | not applicable | - | 
| Android Keyboard | Firefox | not applicable | - | 
Expectation for the aria-autocomplete attribute: convey the `list` value - applied to the combobox role
 This expectation is applied to the combobox role. Expectations and results might differ when the the feature is applied to different roles.
This expectation is from the aria-autocomplete attribute feature.
Rationale:
Screen reader users need to be aware that a form control has list autocomplete behavior before they start typing so that the behavior is not unexpected. When used on a combobox, this value should hint to users that the popup contains auto complete suggestions rather than a static set of options.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Grading method:
Just one of the listed commands must pass for the expectation to pass.
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | Chrome | not applicable | - | 
| JAWS | Chrome | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, combo, collapsed, to set the value use the arrow keys or type the value"Result Notes: Fail because the announcement is the same as if aria-autocomplete was set to none.Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| JAWS | Edge | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, combo, collapsed, to set the value use the arrow keys or type the value"Result Notes: Fail because the announcement is the same as if aria-autocomplete was set to none.Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| JAWS | Firefox | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, combo, collapsed, to set the value use the arrow keys or type the value"Result Notes: Fail because the announcement is the same as if aria-autocomplete was set to none.Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| Narrator | Edge | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "scan off, state, combo, edit, collapsed, has popup"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| NVDA | Chrome | partial | Result:  (partial)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, combo box, collapsed, has auto complete, editable, blank"Result Notes: auto complete was conveyed, but not the list value
 | 
| NVDA | Edge | partial | Result:  (partial)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, combo box, collapsed, has auto complete, editable, blank"Result Notes: auto complete was conveyed, but not the list value
 | 
| NVDA | Firefox | partial | Result:  (partial)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, combobox, collapsed, has auto complete, editable, blank"Result Notes: auto complete is conveyed, but not the list value
 | 
| Orca | Firefox | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, editable combobox"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| TalkBack | Chrome | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next item (Swipe right (or alt+right arrow))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="combobox" aria-expanded="false"]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 commandUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "collapsed, edit box, state"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| Voice Access (Android) | Chrome | not applicable | - | 
| Voice Control (iOS) | Safari | not applicable | - | 
| Voice Control (MacOS) | Safari | not applicable | - | 
| VoiceOver (iOS) | Safari | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Next item (Swipe Right)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="combobox" aria-expanded="false"]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 commandUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "state, combobox, list box popup, collapsed, double tap to expand"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| VoiceOver (macOS) | Safari | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, list box popup, menu popup combobox"
 | 
| Windows Speech Recognition | Edge | not applicable | - | 
| Windows Speech Recognition | Chrome | not applicable | - | 
| Windows Voice Access | Edge | not applicable | - | 
| Windows Voice Access | Chrome | not applicable | - | 
| 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: aria-autocomplete attribute: convey the `list` value
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | not applicable | - | 
| Dragon Naturally Speaking | Firefox | not applicable | - | 
| JAWS 2021.2011.16 | IE 11 | none | Result: (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, type in text"
 | 
| Narrator | Firefox | unknown | - | 
| Narrator | Chrome | unknown | - | 
| Narrator | IE | unknown | - | 
| NVDA | IE | unknown | - | 
| TalkBack | Firefox | unknown | - | 
| Voice Access (Android) | Firefox | not applicable | - | 
| VoiceOver (iOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Firefox | unknown | - | 
| Orca | Chrome | unknown | - | 
| Voice Control (MacOS) | Chrome | not applicable | - | 
| Voice Control (MacOS) | Firefox | not applicable | - | 
| Mac Keyboard | Firefox | not applicable | - | 
| Android Keyboard | Firefox | not applicable | - | 
Expectation for the aria-controls attribute: allow the user to jump to the controlled element - applied to the combobox role
 This expectation is applied to the combobox role. Expectations and results might differ when the the feature is applied to different roles.
This expectation is from the aria-controls attribute feature.
Rationale:
The controlled element might not be close to the element with aria-controls and the user might find it convenient to jump directly to the controlled element.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Grading method:
Just one of the listed commands must pass for the expectation to pass.
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | Chrome | not applicable | - | 
| JAWS | Chrome | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using Jump to controlled element (Insert + alt + M)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "move to controlled element, list box"summary: navigate into the listboxUsing the command: "Insert + alt + M" (Jump to controlled element)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| JAWS | Edge | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using Jump to controlled element (Insert + alt + M)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "move to controlled element, list box"summary: navigate into the listboxUsing the command: "Insert + alt + M" (Jump to controlled element)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| JAWS | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using Jump to controlled element (Insert + alt + M)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "move to controlled element, list box"summary: navigate into the listboxUsing the command: "Insert + alt + M" (Jump to controlled element)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Narrator | Edge | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "scan off, state, combo, edit, collapsed, has popup"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| NVDA | Chrome | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, combo box, collapsed, has auto complete, editable, blank"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| NVDA | Edge | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, combo box, collapsed, has auto complete, editable, blank"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| NVDA | Firefox | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, combobox, collapsed, has auto complete, editable, blank"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| Orca | Firefox | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, editable combobox"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| TalkBack | Chrome | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next item (Swipe right (or alt+right arrow))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="combobox" aria-expanded="false"]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 commandUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "collapsed, edit box, state"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| Voice Access (Android) | Chrome | not applicable | - | 
| Voice Control (iOS) | Safari | not applicable | - | 
| Voice Control (MacOS) | Safari | not applicable | - | 
| VoiceOver (iOS) | Safari | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Next item (Swipe Right)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="combobox" aria-expanded="false"]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 commandUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "state, combobox, list box popup, collapsed, double tap to expand"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| VoiceOver (macOS) | Safari | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, list box popup, menu popup combobox"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| Windows Speech Recognition | Edge | not applicable | - | 
| Windows Speech Recognition | Chrome | not applicable | - | 
| Windows Voice Access | Edge | not applicable | - | 
| Windows Voice Access | Chrome | not applicable | - | 
| 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: aria-controls attribute: allow the user to jump to the controlled element
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | not applicable | - | 
| Dragon Naturally Speaking | Firefox | not applicable | - | 
| JAWS 2021.2011.16 | IE 11 | not applicable | issue commandResult: (na)Test Case: Navigate into listbox from the combobox input using Jump to controlled element (Insert + alt + M)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: Command Notes: example does not support IE; can't test dynamic functionalitysummary: navigate into the listboxUsing the command: "Insert + alt + M" (Jump to controlled element)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Narrator | Firefox | unknown | - | 
| Narrator | Chrome | unknown | - | 
| Narrator | IE | unknown | - | 
| NVDA | IE | unknown | - | 
| TalkBack | Firefox | unknown | - | 
| Voice Access (Android) | Firefox | not applicable | - | 
| VoiceOver (iOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Firefox | unknown | - | 
| Orca | Chrome | unknown | - | 
| Voice Control (MacOS) | Chrome | not applicable | - | 
| Voice Control (MacOS) | Firefox | not applicable | - | 
| Mac Keyboard | Firefox | not applicable | - | 
| Android Keyboard | Firefox | not applicable | - | 
 This expectation is applied to the button element. Expectations and results might differ when the the feature is applied to different roles.
This expectation is from the aria-controls attribute feature.
Rationale:
The controlled element might not be close to the element with aria-controls and the user might find it convenient to jump directly to the controlled element.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Grading method:
Just one of the listed commands must pass for the expectation to pass.
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | Chrome | not applicable | - | 
| JAWS | Chrome | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the button for the combobox using Jump to controlled element (Insert + alt + M)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:buttonIf 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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the button for the comboboxUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: activate the button to expand the listboxUsing the command: "Enter or Space" (Activate Button)
set mode to browseissue commandsummary: navigate forward to the button for the comboboxUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "move to controlled element, list box"summary: navigate into the listboxUsing the command: "Insert + alt + M" (Jump to controlled element)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `button`keyboard focus location: within targetvirtual cursor location: within target
 | 
| JAWS | Edge | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the button for the combobox using Jump to controlled element (Insert + alt + M)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:buttonIf 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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the button for the comboboxUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: activate the button to expand the listboxUsing the command: "Enter or Space" (Activate Button)
set mode to browseissue commandsummary: navigate forward to the button for the comboboxUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "move to controlled element, list box"summary: navigate into the listboxUsing the command: "Insert + alt + M" (Jump to controlled element)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `button`keyboard focus location: within targetvirtual cursor location: within target
 | 
| JAWS | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the button for the combobox using Jump to controlled element (Insert + alt + M)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:buttonIf 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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the button for the comboboxUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: activate the button to expand the listboxUsing the command: "Enter or Space" (Activate Button)
set mode to browseissue commandsummary: navigate forward to the button for the comboboxUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "move to controlled element, list box"summary: navigate into the listboxUsing the command: "Insert + alt + M" (Jump to controlled element)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `button`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Narrator | Edge | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: states, button expandedGrading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| NVDA | Chrome | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, button expanded"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| NVDA | Edge | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, button expanded"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| NVDA | Firefox | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, button expanded"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| Orca | Firefox | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, expanded, push button"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| TalkBack | Chrome | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the button for the collapsed combobox without a value using Read next item (Swipe right (or alt+right arrow))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:button[aria-expanded="true"]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.
Set the value of the target to "ne"issue commandUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`virtual cursor location: target
is the expectation met?Output: "expanded, states, button"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| Voice Access (Android) | Chrome | not applicable | - | 
| Voice Control (iOS) | Safari | not applicable | - | 
| Voice Control (MacOS) | Safari | not applicable | - | 
| VoiceOver (iOS) | Safari | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the button for the collapsed combobox without a value using Next item (Swipe Right)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"issue commandUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`virtual cursor location: target
is the expectation met?Output: "states, button, expanded"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| VoiceOver (macOS) | Safari | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the button for the collapsed combobox without a value using Read next item (VO + Right arrow)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "VO + Right arrow" (Read next item)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, button expanded"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| Windows Speech Recognition | Edge | not applicable | - | 
| Windows Speech Recognition | Chrome | not applicable | - | 
| Windows Voice Access | Edge | not applicable | - | 
| Windows Voice Access | Chrome | not applicable | - | 
| 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: aria-controls attribute: allow the user to jump to the controlled element
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | not applicable | - | 
| Dragon Naturally Speaking | Firefox | not applicable | - | 
| JAWS 2021.2011.16 | IE 11 | not applicable | issue commandResult: (na)Test Case: Navigate into listbox from the button for the combobox using Jump to controlled element (Insert + alt + M)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:buttonIf 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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the button for the comboboxUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: activate the button to expand the listboxUsing the command: "Enter or Space" (Activate Button)
set mode to browseissue commandsummary: navigate forward to the button for the comboboxUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: Command Notes: example does not support IE; can't test dynamic functionalitysummary: navigate into the listboxUsing the command: "Insert + alt + M" (Jump to controlled element)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `button`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Narrator | Firefox | unknown | - | 
| Narrator | Chrome | unknown | - | 
| Narrator | IE | unknown | - | 
| NVDA | IE | unknown | - | 
| TalkBack | Firefox | unknown | - | 
| Voice Access (Android) | Firefox | not applicable | - | 
| VoiceOver (iOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Firefox | unknown | - | 
| Orca | Chrome | unknown | - | 
| Voice Control (MacOS) | Chrome | not applicable | - | 
| Voice Control (MacOS) | Firefox | not applicable | - | 
| Mac Keyboard | Firefox | not applicable | - | 
| Android Keyboard | Firefox | not applicable | - | 
Expectation for the aria-controls attribute: convey the presence of the aria-controls attribute - applied to the combobox role
 This expectation is applied to the combobox role. Expectations and results might differ when the the feature is applied to different roles.
This expectation is from the aria-controls attribute feature.
Rationale:
Users need to be aware that an element has aria-controls functionality. If the presence of the attribute is not explicitly conveyed, then users may not be aware of the functionality. However, some screen readers may choose to not convey the presence by default since the controlled element is usually directly after the controlling element in the reading order and easily findable. In these situations, explicitly conveying the presence could be unnecessarily verbose.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: SHOULD
- Voice Control: NA
Examples:
- When supported, screen readers will often hint that an element controls another element, and may even announce the keyboard shortcut to jump to the controlled element
- Most screen readers either do not support this attribute or the setting to convey the presence is turned off by default. This is because in the vast majority of cases, the controlled element is adjacent to the element with aria-controls, and thus announcing the presence is redundant and add extra verbosity.
Grading method:
Just one of the listed commands must pass for the expectation to pass.
Notes:
This is not a MUST requirement, because the functionality could still be discoverable via the screen reader's command to jump to the controlled element. If the command fails, the attribute is not present.
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | Chrome | not applicable | - | 
| JAWS | Chrome | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, combo, collapsed, to set the value use the arrow keys or type the value"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| JAWS | Edge | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, combo, collapsed, to set the value use the arrow keys or type the value"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| JAWS | Firefox | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, combo, collapsed, to set the value use the arrow keys or type the value"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| Narrator | Edge | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "scan off, state, combo, edit, collapsed, has popup"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| NVDA | Chrome | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, combo box, collapsed, has auto complete, editable, blank"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| NVDA | Edge | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, combo box, collapsed, has auto complete, editable, blank"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| NVDA | Firefox | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, combobox, collapsed, has auto complete, editable, blank"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| Orca | Firefox | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, editable combobox"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| TalkBack | Chrome | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next item (Swipe right (or alt+right arrow))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="combobox" aria-expanded="false"]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 commandUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "collapsed, edit box, state"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| Voice Access (Android) | Chrome | not applicable | - | 
| Voice Control (iOS) | Safari | not applicable | - | 
| Voice Control (MacOS) | Safari | not applicable | - | 
| VoiceOver (iOS) | Safari | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Next item (Swipe Right)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="combobox" aria-expanded="false"]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 commandUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "state, combobox, list box popup, collapsed, double tap to expand"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| VoiceOver (macOS) | Safari | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, list box popup, menu popup combobox"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| Windows Speech Recognition | Edge | not applicable | - | 
| Windows Speech Recognition | Chrome | not applicable | - | 
| Windows Voice Access | Edge | not applicable | - | 
| Windows Voice Access | Chrome | not applicable | - | 
| 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: aria-controls attribute: convey the presence of the aria-controls attribute
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | not applicable | - | 
| Dragon Naturally Speaking | Firefox | not applicable | - | 
| JAWS 2021.2011.16 | IE 11 | none | Result: (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, type in text"
 | 
| Narrator | Firefox | unknown | - | 
| Narrator | Chrome | unknown | - | 
| Narrator | IE | unknown | - | 
| NVDA | IE | unknown | - | 
| TalkBack | Firefox | unknown | - | 
| Voice Access (Android) | Firefox | not applicable | - | 
| VoiceOver (iOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Firefox | unknown | - | 
| Orca | Chrome | unknown | - | 
| Voice Control (MacOS) | Chrome | not applicable | - | 
| Voice Control (MacOS) | Firefox | not applicable | - | 
| Mac Keyboard | Firefox | not applicable | - | 
| Android Keyboard | Firefox | not applicable | - | 
 This expectation is applied to the button element. Expectations and results might differ when the the feature is applied to different roles.
This expectation is from the aria-controls attribute feature.
Rationale:
Users need to be aware that an element has aria-controls functionality. If the presence of the attribute is not explicitly conveyed, then users may not be aware of the functionality. However, some screen readers may choose to not convey the presence by default since the controlled element is usually directly after the controlling element in the reading order and easily findable. In these situations, explicitly conveying the presence could be unnecessarily verbose.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: SHOULD
- Voice Control: NA
Examples:
- When supported, screen readers will often hint that an element controls another element, and may even announce the keyboard shortcut to jump to the controlled element
- Most screen readers either do not support this attribute or the setting to convey the presence is turned off by default. This is because in the vast majority of cases, the controlled element is adjacent to the element with aria-controls, and thus announcing the presence is redundant and add extra verbosity.
Grading method:
Just one of the listed commands must pass for the expectation to pass.
Notes:
This is not a MUST requirement, because the functionality could still be discoverable via the screen reader's command to jump to the controlled element. If the command fails, the attribute is not present.
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | Chrome | not applicable | - | 
| JAWS | Chrome | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, button expanded"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| JAWS | Edge | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, button expanded"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| JAWS | Firefox | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, button expanded"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| Narrator | Edge | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: states, button expandedGrading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| NVDA | Chrome | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, button expanded"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| NVDA | Edge | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, button expanded"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| NVDA | Firefox | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, button expanded"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| Orca | Firefox | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, expanded, push button"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| TalkBack | Chrome | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the button for the collapsed combobox without a value using Read next item (Swipe right (or alt+right arrow))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:button[aria-expanded="true"]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.
Set the value of the target to "ne"issue commandUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`virtual cursor location: target
is the expectation met?Output: "expanded, states, button"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| Voice Access (Android) | Chrome | not applicable | - | 
| Voice Control (iOS) | Safari | not applicable | - | 
| Voice Control (MacOS) | Safari | not applicable | - | 
| VoiceOver (iOS) | Safari | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the button for the collapsed combobox without a value using Next item (Swipe Right)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"issue commandUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`virtual cursor location: target
is the expectation met?Output: "states, button, expanded"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| VoiceOver (macOS) | Safari | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the button for the collapsed combobox without a value using Read next item (VO + Right arrow)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "VO + Right arrow" (Read next item)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, button expanded"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| Windows Speech Recognition | Edge | not applicable | - | 
| Windows Speech Recognition | Chrome | not applicable | - | 
| Windows Voice Access | Edge | not applicable | - | 
| Windows Voice Access | Chrome | not applicable | - | 
| 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: aria-controls attribute: convey the presence of the aria-controls attribute
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | not applicable | - | 
| Dragon Naturally Speaking | Firefox | not applicable | - | 
| JAWS 2021.2011.16 | IE 11 | not applicable | Result: (na)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: Command Notes: example does not support IE; can't test dynamic functionality
 | 
| Narrator | Firefox | unknown | - | 
| Narrator | Chrome | unknown | - | 
| Narrator | IE | unknown | - | 
| NVDA | IE | unknown | - | 
| TalkBack | Firefox | unknown | - | 
| Voice Access (Android) | Firefox | not applicable | - | 
| VoiceOver (iOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Firefox | unknown | - | 
| Orca | Chrome | unknown | - | 
| Voice Control (MacOS) | Chrome | not applicable | - | 
| Voice Control (MacOS) | Firefox | not applicable | - | 
| Mac Keyboard | Firefox | not applicable | - | 
| Android Keyboard | Firefox | not applicable | - | 
Expectation for the aria-expanded attribute: convey change in value - applied to the combobox role
 This expectation is applied to the combobox role. Expectations and results might differ when the the feature is applied to different roles.
This expectation is from the aria-expanded attribute feature.
Rationale:
The user needs to know that the value was successfully changed.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- If the element with aria-expanded has focus when its expanded state changes, the new state value will be announced (either "expanded" or "collapsed"). Some screen readers will re-announce the entire element, including name, role, and other properties and states.
Grading method:
All of the listed commands must pass for the expectation to pass.
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | Chrome | not applicable | - | 
| JAWS | Chrome | yes | is the expectation met?Output: input is echoed back ("n", "e"). "expanded" is announced when the list box is expanded.Result:  (pass)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
 | 
| JAWS | Edge | yes | is the expectation met?Output: input is echoed back ("n", "e"). "expanded" is announced when the list box is expanded.Result:  (pass)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
 | 
| JAWS | Firefox | yes | is the expectation met?Output: input is echoed back ("n", "e"). "expanded" is announced when the list box is expanded.Result:  (pass)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
 | 
| Narrator | Edge | yes | is the expectation met?Output: input is echoed back ("n", "e"). "suggestions available" is announced when the list box is expanded.Result:  (pass)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
 | 
| NVDA | Chrome | yes | is the expectation met?Output: input is echoed back ("n", "e"). "expanded" is announced when the list box is expanded.Result:  (pass)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
 | 
| NVDA | Edge | yes | is the expectation met?Output: input is echoed back ("n", "e"). "expanded" is announced when the list box is expanded.Result:  (pass)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
 | 
| NVDA | Firefox | yes | is the expectation met?Output: input is echoed back ("n", "e"). "expanded" is announced when the list box is expanded.Result:  (pass)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
 | 
| Orca | Firefox | yes | is the expectation met?Output: input is echoed back ("n", "e"). "state, editable combobox, expanded" is announced when the list box is expanded.Result:  (pass)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
 | 
| TalkBack | Chrome | yes | is the expectation met?Output: input is echoed back ("n", "e").Command Notes: list box does not expand while typing, you must expand it via the buttonResult Notes: na because list box does not expandResult:  (pass)Result:  (na)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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 commandsummary: navigate forward to the comboboxUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
 issue commandTest Case: activate the combobox button to expand the combobox using Activate button (double tap (or alt+enter))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:button[aria-expanded="false"]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 commandsummary: navigate forward to the button for the comboboxUsing the command: "nex_item"Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`virtual cursor location: target
 is the expectation met?Output: "expanded, 6 auto complete options available."Using the command: "double tap (or alt+enter)" (Activate button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`virtual cursor location: target
 | 
| Voice Access (Android) | Chrome | not applicable | - | 
| Voice Control (iOS) | Safari | not applicable | - | 
| Voice Control (MacOS) | Safari | not applicable | - | 
| VoiceOver (iOS) | Safari | none | is the expectation met?Output: input is echoed back ("n", "e").Command Notes: nothing is announced to indicate that the list box has expanded while typingResult:  (na)Result:  (fail)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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 commandsummary: navigate forward to the comboboxUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
 issue commandTest Case: activate the combobox button to expand the combobox using Activate Button (Double tap)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:button[aria-expanded="false"]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 commandsummary: navigate forward to the button for the comboboxUsing the command: "nex_item"Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`virtual cursor location: target
 is the expectation met?Output: "Sate, ne, combobox, list box popup, expanded, double tap to collapse"Command Notes: focus was moved to the combobox after activating the button.Result Notes: na because focus did not remain on the button - so this is not testable.Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Using the command: "Double tap" (Activate Button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`virtual cursor location: target
 | 
| VoiceOver (macOS) | Safari | none | is the expectation met?Output: input is echoed back ("n", "e").Command Notes: there is no indication that the listbox was expandedGrading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
 | 
| Windows Speech Recognition | Edge | not applicable | - | 
| Windows Speech Recognition | Chrome | not applicable | - | 
| Windows Voice Access | Edge | not applicable | - | 
| Windows Voice Access | Chrome | not applicable | - | 
| 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: aria-expanded attribute: convey change in value
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | not applicable | - | 
| Dragon Naturally Speaking | Firefox | not applicable | - | 
| JAWS 2021.2011.16 | IE 11 | not applicable | is the expectation met?Output: Command Notes: example does not support IE; can't test dynamic functionalityResult: (na)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
 | 
| Narrator | Firefox | unknown | - | 
| Narrator | Chrome | unknown | - | 
| Narrator | IE | unknown | - | 
| NVDA | IE | unknown | - | 
| TalkBack | Firefox | unknown | - | 
| Voice Access (Android) | Firefox | not applicable | - | 
| VoiceOver (iOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Firefox | unknown | - | 
| Orca | Chrome | unknown | - | 
| Voice Control (MacOS) | Chrome | not applicable | - | 
| Voice Control (MacOS) | Firefox | not applicable | - | 
| Mac Keyboard | Firefox | not applicable | - | 
| Android Keyboard | Firefox | not applicable | - | 
Expectation for the aria-expanded attribute: convey the "false" value - applied to the combobox role
 This expectation is applied to the combobox role. Expectations and results might differ when the the feature is applied to different roles.
This expectation is from the aria-expanded attribute feature.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- Most screen readers will announce the state as "collapsed"
Grading method:
Just one of the listed commands must pass for the expectation to pass.
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | Chrome | not applicable | - | 
| JAWS | Chrome | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, combo, collapsed, to set the value use the arrow keys or type the value"
 | 
| JAWS | Edge | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, combo, collapsed, to set the value use the arrow keys or type the value"
 | 
| JAWS | Firefox | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, combo, collapsed, to set the value use the arrow keys or type the value"
 | 
| Narrator | Edge | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "scan off, state, combo, edit, collapsed, has popup"Result Notes: was implied by its absence. When expanded, Narrator announces "suggestions available".
 | 
| NVDA | Chrome | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, combo box, collapsed, has auto complete, editable, blank"
 | 
| NVDA | Edge | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, combo box, collapsed, has auto complete, editable, blank"
 | 
| NVDA | Firefox | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, combobox, collapsed, has auto complete, editable, blank"
 | 
| Orca | Firefox | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, editable combobox"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| TalkBack | Chrome | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next item (Swipe right (or alt+right arrow))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="combobox" aria-expanded="false"]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 commandUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "collapsed, edit box, state"
 | 
| Voice Access (Android) | Chrome | not applicable | - | 
| Voice Control (iOS) | Safari | not applicable | - | 
| Voice Control (MacOS) | Safari | not applicable | - | 
| VoiceOver (iOS) | Safari | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Next item (Swipe Right)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="combobox" aria-expanded="false"]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 commandUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "state, combobox, list box popup, collapsed, double tap to expand"
 | 
| VoiceOver (macOS) | Safari | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, list box popup, menu popup combobox"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| Windows Speech Recognition | Edge | not applicable | - | 
| Windows Speech Recognition | Chrome | not applicable | - | 
| Windows Voice Access | Edge | not applicable | - | 
| Windows Voice Access | Chrome | not applicable | - | 
| 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: aria-expanded attribute: convey the "false" value
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | not applicable | - | 
| Dragon Naturally Speaking | Firefox | not applicable | - | 
| JAWS 2021.2011.16 | IE 11 | none | Result: (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, type in text"
 | 
| Narrator | Firefox | unknown | - | 
| Narrator | Chrome | unknown | - | 
| Narrator | IE | unknown | - | 
| NVDA | IE | unknown | - | 
| TalkBack | Firefox | unknown | - | 
| Voice Access (Android) | Firefox | not applicable | - | 
| VoiceOver (iOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Firefox | unknown | - | 
| Orca | Chrome | unknown | - | 
| Voice Control (MacOS) | Chrome | not applicable | - | 
| Voice Control (MacOS) | Firefox | not applicable | - | 
| Mac Keyboard | Firefox | not applicable | - | 
| Android Keyboard | Firefox | not applicable | - | 
 This expectation is applied to the button element. Expectations and results might differ when the the feature is applied to different roles.
This expectation is from the aria-expanded attribute feature.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- Most screen readers will announce the state as "collapsed"
Grading method:
Just one of the listed commands must pass for the expectation to pass.
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | Chrome | not applicable | - | 
| JAWS | Chrome | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| JAWS | Edge | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| JAWS | Firefox | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| Narrator | Edge | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| NVDA | Chrome | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| NVDA | Edge | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| NVDA | Firefox | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| Orca | Firefox | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, collapsed, push button"
 | 
| TalkBack | Chrome | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Read next item (Swipe right (or alt+right arrow))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:button[aria-expanded="false"]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 commandUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "collapsed, states, button"
 | 
| Voice Access (Android) | Chrome | not applicable | - | 
| Voice Control (iOS) | Safari | not applicable | - | 
| Voice Control (MacOS) | Safari | not applicable | - | 
| VoiceOver (iOS) | Safari | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next item (Swipe Right)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:button[aria-expanded="false"]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 commandUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "states, button collapsed, double tap to expand"
 | 
| VoiceOver (macOS) | Safari | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Read next item (VO + Right arrow)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "VO + Right arrow" (Read next item)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| Windows Speech Recognition | Edge | not applicable | - | 
| Windows Speech Recognition | Chrome | not applicable | - | 
| Windows Voice Access | Edge | not applicable | - | 
| Windows Voice Access | Chrome | not applicable | - | 
| 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: aria-expanded attribute: convey the "false" value
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | not applicable | - | 
| Dragon Naturally Speaking | Firefox | not applicable | - | 
| JAWS 2021.2011.16 | IE 11 | yes | Result: (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, button collapsed"
 | 
| Narrator | Firefox | unknown | - | 
| Narrator | Chrome | unknown | - | 
| Narrator | IE | unknown | - | 
| NVDA | IE | unknown | - | 
| TalkBack | Firefox | unknown | - | 
| Voice Access (Android) | Firefox | not applicable | - | 
| VoiceOver (iOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Firefox | unknown | - | 
| Orca | Chrome | unknown | - | 
| Voice Control (MacOS) | Chrome | not applicable | - | 
| Voice Control (MacOS) | Firefox | not applicable | - | 
| Mac Keyboard | Firefox | not applicable | - | 
| Android Keyboard | Firefox | not applicable | - | 
Expectation for the aria-expanded attribute: convey the "true" value - applied to the combobox role
 This expectation is applied to the combobox role. Expectations and results might differ when the the feature is applied to different roles.
This expectation is from the aria-expanded attribute feature.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- Most screen readers will announce the state as "expanded"
Grading method:
Just one of the listed commands must pass for the expectation to pass.
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | Chrome | not applicable | - | 
| JAWS | Chrome | yes | Result:  (pass)Test Case: navigate forward to the expanded combobox with a value using Read next item (Down arrow)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="combobox" aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browsePosition the AT so that the following is truekeyboard focus location: targetvirtual cursor location: before target
issue commandUsing the command: "Down arrow" (Read next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "State, edit, combo, collapsed, alabama"
 | 
| JAWS | Edge | yes | Result:  (pass)Test Case: navigate forward to the expanded combobox with a value using Read next item (Down arrow)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="combobox" aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browsePosition the AT so that the following is truekeyboard focus location: targetvirtual cursor location: before target
issue commandUsing the command: "Down arrow" (Read next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "State, edit, combo, collapsed, alabama"
 | 
| JAWS | Firefox | yes | Result:  (pass)Test Case: navigate forward to the expanded combobox with a value using Read next item (Down arrow)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="combobox" aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browsePosition the AT so that the following is truekeyboard focus location: targetvirtual cursor location: before target
issue commandUsing the command: "Down arrow" (Read next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "State, edit, combo, collapsed, alabama"
 | 
| Narrator | Edge | yes | Result:  (pass)Test Case: navigate forward to the expanded combobox with a value using Jump to next item (scan mode) (Down arrow)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="combobox" aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browsePosition the AT so that the following is truekeyboard focus location: targetvirtual cursor location: before target
issue commandUsing the command: "Down arrow" (Jump to next item (scan mode))Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, ne, combo, edit, expanded, has popup ne, scan off"
 | 
| NVDA | Chrome | yes | Result:  (pass)Test Case: navigate forward to the expanded combobox with a value using Read next item (down arrow)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="combobox" aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browsePosition the AT so that the following is truekeyboard focus location: targetvirtual cursor location: before target
issue commandUsing the command: "down arrow" (Read next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "combo box, expanded, has auto complete, editable, ne"
 | 
| NVDA | Edge | yes | Result:  (pass)Test Case: navigate forward to the expanded combobox with a value using Read next item (down arrow)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="combobox" aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browsePosition the AT so that the following is truekeyboard focus location: targetvirtual cursor location: before target
issue commandUsing the command: "down arrow" (Read next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "combo box, expanded, has auto complete, editable, ne"
 | 
| NVDA | Firefox | yes | Result:  (pass)Test Case: navigate forward to the expanded combobox with a value using Read next item (down arrow)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="combobox" aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browsePosition the AT so that the following is truekeyboard focus location: targetvirtual cursor location: before target
issue commandUsing the command: "down arrow" (Read next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "combo box, expanded, has auto complete, editable, ne"
 | 
| Orca | Firefox | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the expanded combobox with a value using Read next item (down arrow)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="combobox" aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browsePosition the AT so that the following is truekeyboard focus location: targetvirtual cursor location: before target
issue commandUsing the command: "down arrow" (Read next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "editable combobox, ne, states, expanded, push button"Result Notes: fail because the state was conveyed, but only because orca read both the combobox and the button. The conveyed state in the part of the announcement from the button, not the combobox.Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| TalkBack | Chrome | yes | is the expectation met?Output: "expanded, editing, ne, edit box, state"Result:  (pass)Test Case: navigate backward to the expanded combobox with a value after expanding via combobox button using Read previous item (Swipe left (or alt+left arrow))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="combobox" aria-expanded="true"]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.
Set the value of the target to "ne"issue commandsummary: navigate forward to the button for the comboboxUsing the command: "nex_item"Ensure AT location after executing the commandTarget: `button`virtual cursor location: target
issue commandsummary: activate the button to expand the listboxUsing the command: "double tap (or alt+enter)" (Activate button)
issue commandUsing the command: "Swipe left (or alt+left arrow)" (Read previous item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="true"]`virtual cursor location: target
 | 
| Voice Access (Android) | Chrome | not applicable | - | 
| Voice Control (iOS) | Safari | not applicable | - | 
| Voice Control (MacOS) | Safari | not applicable | - | 
| VoiceOver (iOS) | Safari | yes | is the expectation met?Output: "Sate, ne, combobox, list box popup, expanded, double tap to collapse"Result:  (pass)Test Case: navigate backward to the expanded combobox with a value after expanding via combobox button using Previous item (Swipe Left)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="combobox" aria-expanded="true"]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.
Set the value of the target to "ne"issue commandsummary: navigate forward to the button for the comboboxUsing the command: "nex_item"Ensure AT location after executing the commandTarget: `button`virtual cursor location: target
issue commandsummary: activate the button to expand the listboxUsing the command: "Double tap" (Activate Button)
issue commandUsing the command: "Swipe Left" (Previous item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="true"]`virtual cursor location: target
 | 
| VoiceOver (macOS) | Safari | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the expanded combobox with a value using Read next item (VO + Right arrow)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="combobox" aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browsePosition the AT so that the following is truekeyboard focus location: targetvirtual cursor location: before target
issue commandUsing the command: "VO + Right arrow" (Read next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "ne, state, list box popup, menu popup, combobox"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| Windows Speech Recognition | Edge | not applicable | - | 
| Windows Speech Recognition | Chrome | not applicable | - | 
| Windows Voice Access | Edge | not applicable | - | 
| Windows Voice Access | Chrome | not applicable | - | 
| 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: aria-expanded attribute: convey the "true" value
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | not applicable | - | 
| Dragon Naturally Speaking | Firefox | not applicable | - | 
| JAWS 2021.2011.16 | IE 11 | not applicable | Result: (na)Test Case: navigate forward to the expanded combobox with a value using Read next item (Down arrow)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="combobox" aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browsePosition the AT so that the following is truekeyboard focus location: targetvirtual cursor location: before target
issue commandUsing the command: "Down arrow" (Read next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: Command Notes: example does not support IE; can't test dynamic functionality
 | 
| Narrator | Firefox | unknown | - | 
| Narrator | Chrome | unknown | - | 
| Narrator | IE | unknown | - | 
| NVDA | IE | unknown | - | 
| TalkBack | Firefox | unknown | - | 
| Voice Access (Android) | Firefox | not applicable | - | 
| VoiceOver (iOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Firefox | unknown | - | 
| Orca | Chrome | unknown | - | 
| Voice Control (MacOS) | Chrome | not applicable | - | 
| Voice Control (MacOS) | Firefox | not applicable | - | 
| Mac Keyboard | Firefox | not applicable | - | 
| Android Keyboard | Firefox | not applicable | - | 
 This expectation is applied to the button element. Expectations and results might differ when the the feature is applied to different roles.
This expectation is from the aria-expanded attribute feature.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- Most screen readers will announce the state as "expanded"
Grading method:
Just one of the listed commands must pass for the expectation to pass.
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | Chrome | not applicable | - | 
| JAWS | Chrome | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, button expanded"
 | 
| JAWS | Edge | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, button expanded"
 | 
| JAWS | Firefox | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, button expanded"
 | 
| Narrator | Edge | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: states, button expanded
 | 
| NVDA | Chrome | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, button expanded"
 | 
| NVDA | Edge | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, button expanded"
 | 
| NVDA | Firefox | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, button expanded"
 | 
| Orca | Firefox | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, expanded, push button"
 | 
| TalkBack | Chrome | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Read next item (Swipe right (or alt+right arrow))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:button[aria-expanded="true"]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.
Set the value of the target to "ne"issue commandUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`virtual cursor location: target
is the expectation met?Output: "expanded, states, button"
 | 
| Voice Access (Android) | Chrome | not applicable | - | 
| Voice Control (iOS) | Safari | not applicable | - | 
| Voice Control (MacOS) | Safari | not applicable | - | 
| VoiceOver (iOS) | Safari | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next item (Swipe Right)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"issue commandUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`virtual cursor location: target
is the expectation met?Output: "states, button, expanded"
 | 
| VoiceOver (macOS) | Safari | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Read next item (VO + Right arrow)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "VO + Right arrow" (Read next item)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, button expanded"
 | 
| Windows Speech Recognition | Edge | not applicable | - | 
| Windows Speech Recognition | Chrome | not applicable | - | 
| Windows Voice Access | Edge | not applicable | - | 
| Windows Voice Access | Chrome | not applicable | - | 
| 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: aria-expanded attribute: convey the "true" value
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | not applicable | - | 
| Dragon Naturally Speaking | Firefox | not applicable | - | 
| JAWS 2021.2011.16 | IE 11 | not applicable | Result: (na)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="true"]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.
Set the value of the target to "ne"set mode to browseissue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="true"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: Command Notes: example does not support IE; can't test dynamic functionality
 | 
| Narrator | Firefox | unknown | - | 
| Narrator | Chrome | unknown | - | 
| Narrator | IE | unknown | - | 
| NVDA | IE | unknown | - | 
| TalkBack | Firefox | unknown | - | 
| Voice Access (Android) | Firefox | not applicable | - | 
| VoiceOver (iOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Firefox | unknown | - | 
| Orca | Chrome | unknown | - | 
| Voice Control (MacOS) | Chrome | not applicable | - | 
| Voice Control (MacOS) | Firefox | not applicable | - | 
| Mac Keyboard | Firefox | not applicable | - | 
| Android Keyboard | Firefox | not applicable | - | 
 This expectation is applied to the combobox role. Expectations and results might differ when the the feature is applied to different roles.
This expectation is from the aria-haspopup attribute feature.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Grading method:
Just one of the listed commands must pass for the expectation to pass.
| AT | Browser | Has Support | Output | 
|---|
| TalkBack | Chrome | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next item (Swipe right (or alt+right arrow))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="combobox" aria-expanded="false"]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 commandUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "collapsed, edit box, state"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| Voice Access (Android) | Chrome | not applicable | - | 
| Android Keyboard | Chrome | not applicable | - | 
Extended Support for: aria-haspopup attribute: convey the "listbox" value
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | not applicable | - | 
| Dragon Naturally Speaking | Firefox | not applicable | - | 
| JAWS 2021.2011.16 | IE 11 | none | Result: (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, type in text"
 | 
| Narrator | Firefox | unknown | - | 
| Narrator | Chrome | unknown | - | 
| Narrator | IE | unknown | - | 
| NVDA | IE | unknown | - | 
| TalkBack | Firefox | unknown | - | 
| Voice Access (Android) | Firefox | not applicable | - | 
| VoiceOver (iOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Firefox | unknown | - | 
| Orca | Chrome | unknown | - | 
| Voice Control (MacOS) | Chrome | not applicable | - | 
| Voice Control (MacOS) | Firefox | not applicable | - | 
| Mac Keyboard | Firefox | not applicable | - | 
| Android Keyboard | Firefox | not applicable | - | 
Expectation for the aria-selected attribute: convey true value by indicating that the element is currently selected - applied to the option role
 This expectation is applied to the option role. Expectations and results might differ when the the feature is applied to different roles.
This expectation is from the aria-selected attribute feature.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- A screen reader might announce something like "selected".
Grading method:
Just one of the listed commands must pass for the expectation to pass.
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | Chrome | not applicable | - | 
| JAWS | Chrome | none | issue commandResult:  (fail)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska, 1 of 6, to move to an item press the arrow keys"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| JAWS | Edge | none | issue commandResult:  (fail)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska, 1 of 6, to move to an item press the arrow keys"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| JAWS | Firefox | none | issue commandResult:  (fail)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska, 1 of 6, to move to an item press the arrow keys"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Narrator | Edge | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "scan, states, nebraska, 1 of 6, selected"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Chrome | none | issue commandResult:  (fail)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states, list, nebraska, 1 of 6"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Edge | none | issue commandResult:  (fail)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states, list, nebraska, 1 of 6"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Firefox | none | issue commandResult:  (fail)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list, nebraska, 1 of 6"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Orca | Firefox | none | issue commandResult:  (fail)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| TalkBack | Chrome | not applicable | issue commandResult:  (na)Test Case: Navigate into listbox from the combobox input using Select next option (Swipe right)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="listbox"]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 commandsummary: navigate forward to the comboboxUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
 is the expectation met?Output: "states, list box" (swipe right again) "end of example, splitter"Result Notes: na because it was not possible to navigate to an option and testsummary: navigate into the listboxUsing the command: "Swipe right" (Select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`virtual cursor location: within target
 | 
| Voice Access (Android) | Chrome | not applicable | - | 
| Voice Control (iOS) | Safari | not applicable | - | 
| Voice Control (MacOS) | Safari | not applicable | - | 
| VoiceOver (iOS) | Safari | none | issue commandResult:  (fail)Test Case: Navigate into listbox from the combobox input using select next option (Swipe down)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="listbox"]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 commandsummary: navigate forward to the comboboxUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
 is the expectation met?Output: "states, nebraska, list start"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.summary: navigate into the listboxUsing the command: "Swipe down" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`virtual cursor location: within target
 | 
| VoiceOver (macOS) | Safari | none | issue commandResult:  (fail)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: nothing was conveyedGrading note: This command may be expected to fail. This result simply indicates that it did not yield support.Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Windows Speech Recognition | Edge | not applicable | - | 
| Windows Speech Recognition | Chrome | not applicable | - | 
| Windows Voice Access | Edge | not applicable | - | 
| Windows Voice Access | Chrome | not applicable | - | 
| 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: aria-selected attribute: convey true value by indicating that the element is currently selected
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | not applicable | - | 
| Dragon Naturally Speaking | Firefox | not applicable | - | 
| JAWS 2021.2011.16 | IE 11 | not applicable | issue commandResult: (na)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: Command Notes: example does not support IE; can't test dynamic functionalitysummary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Narrator | Firefox | unknown | - | 
| Narrator | Chrome | unknown | - | 
| Narrator | IE | unknown | - | 
| NVDA | IE | unknown | - | 
| TalkBack | Firefox | unknown | - | 
| Voice Access (Android) | Firefox | not applicable | - | 
| VoiceOver (iOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Firefox | unknown | - | 
| Orca | Chrome | unknown | - | 
| Voice Control (MacOS) | Chrome | not applicable | - | 
| Voice Control (MacOS) | Firefox | not applicable | - | 
| Mac Keyboard | Firefox | not applicable | - | 
| Android Keyboard | Firefox | not applicable | - | 
Expectation for the combobox role: convey its name - applied to the input[type="text"] element
 This expectation is applied to the input[type="text"] element. Expectations and results might differ when the the feature is applied to different roles.
This expectation is from the combobox 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
Examples:
- A screen reader might convey the name as something like "<role>, <name>, <value>" (order varies by screen reader and settings)
- Voice control software might allow the user to say "click <name>" to focus the combobox
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="combobox"]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: text input was focusedCommand Notes: said "click state"
 | 
| JAWS | Chrome | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, combo, collapsed, to set the value use the arrow keys or type the value"
 | 
| JAWS | Edge | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, combo, collapsed, to set the value use the arrow keys or type the value"
 | 
| JAWS | Firefox | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, combo, collapsed, to set the value use the arrow keys or type the value"
 | 
| Narrator | Edge | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "scan off, state, combo, edit, collapsed, has popup"
 | 
| NVDA | Chrome | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, combo box, collapsed, has auto complete, editable, blank"
 | 
| NVDA | Edge | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, combo box, collapsed, has auto complete, editable, blank"
 | 
| NVDA | Firefox | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, combobox, collapsed, has auto complete, editable, blank"
 | 
| Orca | Firefox | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, editable combobox"
 | 
| TalkBack | Chrome | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next item (Swipe right (or alt+right arrow))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="combobox" aria-expanded="false"]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 commandUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "collapsed, edit box, state"
 | 
| 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="combobox"]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: input was flaggedCommand Notes: said "tap state"
 | 
| 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="combobox"]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: input was focusedCommand Notes: said "tap state"
 | 
| 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="combobox"]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: input was focusedCommand Notes: said "click state"
 | 
| VoiceOver (iOS) | Safari | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Next item (Swipe Right)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="combobox" aria-expanded="false"]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 commandUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "state, combobox, list box popup, collapsed, double tap to expand"
 | 
| VoiceOver (macOS) | Safari | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, list box popup, menu popup combobox"
 | 
| 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="combobox"]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 activatedCommand Notes: said "click state"
 | 
| 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="combobox"]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 activatedCommand Notes: said "click state"
 | 
| Windows Voice Access | Edge | yes | Result:  (pass)Test Case: Use "Click <text>" (Activate item by name)Launch Windows Voice Access 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="combobox"]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 activatedCommand Notes: said "click state"
 | 
| Windows Voice Access | Chrome | yes | Result:  (pass)Test Case: Use "Click <text>" (Activate item by name)Launch Windows Voice Access 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="combobox"]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 activatedCommand Notes: said "click state"
 | 
| 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: combobox role: convey its name
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | unknown | - | 
| Dragon Naturally Speaking | Firefox | unknown | - | 
| JAWS 2021.2011.16 | IE 11 | yes | Result: (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, type in text"
 | 
| 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 combobox role: convey its role - applied to the input[type="text"] element
 This expectation is applied to the input[type="text"] element. Expectations and results might differ when the the feature is applied to different roles.
This expectation is from the combobox 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 convey the role as something like "combo box"
- Voice control software might allow the user to say "click text box" to focus an editable combobox
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="combobox"]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: text input was focusedCommand Notes: said "click edit"
Result:  (fail)Test Case: Use "Hide choices" (Hide drop down choices)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="combobox"]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: "Hide choices"(Hide drop down choices)Record results for the relevant expectations
Output: suggestions displayed after saying "click state" but were not hidden after saying "hide choices"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| JAWS | Chrome | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, combo, collapsed, to set the value use the arrow keys or type the value"
 | 
| JAWS | Edge | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, combo, collapsed, to set the value use the arrow keys or type the value"
 | 
| JAWS | Firefox | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, combo, collapsed, to set the value use the arrow keys or type the value"
 | 
| Narrator | Edge | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "scan off, state, combo, edit, collapsed, has popup"
 | 
| NVDA | Chrome | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, combo box, collapsed, has auto complete, editable, blank"
 | 
| NVDA | Edge | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, combo box, collapsed, has auto complete, editable, blank"
 | 
| NVDA | Firefox | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, combobox, collapsed, has auto complete, editable, blank"
 | 
| Orca | Firefox | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, editable combobox"
 | 
| TalkBack | Chrome | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next item (Swipe right (or alt+right arrow))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="combobox" aria-expanded="false"]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 commandUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "collapsed, edit box, state"Result Notes: combobox role was implied by the "collapsed" state + "edit box" role. It could be argued that the combobox role was not conveyed, because the "collapsed" state is a result of aria-expanded rather than the combobox role. However, the absence of an explicit announcement for the combobox role likely will not prevent end users from understanding the combobox behavior of the control because the collapsed state is conveyed along with the text input role.
 | 
| Voice Access (Android) | Chrome | yes | Result:  (pass)Test Case: Use "Show numbers" (Turn on the numbers overlay)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="combobox"]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 numberCommand Notes: said "show numbers"
 | 
| 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="combobox"]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 numberCommand Notes: said "show numbers"
 | 
| VoiceOver (iOS) | Safari | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Next item (Swipe Right)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="combobox" aria-expanded="false"]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 commandUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "state, combobox, list box popup, collapsed, double tap to expand"
 | 
| VoiceOver (macOS) | Safari | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, list box popup, menu popup combobox"
 | 
| 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="combobox"]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 numberCommand 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="combobox"]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 numberCommand Notes: said "show numbers"
 | 
| Windows Voice Access | Edge | yes | Result:  (pass)Test Case: Use "Show numbers" (Turn on the numbers overlay)Launch Windows Voice Access 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="combobox"]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 numberCommand Notes: said "show numbers"
 | 
| Windows Voice Access | Chrome | yes | Result:  (pass)Test Case: Use "Show numbers" (Turn on the numbers overlay)Launch Windows Voice Access 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="combobox"]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 numberCommand Notes: said "show numbers"
 | 
| 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: combobox role: convey its role
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | unknown | - | 
| Dragon Naturally Speaking | Firefox | unknown | - | 
| JAWS 2021.2011.16 | IE 11 | none | Result: (fail)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, type in text"
 | 
| 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 combobox role: convey the current value - applied to the input[type="text"] element
 This expectation is applied to the input[type="text"] element. Expectations and results might differ when the the feature is applied to different roles.
This expectation is from the combobox role feature.
Rationale:
A screen reader user needs to know the current value of the input.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- A screen reader might convey the value as something like "<role>, <name>, <value>" (order varies by screen reader and settings)
Grading method:
Just one of the listed commands must pass for the expectation to pass.
Notes:
Historically, this has not been a requirement explicitly defined in the ARIA spec. However, native counterparts do this, the value us displayed visually, and ARIA 1.2 (draft) does explicitly state this requirement.
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | Chrome | not applicable | - | 
| JAWS | Chrome | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, combo, collapsed, to set the value use the arrow keys or type the value"Result Notes: value is blank
 | 
| JAWS | Edge | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, combo, collapsed, to set the value use the arrow keys or type the value"Result Notes: value is blank
 | 
| JAWS | Firefox | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, combo, collapsed, to set the value use the arrow keys or type the value"Result Notes: value is blank
 | 
| Narrator | Edge | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "scan off, state, combo, edit, collapsed, has popup"Result Notes: value is blank
 | 
| NVDA | Chrome | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, combo box, collapsed, has auto complete, editable, blank"Result Notes: value is blank
 | 
| NVDA | Edge | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, combo box, collapsed, has auto complete, editable, blank"Result Notes: value is blank
 | 
| NVDA | Firefox | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, combobox, collapsed, has auto complete, editable, blank"Result Notes: value is blank
 | 
| Orca | Firefox | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, editable combobox"Result Notes: value is blank
 | 
| TalkBack | Chrome | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next item (Swipe right (or alt+right arrow))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="combobox" aria-expanded="false"]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 commandUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "collapsed, edit box, state"Result Notes: value is blank
 | 
| Voice Access (Android) | Chrome | not applicable | - | 
| Voice Control (iOS) | Safari | not applicable | - | 
| Voice Control (MacOS) | Safari | not applicable | - | 
| VoiceOver (iOS) | Safari | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Next item (Swipe Right)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="combobox" aria-expanded="false"]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 commandUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "state, combobox, list box popup, collapsed, double tap to expand"Result Notes: value is blank
 | 
| VoiceOver (macOS) | Safari | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, list box popup, menu popup combobox"Result Notes: value is blank
 | 
| Windows Speech Recognition | Edge | not applicable | - | 
| Windows Speech Recognition | Chrome | not applicable | - | 
| Windows Voice Access | Edge | not applicable | - | 
| Windows Voice Access | Chrome | not applicable | - | 
| 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: combobox role: convey the current value
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | not applicable | - | 
| Dragon Naturally Speaking | Firefox | not applicable | - | 
| JAWS 2021.2011.16 | IE 11 | yes | Result: (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, type in text"Result Notes: value is blank
 | 
| Narrator | Firefox | unknown | - | 
| Narrator | Chrome | unknown | - | 
| Narrator | IE | unknown | - | 
| NVDA | IE | unknown | - | 
| TalkBack | Firefox | unknown | - | 
| Voice Access (Android) | Firefox | not applicable | - | 
| VoiceOver (iOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Firefox | unknown | - | 
| Orca | Chrome | unknown | - | 
| Voice Control (MacOS) | Chrome | not applicable | - | 
| Voice Control (MacOS) | Firefox | not applicable | - | 
| Mac Keyboard | Firefox | not applicable | - | 
| Android Keyboard | Firefox | not applicable | - | 
Expectation for the combobox role: convey changes in value - applied to the input[type="text"] element
 This expectation is applied to the input[type="text"] element. Expectations and results might differ when the the feature is applied to different roles.
This expectation is from the combobox role feature.
Rationale:
The user needs to know that the value was successfully changed.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- A screen reader might announce the new value after it has been changed
Grading method:
All of the listed commands must pass for the expectation to pass.
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | Chrome | not applicable | - | 
| JAWS | Chrome | yes | is the expectation met?Output: input is echoed back ("n", "e"). "expanded" is announced when the list box is expanded.Result:  (pass)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
 | 
| JAWS | Edge | yes | is the expectation met?Output: input is echoed back ("n", "e"). "expanded" is announced when the list box is expanded.Result:  (pass)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
 | 
| JAWS | Firefox | yes | is the expectation met?Output: input is echoed back ("n", "e"). "expanded" is announced when the list box is expanded.Result:  (pass)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
 | 
| Narrator | Edge | yes | is the expectation met?Output: input is echoed back ("n", "e"). "suggestions available" is announced when the list box is expanded.Result:  (pass)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
 | 
| NVDA | Chrome | yes | is the expectation met?Output: input is echoed back ("n", "e"). "expanded" is announced when the list box is expanded.Result:  (pass)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
 | 
| NVDA | Edge | yes | is the expectation met?Output: input is echoed back ("n", "e"). "expanded" is announced when the list box is expanded.Result:  (pass)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
 | 
| NVDA | Firefox | yes | is the expectation met?Output: input is echoed back ("n", "e"). "expanded" is announced when the list box is expanded.Result:  (pass)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
 | 
| Orca | Firefox | yes | is the expectation met?Output: input is echoed back ("n", "e"). "state, editable combobox, expanded" is announced when the list box is expanded.Result:  (pass)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
 | 
| TalkBack | Chrome | yes | is the expectation met?Output: input is echoed back ("n", "e").Command Notes: list box does not expand while typing, you must expand it via the buttonResult:  (pass)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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 commandsummary: navigate forward to the comboboxUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
 | 
| Voice Access (Android) | Chrome | not applicable | - | 
| Voice Control (iOS) | Safari | not applicable | - | 
| Voice Control (MacOS) | Safari | not applicable | - | 
| VoiceOver (iOS) | Safari | yes | is the expectation met?Output: input is echoed back ("n", "e").Command Notes: nothing is announced to indicate that the list box has expanded while typingResult:  (pass)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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 commandsummary: navigate forward to the comboboxUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
 | 
| VoiceOver (macOS) | Safari | yes | is the expectation met?Output: input is echoed back ("n", "e").Command Notes: there is no indication that the listbox was expandedResult:  (pass)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
 | 
| Windows Speech Recognition | Edge | not applicable | - | 
| Windows Speech Recognition | Chrome | not applicable | - | 
| Windows Voice Access | Edge | not applicable | - | 
| Windows Voice Access | Chrome | not applicable | - | 
| 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: combobox role: convey changes in value
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | not applicable | - | 
| Dragon Naturally Speaking | Firefox | not applicable | - | 
| JAWS 2021.2011.16 | IE 11 | not applicable | is the expectation met?Output: Command Notes: example does not support IE; can't test dynamic functionalityResult: (na)Test Case: Enter text into the collapsed combobox using enter text (<enter text>)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "ne"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and the change in expanded state should be conveyedEnsure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
 | 
| Narrator | Firefox | unknown | - | 
| Narrator | Chrome | unknown | - | 
| Narrator | IE | unknown | - | 
| NVDA | IE | unknown | - | 
| TalkBack | Firefox | unknown | - | 
| Voice Access (Android) | Firefox | not applicable | - | 
| VoiceOver (iOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Firefox | unknown | - | 
| Orca | Chrome | unknown | - | 
| Voice Control (MacOS) | Chrome | not applicable | - | 
| Voice Control (MacOS) | Firefox | not applicable | - | 
| Mac Keyboard | Firefox | not applicable | - | 
| Android Keyboard | Firefox | not applicable | - | 
Expectation for the combobox role: convey that the combobox is editable - applied to the input[type="text"] element
 This expectation is applied to the input[type="text"] element. Expectations and results might differ when the the feature is applied to different roles.
This expectation is from the combobox role feature.
Rationale:
users should be made aware that they can type into a combobox. Not all comboboxes are editable.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MUST
- Voice Control: NA
Examples:
- A screen reader might convey that the combobox is editable by announcing something like "editable"
Grading method:
Just one of the listed commands must pass for the expectation to pass.
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | Chrome | not applicable | - | 
| JAWS | Chrome | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, combo, collapsed, to set the value use the arrow keys or type the value"
 | 
| JAWS | Edge | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, combo, collapsed, to set the value use the arrow keys or type the value"
 | 
| JAWS | Firefox | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, combo, collapsed, to set the value use the arrow keys or type the value"
 | 
| Narrator | Edge | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "scan off, state, combo, edit, collapsed, has popup"
 | 
| NVDA | Chrome | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, combo box, collapsed, has auto complete, editable, blank"
 | 
| NVDA | Edge | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, combo box, collapsed, has auto complete, editable, blank"
 | 
| NVDA | Firefox | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, combobox, collapsed, has auto complete, editable, blank"
 | 
| Orca | Firefox | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, editable combobox"
 | 
| TalkBack | Chrome | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next item (Swipe right (or alt+right arrow))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="combobox" aria-expanded="false"]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 commandUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "collapsed, edit box, state"
 | 
| Voice Access (Android) | Chrome | not applicable | - | 
| Voice Control (iOS) | Safari | not applicable | - | 
| Voice Control (MacOS) | Safari | not applicable | - | 
| VoiceOver (iOS) | Safari | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Next item (Swipe Right)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="combobox" aria-expanded="false"]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 commandUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "state, combobox, list box popup, collapsed, double tap to expand"Result Notes: is it implied with VO that comboboxes are editable
 | 
| VoiceOver (macOS) | Safari | yes | Result:  (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, list box popup, menu popup combobox"Result Notes: on MacOS, comboboxes are implicitly editable
 | 
| Windows Speech Recognition | Edge | not applicable | - | 
| Windows Speech Recognition | Chrome | not applicable | - | 
| Windows Voice Access | Edge | not applicable | - | 
| Windows Voice Access | Chrome | not applicable | - | 
| 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: combobox role: convey that the combobox is editable
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | not applicable | - | 
| Dragon Naturally Speaking | Firefox | not applicable | - | 
| JAWS 2021.2011.16 | IE 11 | yes | Result: (pass)Test Case: navigate forward to the collapsed combobox without a value using Read next focusable item (Tab)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="combobox" aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `*[role="combobox" aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "state, edit, type in text"
 | 
| Narrator | Firefox | unknown | - | 
| Narrator | Chrome | unknown | - | 
| Narrator | IE | unknown | - | 
| NVDA | IE | unknown | - | 
| TalkBack | Firefox | unknown | - | 
| Voice Access (Android) | Firefox | not applicable | - | 
| VoiceOver (iOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Firefox | unknown | - | 
| Orca | Chrome | unknown | - | 
| Voice Control (MacOS) | Chrome | not applicable | - | 
| Voice Control (MacOS) | Firefox | not applicable | - | 
| Mac Keyboard | Firefox | not applicable | - | 
| Android Keyboard | Firefox | not applicable | - | 
Expectation for the listbox role: convey its name
This expectation is from the listbox 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: NA
Examples:
- A screen reader might convey the name when entering the listbox
Grading method:
Just one of the listed commands must pass for the expectation to pass.
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | Chrome | unknown | - | 
| JAWS | Chrome | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska, 1 of 6, to move to an item press the arrow keys"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| JAWS | Edge | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska, 1 of 6, to move to an item press the arrow keys"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| JAWS | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska, 1 of 6, to move to an item press the arrow keys"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Narrator | Edge | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "scan, states, nebraska, 1 of 6, selected"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Chrome | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states, list, nebraska, 1 of 6"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Edge | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states, list, nebraska, 1 of 6"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list, nebraska, 1 of 6"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Orca | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| TalkBack | Chrome | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using Select next option (Swipe right)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="listbox"]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 commandsummary: navigate forward to the comboboxUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
 is the expectation met?Output: "states, list box" (swipe right again) "end of example, splitter"summary: navigate into the listboxUsing the command: "Swipe right" (Select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`virtual cursor location: within target
 | 
| Voice Access (Android) | Chrome | unknown | - | 
| Voice Control (iOS) | Safari | unknown | - | 
| Voice Control (MacOS) | Safari | unknown | - | 
| VoiceOver (iOS) | Safari | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Swipe down)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="listbox"]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 commandsummary: navigate forward to the comboboxUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
 is the expectation met?Output: "states, nebraska, list start"summary: navigate into the listboxUsing the command: "Swipe down" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`virtual cursor location: within target
 | 
| VoiceOver (macOS) | Safari | yes | issue commandResult:  (pass)Test Case: Navigate to the listbox container from an option using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 issue commandsummary: move to the first optionUsing the command: "Down arrow" (select next option)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: out of states, list box, one item selected, nevada selected, 2 of 6summary: navigate to the listbox containerUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Windows Speech Recognition | Edge | unknown | - | 
| Windows Speech Recognition | Chrome | unknown | - | 
| 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: listbox role: convey its name
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | unknown | - | 
| Dragon Naturally Speaking | Firefox | unknown | - | 
| JAWS 2021.2011.16 | IE 11 | not applicable | issue commandResult: (na)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: Command Notes: example does not support IE; can't test dynamic functionalitysummary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| 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 listbox role: convey its role
This expectation is from the listbox 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: NA
Examples:
- A screen reader might explicitly convey the role as something like "list box", "list", or imply it by explicitly conveying "option" roles
Grading method:
Just one of the listed commands must pass for the expectation to pass.
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | Chrome | unknown | - | 
| JAWS | Chrome | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska, 1 of 6, to move to an item press the arrow keys"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| JAWS | Edge | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska, 1 of 6, to move to an item press the arrow keys"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| JAWS | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska, 1 of 6, to move to an item press the arrow keys"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Narrator | Edge | none | issue commandResult:  (fail)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "scan, states, nebraska, 1 of 6, selected"Result Notes: combobox can open a list or grid, so the role is importantGrading note: This command may be expected to fail. This result simply indicates that it did not yield support.Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Chrome | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states, list, nebraska, 1 of 6"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Edge | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states, list, nebraska, 1 of 6"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list, nebraska, 1 of 6"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Orca | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| TalkBack | Chrome | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using Select next option (Swipe right)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="listbox"]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 commandsummary: navigate forward to the comboboxUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
 is the expectation met?Output: "states, list box" (swipe right again) "end of example, splitter"summary: navigate into the listboxUsing the command: "Swipe right" (Select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`virtual cursor location: within target
 | 
| Voice Access (Android) | Chrome | unknown | - | 
| Voice Control (iOS) | Safari | not applicable | - | 
| Voice Control (MacOS) | Safari | unknown | - | 
| VoiceOver (iOS) | Safari | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Swipe down)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="listbox"]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 commandsummary: navigate forward to the comboboxUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
 is the expectation met?Output: "states, nebraska, list start"summary: navigate into the listboxUsing the command: "Swipe down" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`virtual cursor location: within target
 | 
| VoiceOver (macOS) | Safari | yes | issue commandResult:  (pass)Test Case: Navigate to the listbox container from an option using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 issue commandsummary: move to the first optionUsing the command: "Down arrow" (select next option)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: out of states, list box, one item selected, nevada selected, 2 of 6summary: navigate to the listbox containerUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Windows Speech Recognition | Edge | unknown | - | 
| Windows Speech Recognition | Chrome | unknown | - | 
| 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: listbox role: convey its role
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | unknown | - | 
| Dragon Naturally Speaking | Firefox | unknown | - | 
| JAWS 2021.2011.16 | IE 11 | not applicable | issue commandResult: (na)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: Command Notes: example does not support IE; can't test dynamic functionalitysummary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| 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 listbox role: convey its boundaries
This expectation is from the listbox role feature.
Rationale:
The user needs to know when they enter and leave the listbox.
Strength of this expectation for different types of assistive technologies:
- Screen Readers: SHOULD
- Voice Control: NA
Examples:
- A screen reader might convey the listbox name and role when entering, and something like "out of list" when exiting
- A screen reader might convey information about the position in the options, such as "4 of 4" to indicate the start and end of the options
Grading method:
All of the listed commands must pass for the expectation to pass.
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | Chrome | not applicable | - | 
| JAWS | Chrome | yes | issue commandResult:  (pass)Test Case: Navigate through listbox using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: each option was conveyed. After last option was conveyed, focus was looped back to the first option.Result Notes: boundaries implied by position in set informationsummary: navigate through all options in the listboxUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| JAWS | Edge | yes | issue commandResult:  (pass)Test Case: Navigate through listbox using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: each option was conveyed. After last option was conveyed, focus was looped back to the first option.Result Notes: boundaries implied by position in set informationsummary: navigate through all options in the listboxUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| JAWS | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate through listbox using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: each option was conveyed. After last option was conveyed, focus was looped back to the first option.Result Notes: boundaries implied by position in set informationsummary: navigate through all options in the listboxUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Narrator | Edge | yes | issue commandResult:  (pass)Test Case: Navigate through listbox using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: each option was conveyed. After last option was conveyed, the cursor exited the listbox, but the end boundary was conveyed.Result Notes: boundaries implied by position in set informationsummary: navigate through all options in the listboxUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Chrome | yes | issue commandResult:  (pass)Test Case: Navigate through listbox using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: each option was conveyed. After last option was conveyed, focus was looped back to the first option.Result Notes: boundaries implied by position in set informationsummary: navigate through all options in the listboxUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Edge | yes | issue commandResult:  (pass)Test Case: Navigate through listbox using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: each option was conveyed. After last option was conveyed, focus was looped back to the first option.Result Notes: boundaries implied by position in set informationsummary: navigate through all options in the listboxUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate through listbox using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: each option was conveyed. After last option was conveyed, focus was looped back to the first option.Result Notes: boundaries implied by position in set informationsummary: navigate through all options in the listboxUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Orca | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate through listbox using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: each option was conveyed. After last option was conveyed, focus was looped back to the first option.Result Notes: boundaries implied by focus management (loop back to first option)summary: navigate through all options in the listboxUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| TalkBack | Chrome | yes | issue commandResult:  (pass)Test Case: Navigate through listbox using Select next option (Swipe right)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="listbox"]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 commandsummary: navigate forward to the comboboxUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
 is the expectation met?Output: all options were skippedResult Notes: boundaries implied starting role. It was not possible to navigate within.summary: navigate through all options in the listboxUsing the command: "Swipe right" (Select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`virtual cursor location: within target
 | 
| Voice Access (Android) | Chrome | not applicable | - | 
| Voice Control (iOS) | Safari | not applicable | - | 
| Voice Control (MacOS) | Safari | not applicable | - | 
| VoiceOver (iOS) | Safari | yes | issue commandResult:  (pass)Test Case: Navigate through listbox using select next option (Swipe down)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="listbox"]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 commandsummary: navigate forward to the comboboxUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
 is the expectation met?Output: new york, list endsummary: navigate through all options in the listboxUsing the command: "Swipe down" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`virtual cursor location: within target
 | 
| VoiceOver (macOS) | Safari | none | issue commandResult:  (fail)Test Case: Navigate through listbox using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: contents of listbox were skipped entirelyGrading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.summary: navigate through all options in the listboxUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Windows Speech Recognition | Edge | not applicable | - | 
| Windows Speech Recognition | Chrome | not applicable | - | 
| Windows Voice Access | Edge | not applicable | - | 
| Windows Voice Access | Chrome | not applicable | - | 
| 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: listbox role: convey its boundaries
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | not applicable | - | 
| Dragon Naturally Speaking | Firefox | not applicable | - | 
| JAWS 2021.2011.16 | IE 11 | not applicable | issue commandResult: (na)Test Case: Navigate through listbox using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: Command Notes: example does not support IE; can't test dynamic functionalitysummary: navigate through all options in the listboxUsing the command: "Down arrow" (select next option)You may need to issue this command multiple timesObserve: are the start and end boundaries of the listbox conveyed?Ensure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Narrator | Firefox | unknown | - | 
| Narrator | Chrome | unknown | - | 
| Narrator | IE | unknown | - | 
| NVDA | IE | unknown | - | 
| TalkBack | Firefox | unknown | - | 
| Voice Access (Android) | Firefox | not applicable | - | 
| VoiceOver (iOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Firefox | unknown | - | 
| Orca | Chrome | unknown | - | 
| Voice Control (MacOS) | Chrome | not applicable | - | 
| Voice Control (MacOS) | Firefox | not applicable | - | 
| Mac Keyboard | Firefox | not applicable | - | 
| Android Keyboard | Firefox | not applicable | - | 
Expectation for the option role: convey its name
This expectation is from the option 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
Examples:
- A screen reader will announce the name of the option
- Voice control software will let the user say something like "choose <name>".
Grading method:
Just one of the listed commands must pass for the expectation to pass.
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | Chrome | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)Test Case: Use "Choose <option text>" (Choose drop down option)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="option"]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: "Choose <option text>"(Choose drop down option)Record results for the relevant expectations
Output: text of command was entered into the text inputCommand Notes: said "choose alaska"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
Result:  (fail)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="option"]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: text of command was entered into the text inputCommand Notes: said "click alaska"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| JAWS | Chrome | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska, 1 of 6, to move to an item press the arrow keys"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| JAWS | Edge | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska, 1 of 6, to move to an item press the arrow keys"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| JAWS | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska, 1 of 6, to move to an item press the arrow keys"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Narrator | Edge | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "scan, states, nebraska, 1 of 6, selected"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Chrome | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states, list, nebraska, 1 of 6"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Edge | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states, list, nebraska, 1 of 6"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list, nebraska, 1 of 6"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Orca | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| TalkBack | Chrome | none | issue commandResult:  (fail)Test Case: Navigate into listbox from the combobox input using Select next option (Swipe right)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="listbox"]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 commandsummary: navigate forward to the comboboxUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
 is the expectation met?Output: "states, list box" (swipe right again) "end of example, splitter"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.summary: navigate into the listboxUsing the command: "Swipe right" (Select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`virtual cursor location: within target
 | 
| 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="option"]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: option was activatedCommand Notes: said "tap alaska"
 | 
| 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="option"]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: names were listed for optionsCommand Notes: said "show names"
 | 
| Voice Control (MacOS) | Safari | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)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="option"]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: option was not activatedCommand Notes: said "click alaska"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| VoiceOver (iOS) | Safari | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Swipe down)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="listbox"]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 commandsummary: navigate forward to the comboboxUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
 is the expectation met?Output: "states, nebraska, list start"summary: navigate into the listboxUsing the command: "Swipe down" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`virtual cursor location: within target
 | 
| VoiceOver (macOS) | Safari | none | issue commandResult:  (fail)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: nothing was conveyedGrading note: This command may be expected to fail. This result simply indicates that it did not yield support.Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| 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="option"]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 activatedCommand Notes: said "click alaska"
 | 
| 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="option"]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 activatedCommand Notes: said "click alaska"
 | 
| Windows Voice Access | Edge | yes | Result:  (pass)Test Case: Use "Click <text>" (Activate item by name)Launch Windows Voice Access 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="option"]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 activatedCommand Notes: said "click alaska"
 | 
| Windows Voice Access | Chrome | yes | Result:  (pass)Test Case: Use "Click <text>" (Activate item by name)Launch Windows Voice Access 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="option"]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 activatedCommand Notes: said "click alaska"
 | 
| 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: option role: convey its name
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | unknown | - | 
| Dragon Naturally Speaking | Firefox | unknown | - | 
| JAWS 2021.2011.16 | IE 11 | not applicable | issue commandResult: (na)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: Command Notes: example does not support IE; can't test dynamic functionalitysummary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| 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 option role: convey its role
This expectation is from the option 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 "option" as the role.
- A screen reader might not announce a role because the role is implied by the role of a listbox parent.
- Voice control software will let the user say something like "move down <n>" or "move up <n>" to select an option.
Grading method:
Just one of the listed commands must pass for the expectation to pass.
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | Chrome | not applicable | Result:  (na)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="option"]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: Command Notes: na because there is not a specific command for the option role
 | 
| JAWS | Chrome | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska, 1 of 6, to move to an item press the arrow keys"Result Notes: implied by listbox contextsummary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| JAWS | Edge | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska, 1 of 6, to move to an item press the arrow keys"Result Notes: implied by listbox contextsummary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| JAWS | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska, 1 of 6, to move to an item press the arrow keys"Result Notes: implied by listbox contextsummary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Narrator | Edge | none | issue commandResult:  (fail)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "scan, states, nebraska, 1 of 6, selected"Result Notes: not implied by listbox context since the listbox role is not conveyed. Could be an option or a grid cell.Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Chrome | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states, list, nebraska, 1 of 6"Result Notes: implied by listbox contextsummary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Edge | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states, list, nebraska, 1 of 6"Result Notes: implied by listbox contextsummary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list, nebraska, 1 of 6"Result Notes: implied by listbox contextsummary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Orca | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska"Result Notes: implied by listbox contextsummary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| TalkBack | Chrome | none | issue commandResult:  (fail)Test Case: Navigate into listbox from the combobox input using Select next option (Swipe right)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="listbox"]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 commandsummary: navigate forward to the comboboxUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
 is the expectation met?Output: "states, list box" (swipe right again) "end of example, splitter"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.summary: navigate into the listboxUsing the command: "Swipe right" (Select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`virtual cursor location: within target
 | 
| Voice Access (Android) | Chrome | yes | Result:  (pass)Test Case: Use "Show numbers" (Turn on the numbers overlay)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="option"]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: options were flagged with a numberCommand Notes: said "show numbers"
 | 
| Voice Control (iOS) | Safari | not applicable | - | 
| Voice Control (MacOS) | Safari | none | Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.Result:  (fail)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="option"]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 not flagged with a numberCommand Notes: said "show numbers"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.
 | 
| VoiceOver (iOS) | Safari | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Swipe down)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="listbox"]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 commandsummary: navigate forward to the comboboxUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
 is the expectation met?Output: "states, nebraska, list start"Result Notes: implied by listbox contextsummary: navigate into the listboxUsing the command: "Swipe down" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`virtual cursor location: within target
 | 
| VoiceOver (macOS) | Safari | none | issue commandResult:  (fail)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: nothing was conveyedGrading note: This command may be expected to fail. This result simply indicates that it did not yield support.Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| 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="option"]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 numberCommand 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="option"]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 numberCommand Notes: said "show numbers"
 | 
| Windows Voice Access | Edge | yes | Result:  (pass)Test Case: Use "Show numbers" (Turn on the numbers overlay)Launch Windows Voice Access 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="option"]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 numberCommand Notes: said "show numbers"
 | 
| Windows Voice Access | Chrome | yes | Result:  (pass)Test Case: Use "Show numbers" (Turn on the numbers overlay)Launch Windows Voice Access 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="option"]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 numberCommand Notes: said "show numbers"
 | 
| 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: option role: convey its role
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | unknown | - | 
| Dragon Naturally Speaking | Firefox | unknown | - | 
| JAWS 2021.2011.16 | IE 11 | not applicable | issue commandResult: (na)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: Command Notes: example does not support IE; can't test dynamic functionalitysummary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| 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 option role: convey information about the position the option in the list
This expectation is from the option role feature.
Rationale:
users should be able to determine how many options are in the list and where they are in the list
Strength of this expectation for different types of assistive technologies:
- Screen Readers: MAY
- Voice Control: NA
Examples:
- A screen reader might announce "choose <2 of 10>" when navigating through a list of options
Grading method:
Just one of the listed commands must pass for the expectation to pass.
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | Chrome | not applicable | - | 
| JAWS | Chrome | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska, 1 of 6, to move to an item press the arrow keys"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| JAWS | Edge | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska, 1 of 6, to move to an item press the arrow keys"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| JAWS | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska, 1 of 6, to move to an item press the arrow keys"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Narrator | Edge | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "scan, states, nebraska, 1 of 6, selected"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Chrome | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states, list, nebraska, 1 of 6"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Edge | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states, list, nebraska, 1 of 6"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| NVDA | Firefox | yes | issue commandResult:  (pass)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list, nebraska, 1 of 6"summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Orca | Firefox | none | issue commandResult:  (fail)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: "states list with 6 items, nebraska"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| TalkBack | Chrome | none | issue commandResult:  (fail)Test Case: Navigate into listbox from the combobox input using Select next option (Swipe right)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="listbox"]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 commandsummary: navigate forward to the comboboxUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
 is the expectation met?Output: "states, list box" (swipe right again) "end of example, splitter"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.summary: navigate into the listboxUsing the command: "Swipe right" (Select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`virtual cursor location: within target
 | 
| Voice Access (Android) | Chrome | not applicable | - | 
| Voice Control (iOS) | Safari | not applicable | - | 
| Voice Control (MacOS) | Safari | not applicable | - | 
| VoiceOver (iOS) | Safari | none | issue commandResult:  (fail)Test Case: Navigate into listbox from the combobox input using select next option (Swipe down)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="listbox"]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 commandsummary: navigate forward to the comboboxUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`virtual cursor location: target
 is the expectation met?Output: "states, nebraska, list start"Grading note: This command may be expected to fail. This result simply indicates that it did not yield support.Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.summary: navigate into the listboxUsing the command: "Swipe down" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`virtual cursor location: within target
 | 
| VoiceOver (macOS) | Safari | none | issue commandResult:  (fail)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: nothing was conveyedGrading note: This command may be expected to fail. This result simply indicates that it did not yield support.Grading Note: There is no known/documented support. There may still be support for this expectation, but it is undocumented. If this is the case, please report this issue.summary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Windows Speech Recognition | Edge | not applicable | - | 
| Windows Speech Recognition | Chrome | not applicable | - | 
| Windows Voice Access | Edge | not applicable | - | 
| Windows Voice Access | Chrome | not applicable | - | 
| 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: option role: convey information about the position the option in the list
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | not applicable | - | 
| Dragon Naturally Speaking | Firefox | not applicable | - | 
| JAWS 2021.2011.16 | IE 11 | not applicable | issue commandResult: (na)Test Case: Navigate into listbox from the combobox input using select next option (Down arrow)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="listbox"]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.
set mode to auto (do not explicitly change the mode)issue commandsummary: navigate forward to the comboboxUsing the command: "Tab" (Read next focusable item)Ensure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
issue commandsummary: type "nebr"Using the command: "<enter text>" (enter text)Observe: the combo box should expand and listbox should displayEnsure AT location after executing the commandTarget: `[role="combobox"]`keyboard focus location: targetvirtual cursor location: target
 is the expectation met?Output: Command Notes: example does not support IE; can't test dynamic functionalitysummary: navigate into the listboxUsing the command: "Down arrow" (select next option)Observe: the listbox role and name should be conveyedEnsure AT location after executing the commandTarget: `*[role="listbox"]`keyboard focus location: within targetvirtual cursor location: within target
 | 
| Narrator | Firefox | unknown | - | 
| Narrator | Chrome | unknown | - | 
| Narrator | IE | unknown | - | 
| NVDA | IE | unknown | - | 
| TalkBack | Firefox | unknown | - | 
| Voice Access (Android) | Firefox | not applicable | - | 
| VoiceOver (iOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Chrome | unknown | - | 
| VoiceOver (macOS) | Firefox | unknown | - | 
| Orca | Chrome | unknown | - | 
| Voice Control (MacOS) | Chrome | not applicable | - | 
| Voice Control (MacOS) | Firefox | not applicable | - | 
| Mac Keyboard | Firefox | not applicable | - | 
| Android Keyboard | Firefox | not applicable | - | 
This expectation is from the button element 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
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.
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:button[tabindex=-1]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 activatedCommand Notes: said "click states"
 | 
| JAWS | Chrome | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| JAWS | Edge | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| JAWS | Firefox | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| Narrator | Edge | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| NVDA | Chrome | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| NVDA | Edge | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| NVDA | Firefox | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| Orca | Firefox | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, collapsed, push button"
 | 
| TalkBack | Chrome | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Read next item (Swipe right (or alt+right arrow))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:button[aria-expanded="false"]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 commandUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "collapsed, states, button"
 | 
| 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:button[tabindex=-1]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 activatedCommand Notes: said "tap states"
 | 
| 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:button[tabindex=-1]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 activatedCommand Notes: said "tap states"
 | 
| 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:button[tabindex=-1]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 activatedCommand Notes: said "tap states"
 | 
| VoiceOver (iOS) | Safari | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next item (Swipe Right)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:button[aria-expanded="false"]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 commandUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "states, button collapsed, double tap to expand"
 | 
| VoiceOver (macOS) | Safari | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Read next item (VO + Right arrow)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "VO + Right arrow" (Read next item)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| 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:button[tabindex=-1]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 activatedCommand Notes: said "click states"
 | 
| 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:button[tabindex=-1]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 activatedCommand Notes: said "click states"
 | 
| Windows Voice Access | Edge | yes | Result:  (pass)Test Case: Use "Click <text>" (Activate item by name)Launch Windows Voice Access and Edge.Navigate to the test page.Find the target element(s) that you will test against. Identify all elements that match this selector:button[tabindex=-1]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 activatedCommand Notes: said "click states"
 | 
| Windows Voice Access | Chrome | yes | Result:  (pass)Test Case: Use "Click <text>" (Activate item by name)Launch Windows Voice Access and Chrome.Navigate to the test page.Find the target element(s) that you will test against. Identify all elements that match this selector:button[tabindex=-1]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 activatedCommand Notes: said "click states"
 | 
| 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 element: convey its name
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | unknown | - | 
| Dragon Naturally Speaking | Firefox | unknown | - | 
| JAWS 2021.2011.16 | IE 11 | yes | Result: (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, button collapsed"
 | 
| 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 | - | 
This expectation is from the button element 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 be announce the role as something like "button".
- Voice control software will let the user say something like "click button".
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:button[tabindex=-1]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: button was flaggedCommand Notes: said "click button"
 | 
| JAWS | Chrome | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| JAWS | Edge | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| JAWS | Firefox | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| Narrator | Edge | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| NVDA | Chrome | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| NVDA | Edge | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| NVDA | Firefox | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| Orca | Firefox | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, collapsed, push button"
 | 
| TalkBack | Chrome | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Read next item (Swipe right (or alt+right arrow))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:button[aria-expanded="false"]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 commandUsing the command: "Swipe right (or alt+right arrow)" (Read next item)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "collapsed, states, button"
 | 
| Voice Access (Android) | Chrome | yes | Result:  (pass)Test Case: Use "Show numbers" (Turn on the numbers overlay)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:button[tabindex=-1]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: button was flaggedCommand Notes: said "show numbers"
 | 
| 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:button[tabindex=-1]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: button was flaggedCommand Notes: said "show numbers"
 | 
| VoiceOver (iOS) | Safari | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next item (Swipe Right)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:button[aria-expanded="false"]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 commandUsing the command: "Swipe Right" (Next item)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`virtual cursor location: target
is the expectation met?Output: "states, button collapsed, double tap to expand"
 | 
| VoiceOver (macOS) | Safari | yes | Result:  (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Read next item (VO + Right arrow)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "VO + Right arrow" (Read next item)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states button collapsed"
 | 
| 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:button[tabindex=-1]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: button was flaggedCommand 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:button[tabindex=-1]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: button was flaggedCommand Notes: said "show numbers"
 | 
| Windows Voice Access | Edge | yes | Result:  (pass)Test Case: Use "Show numbers" (Turn on the numbers overlay)Launch Windows Voice Access and Edge.Navigate to the test page.Find the target element(s) that you will test against. Identify all elements that match this selector:button[tabindex=-1]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: button was flaggedCommand Notes: said "show numbers"
 | 
| Windows Voice Access | Chrome | yes | Result:  (pass)Test Case: Use "Show numbers" (Turn on the numbers overlay)Launch Windows Voice Access and Chrome.Navigate to the test page.Find the target element(s) that you will test against. Identify all elements that match this selector:button[tabindex=-1]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: button was flaggedCommand Notes: said "show numbers"
 | 
| 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 element: convey its role
These are less common combinations
| AT | Browser | Has Support | Output | 
|---|
| Dragon Naturally Speaking | IE | unknown | - | 
| Dragon Naturally Speaking | Firefox | unknown | - | 
| JAWS 2021.2011.16 | IE 11 | yes | Result: (pass)Test Case: navigate forward to the button for the collapsed combobox without a value using Next button (b)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:button[aria-expanded="false"]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.
set mode to auto (do not explicitly change the mode)issue commandUsing the command: "b" (Next button)Ensure AT location after executing the commandTarget: `button[aria-expanded="false"]`keyboard focus location: targetvirtual cursor location: target
is the expectation met?Output: "states, button collapsed"
 | 
| 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 | 16.0 | Chrome | 116 | Windows 11 version 22H2 | 2023-08-22 | 
| JAWS | 2023.2307.37 | Chrome | 116 | Windows 11 version 22h2 | 2023-08-22 | 
| JAWS | 2023.2307.37 | Edge | 115 | Windows 11 version 22h2 | 2023-08-22 | 
| JAWS | 2023.2307.37 | Firefox | 116 | Windows 11 version 22h2 | 2023-08-22 | 
| Narrator | Windows 11 version 22h2 | Edge | 115 | Windows 11 version 22h2 | 2023-08-22 | 
| NVDA | 2023.1 | Chrome | 116 | Windows 11 version 22h2 | 2023-08-22 | 
| NVDA | 2024.3 | Edge | 130.0.2849.27 | Windows 11 version 23h2 | 2024-10-08 | 
| NVDA | 2023.1 | Firefox | 116 | Windows 11 version 22h2 | 2023-08-22 | 
| Orca | 44.0 | Firefox | 115 | Ubuntu 23.04 | 2023-08-22 | 
| TalkBack | 13.5 | Chrome | 116 | 13 | 2023-08-22 | 
| Voice Access (Android) | 6.1 | Chrome | 116 | 13 | 2023-08-22 | 
| Voice Control (iOS) | 16.6 | Safari | 16.6 | 16.6 | 2023-08-22 | 
| Voice Control (MacOS) | 13.5 | Safari | 16.6 | 13.5 | 2023-08-22 | 
| VoiceOver (iOS) | 16.6 | Safari | 16.6 | 16.6 | 2023-08-22 | 
| VoiceOver (macOS) | 13.5 | Safari | 16.6 | 13.5 | 2023-08-22 | 
| Windows Speech Recognition | Windows 11 version 22H2 | Edge | 116 | Windows 11 version 22H2 | 2023-08-22 | 
| Windows Speech Recognition | Windows 11 version 22H2 | Chrome | 116 | Windows 11 version 22H2 | 2023-08-22 | 
| Windows Voice Access | Windows 11 version 22H2 | Edge | 116 | Windows 11 version 22H2 | 2023-08-22 | 
| Windows Voice Access | Windows 11 version 22H2 | Chrome | 116 | Windows 11 version 22H2 | 2023-08-22 | 
History
- 2020-10-09 Test created
- 2021-08-07 Added Narrator results for NVDA and JAWS, updated NVDA+Chrome results.
- 2021-11-10 Updated VoiceOver tests to illustrate a bug where aria-activedescendant is not respected when the combobox input has no value.
- 2023-08-22 Updated results. Support was largely similar to when it was last tested, except that both VoiceOver for MacOS and Talkback for Android appear to have lost support for options within a listbox.
- 2025-08-15 Updated NVDA+Edge version.