Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create updated tests for APG design pattern example: Editable Combobox With Both List and Inline Autocomplete #340

Closed
IsaDC opened this issue Nov 20, 2020 · 4 comments · Fixed by #355

Comments

@IsaDC
Copy link
Contributor

IsaDC commented Nov 20, 2020

Applies To

Testing Notes

This issue thread will house all documentation relating to the development of a test plan for the "Editable Combobox With Both List and Inline Autocomplete" APG example, which conforms to the "Combobox" design pattern. All follow-ups (including the test plan itself) will be added as new comments to facilitate notifications, but this initial comment will be updated with relevant details and URLs as needed for convenience.

Additional References

@jscholes
Copy link
Contributor

This is a thread for the updated version of this test plan, first started back in February by Matt (ref: #53).

@jscholes jscholes changed the title Create tests for APG design pattern example: Editable Combobox With Both List and Inline Autocomplete Create updated tests for APG design pattern example: Editable Combobox With Both List and Inline Autocomplete Nov 20, 2020
@IsaDC
Copy link
Contributor Author

IsaDC commented Nov 30, 2020

Below is the test plan for the Editable Combobox With Both List and Inline Autocomplete example. Note that the "States" button is not tested at this time; it is believed to only be useful for those operating touch-based devices and we don't yet have infrastructure in place for testing touch gestures.

Each test title is marked up as a level 4 heading to facilitate screen reader navigation.

Navigate forwards to an empty, collapsed combobox in reading mode

  • Applies to: JAWS, NVDA
  • Mode: reading
  • Instructions: Navigate to the Combobox. Note: it should be in the collapsed state. You may need to press certain commands (such as Down Arrow) multiple times to hear all information relating to the combobox.
  • Commands:
    • F
    • E
    • C
    • Tab
    • Down Arrow
  • Setup script description: sets focus on a link before the Combobox
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (collapsed) is conveyed required aria-expanded="false"
The ability to enter or edit text is conveyed required input[type="text"]
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Navigate backwards to an empty, collapsed combobox in reading mode

  • Applies to: JAWS, NVDA
  • Mode: reading
  • Instructions: Navigate to the Combobox. Note: it should be in the collapsed state. You may need to press certain commands (such as Up Arrow) multiple times to hear all information relating to the combobox.
  • Commands:
    • Shift+F
    • Shift+E
    • Shift+C
    • Shift+Tab
    • Up Arrow
  • Setup script description: sets focus on a link after the Combobox
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (collapsed) is conveyed required aria-expanded="false"
The ability to enter or edit text is conveyed required input[type="text"]
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Navigate forwards to an empty, collapsed combobox in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: Navigate to the Combobox. Note: it should be in the collapsed state.
  • Commands:
    • Tab
  • Setup script description: sets focus on a link before the Combobox
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (collapsed) is conveyed required aria-expanded="false"
The ability to enter or edit text is conveyed required input[type="text"]
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Navigate backwards to an empty, collapsed combobox in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: Navigate to the Combobox. Note: it should be in the collapsed state.
  • Commands:
    • Shift+Tab
  • Setup script description: sets focus on a link after the Combobox
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (collapsed) is conveyed required aria-expanded="false"
The ability to enter or edit text is conveyed required input[type="text"]
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Navigate forwards to an empty, collapsed combobox

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: Navigate to the Combobox. Note: it should be in the collapsed state. You may need to press certain commands (such as Control+Option+Right) multiple times to hear all information relating to the combobox.
  • Commands:
    • Control+Option+Right
    • Tab
    • Control+Option+Command+J
  • Setup script description: sets focus on a link before the Combobox
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (collapsed) is conveyed required aria-expanded="false"
The ability to enter or edit text is conveyed required input[type="text"]
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Navigate backwards to an empty, collapsed combobox

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: Navigate to the Combobox. Note: it should be in the collapsed state. You may need to press certain commands (such as Control+Option+Left) multiple times to hear all information relating to the combobox.
  • Commands:
    • Control+Option+left
    • Shift+Tab
    • Shift+Control+Option+Command+J
  • Setup script description: sets focus on a link after the Combobox
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (collapsed) is conveyed required aria-expanded="false"
The ability to enter or edit text is conveyed required input[type="text"]
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Read information about an empty, collapsed combobox in reading mode

  • Applies to: JAWS, NVDA
  • Mode: reading
  • Instructions: With the reading cursor on the combobox, read information about the combobox.
  • Commands:
    • Insert+Tab
    • Insert+Up
  • Setup script description: sets focus on the Combobox
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (collapsed) is conveyed required aria-expanded="false"
The ability to enter or edit text is conveyed required input[type="text"]
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Read information about an empty, collapsed combobox in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on the combobox, read information about the combobox.
  • Commands:
    • Insert+Tab
  • Setup script description: sets focus on the Combobox
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (collapsed) is conveyed required aria-expanded="false"
The ability to enter or edit text is conveyed required input[type="text"]
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Read information about an empty, collapsed combobox

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on the combobox, read information about the combobox.
  • Commands:
    • Control+Option+F3
    • Control+Option+F4
  • Setup script description: sets focus on the Combobox
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (collapsed) is conveyed required aria-expanded="false"
The ability to enter or edit text is conveyed required input[type="text"]
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Navigate forwards to a filled in, collapsed combobox in reading mode

  • Applies to: JAWS, NVDA
  • Mode: reading
  • Instructions: Navigate to the Combobox. Note: it should be in the collapsed state. You may need to press certain commands (such as Down Arrow) multiple times to hear all information relating to the combobox.
  • Commands:
    • F
    • E
    • C
    • Tab
    • Down Arrow
  • Setup script description: sets focus on a link before the Combobox, and sets the combobox value to 'Alabama'
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (collapsed) is conveyed required aria-expanded="false"
Text of the selected option ('Alabama') is conveyed required Value of <input> element with role="combobox"
The ability to enter or edit text is conveyed required input[type="text"]
State of the text in the input (selected) is conveyed required Default browser behavior
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Navigate backwards to a filled in, collapsed combobox in reading mode

  • Applies to: JAWS, NVDA
  • Mode: reading
  • Instructions: Navigate to the Combobox. Note: it should be in the collapsed state. You may need to press certain commands (such as Up Arrow) multiple times to hear all information relating to the combobox.
  • Commands:
    • Shift+F
    • Shift+E
    • Shift+C
    • Shift+Tab
    • Up Arrow
  • Setup script description: sets focus on a link after the Combobox, and sets the combobox value to 'Alabama'
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (collapsed) is conveyed required aria-expanded="false"
Text of the selected option ('Alabama') is conveyed required Value of <input> element with role="combobox"
The ability to enter or edit text is conveyed required input[type="text"]
State of the text in the input (selected) is conveyed required Default browser behavior
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Navigate forwards to a filled in, collapsed combobox in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: Navigate to the Combobox. Note: it should be in the collapsed state.
  • Commands:
    • Tab
  • Setup script description: sets focus on a link before the Combobox, and sets the combobox value to 'Alabama'
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (collapsed) is conveyed required aria-expanded="false"
Text of the selected option ('Alabama') is conveyed required Value of <input> element with role="combobox"
The ability to enter or edit text is conveyed required input[type="text"]
State of the text in the input (selected) is conveyed required Default browser behavior
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Navigate backwards to a filled in, collapsed combobox in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: Navigate to the Combobox. Note: it should be in the collapsed state.
  • Commands:
    • Shift+Tab
  • Setup script description: sets focus on a link after the Combobox, and sets the combobox value to 'Alabama'
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (collapsed) is conveyed required aria-expanded="false"
Text of the selected option ('Alabama') is conveyed required Value of <input> element with role="combobox"
The ability to enter or edit text is conveyed required input[type="text"]
State of the text in the input (selected) is conveyed required Default browser behavior
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Navigate forwards to a filled in, collapsed combobox

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: Navigate to the Combobox. Note: it should be in the collapsed state. You may need to press certain commands (such as Control+Option+Right) multiple times to hear all information relating to the combobox.
  • Commands:
    • Control+Option+Right
    • Tab
    • Control+Option+Command+J
  • Setup script description: sets focus on a link before the Combobox, and sets the combobox value to 'Alabama'
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (collapsed) is conveyed required aria-expanded="false"
Text of the selected option ('Alabama') is conveyed required Value of <input> element with role="combobox"
The ability to enter or edit text is conveyed required input[type="text"]
State of the text in the input (selected) is conveyed required Default browser behavior
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Navigate backwards to a filled in, collapsed combobox

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: Navigate to the Combobox. Note: it should be in the collapsed state. You may need to press certain commands (such as Control+Option+Left) multiple times to hear all information relating to the combobox.
  • Commands:
    • Control+Option+Left
    • Shift+Tab
    • Shift+Control+Option+Command+J
  • Setup script description: sets focus on a link after the Combobox, and sets the combobox value to 'Alabama'
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (collapsed) is conveyed required aria-expanded="false"
Text of the selected option ('Alabama') is conveyed required Value of <input> element with role="combobox"
The ability to enter or edit text is conveyed required input[type="text"]
State of the text in the input (selected) is conveyed required Default browser behavior
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Read information about a filled in, collapsed combobox in reading mode

  • Applies to: JAWS, NVDA
  • Mode: reading
  • Instructions: With the reading cursor on the combobox, read information about the combobox.
  • Commands:
    • Insert+Tab
    • Insert+Up
  • Setup script description: sets focus on the Combobox, and sets the combobox value to 'Alabama'
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (collapsed) is conveyed required aria-expanded="false"
Text of the selected option ('Alabama') is conveyed required Value of <input> element with role="combobox"
The ability to enter or edit text is conveyed required input[type="text"]
State of the text in the input (selected) is conveyed required Default browser behavior
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Read information about a filled in, collapsed combobox in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on the combobox, read information about the combobox.
  • Commands:
    • Insert+Tab
  • Setup script description: sets focus on the Combobox, and sets the combobox value to 'Alabama'
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (collapsed) is conveyed required aria-expanded="false"
Text of the selected option ('Alabama') is conveyed required Value of <input> element with role="combobox"
The ability to enter or edit text is conveyed required input[type="text"]
State of the text in the input (selected) is conveyed required Default browser behavior
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Read information about a filled in, collapsed combobox

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on the combobox, read information about the combobox.
  • Commands:
    • Control+Option+F3
    • Control+Option+F4
  • Setup script description: sets focus on the Combobox, and sets the combobox value to 'Alabama'
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (collapsed) is conveyed required aria-expanded="false"
Text of the selected option ('Alabama') is conveyed required Value of <input> element with role="combobox"
The ability to enter or edit text is conveyed required input[type="text"]
State of the text in the input (selected) is conveyed required Default browser behavior
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Open an empty, collapsed combobox in reading mode

  • Applies to: JAWS, NVDA
  • Mode: reading
  • Instructions: With the reading cursor on the combobox, open the combobox without moving into the listbox popup.
  • Commands:
    • Alt+Down Arrow
    • Alt+Up Arrow
  • Setup script description: sets focus on the combobox
Assertions
Assertion Priority Reference
Change in state (to expanded) is conveyed required aria-expanded="true"

Open an empty, collapsed combobox in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on the combobox, open the combobox without moving into the listbox popup.
  • Commands:
    • Alt+Down Arrow
    • Alt+Up Arrow
  • Setup script description: sets focus on the combobox
Assertions
Assertion Priority Reference
Change in state (to expanded) is conveyed required aria-expanded="true"

Open an empty, collapsed combobox

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on the combobox, open the combobox without moving into the listbox popup.
  • Commands:
    • Option+Down Arrow
    • Option+Up Arrow
  • Setup script description: sets focus on the combobox
Assertions
Assertion Priority Reference
Change in state (to expanded) is conveyed required aria-expanded="true"

Open a filled in, collapsed combobox in reading mode

  • Applies to: JAWS, NVDA
  • Mode: reading
  • Instructions: With the reading cursor on the combobox, open the combobox without moving into the listbox popup.
  • Commands:
    • Alt+Down Arrow
    • Alt+Up Arrow
  • Setup script description: sets focus on the combobox, and sets the combobox value to 'Alabama'
Assertions
Assertion Priority Reference
Change in state (to expanded) is conveyed required aria-expanded="true"

Open a filled in, collapsed combobox in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on the combobox, open the combobox without moving into the listbox popup.
  • Commands:
    • Alt+Down Arrow
    • Alt+Up Arrow
  • Setup script description: sets focus on the combobox, and sets the combobox value to 'Alabama'
Assertions
Assertion Priority Reference
Change in state (to expanded) is conveyed required aria-expanded="true"

Open a filled in, collapsed combobox

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on the combobox, open the combobox without moving into the listbox popup.
  • Commands:
    • Option+Down Arrow
    • Option+Up Arrow
  • Setup script description: sets focus on the combobox, and sets the combobox value to 'Alabama'
Assertions
Assertion Priority Reference
Change in state (to expanded) is conveyed required aria-expanded="true"

Open an empty, collapsed combobox by typing a character in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on the combobox, open the combobox without moving into the listbox popup.
  • Commands:
    • A
  • Setup script description: sets focus on the combobox
Assertions
Assertion Priority Reference
Change in state (to expanded) is conveyed required aria-expanded="true"
Text of the automatically completed option ('Alabama') is conveyed required Value of <input> element with role="combobox"
State of the text in the input (selected) is conveyed required Default browser behavior

Open an empty, collapsed combobox by typing a character

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on the combobox, open the combobox without moving into the listbox popup.
  • Commands:
    • A
  • Setup script description: sets focus on the combobox
Assertions
Assertion Priority Reference
Change in state (to expanded) is conveyed required aria-expanded="true"
Text of the automatically completed option ('Alabama') is conveyed required Value of <input> element with role="combobox"
State of the text in the input (selected) is conveyed required Default browser behavior

Open a filled in, collapsed combobox by typing a character in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on the combobox, open the combobox without moving into the listbox popup.
  • Commands:
    • L
  • Setup script description: sets focus on the combobox, and sets the combobox value to 'a'
Assertions
Assertion Priority Reference
Change in state (to expanded) is conveyed required aria-expanded="true"
Text of the automatically completed option ('Alabama') is conveyed required Value of <input> element with role="combobox"
State of the text in the input (selected) is conveyed required Default browser behavior

Open a filled in, collapsed combobox by typing a character

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on the combobox, open the combobox without moving into the listbox popup.
  • Commands:
    • L
  • Setup script description: sets focus on the combobox, and sets the combobox value to 'a'
Assertions
Assertion Priority Reference
Change in state (to expanded) is conveyed required aria-expanded="true"
Text of the automatically completed option ('Alabama') is conveyed required Value of <input> element with role="combobox"
State of the text in the input (selected) is conveyed required Default browser behavior

Read information about an empty, expanded combobox in reading mode

  • Applies to: JAWS, NVDA
  • Mode: reading
  • Instructions: With the reading cursor on the combobox, read information about the combobox.
  • Commands:
    • Insert+Tab
    • Insert+Up
  • Setup script description: sets focus on and expands the Combobox
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (expanded) is conveyed required aria-expanded="true"
The ability to enter or edit text is conveyed required input[type="text"]
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Read information about an empty, expanded combobox in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on the combobox, read information about the combobox.
  • Commands:
    • Insert+Tab
  • Setup script description: sets focus on and expands the Combobox
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (expanded) is conveyed required aria-expanded="true"
The ability to enter or edit text is conveyed required input[type="text"]
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Read information about an empty, expanded combobox

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on the combobox, read information about the combobox.
  • Commands:
    • Control+Option+F3
    • Control+Option+F4
  • Setup script description: sets focus on and expands the Combobox
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (expanded) is conveyed required aria-expanded="true"
The ability to enter or edit text is conveyed required input[type="text"]
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Read information about a filled in, expanded combobox in reading mode

  • Applies to: JAWS, NVDA
  • Mode: reading
  • Instructions: With the reading cursor on the combobox, read information about the combobox.
  • Commands:
    • Insert+Tab
    • Insert+Up
  • Setup script description: sets focus on and expands the Combobox, and sets the combobox value to 'Alabama'
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (expanded) is conveyed required aria-expanded="true"
Text of the selected option ('Alabama') is conveyed required Value of <input> element with role="combobox"
The ability to enter or edit text is conveyed required input[type="text"]
State of the text in the input (selected) is conveyed required Default browser behavior
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Read information about a filled in, expanded combobox in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on the combobox, read information about the combobox.
  • Commands:
    • Insert+Tab
  • Setup script description: sets focus on and expands the Combobox, and sets the combobox value to 'Alabama'
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (expanded) is conveyed required aria-expanded="true"
Text of the selected option ('Alabama') is conveyed required Value of <input> element with role="combobox"
The ability to enter or edit text is conveyed required input[type="text"]
State of the text in the input (selected) is conveyed required Default browser behavior
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Read information about a filled in, expanded combobox

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on the combobox, read information about the combobox.
  • Commands:
    • Control+Option+F3
    • Control+Option+F4
  • Setup script description: sets focus on and expands the Combobox, and sets the combobox value to 'Alabama'
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (expanded) is conveyed required aria-expanded="true"
Text of the selected option ('Alabama') is conveyed required Value of <input> element with role="combobox"
The ability to enter or edit text is conveyed required input[type="text"]
State of the text in the input (selected) is conveyed required Default browser behavior
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Narrow down the matching options in an empty, expanded combobox in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on the combobox, type a character to narrow down the number of matching options in the listbox popup.
  • Commands:
    • A
  • Setup script description: sets focus on and expands the combobox
Assertions
Assertion Priority Reference
Text of the automatically completed option ('Alabama') is conveyed required Value of <input> element with role="combobox"
State of the text in the input (selected) is conveyed required Default browser behavior

Narrow down the matching options in an empty, expanded combobox

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on the combobox, type a character to narrow down the number of matching options in the listbox popup.
  • Commands:
    • A
  • Setup script description: sets focus on and expands the combobox
Assertions
Assertion Priority Reference
Text of the automatically completed option ('Alabama') is conveyed required Value of <input> element with role="combobox"
State of the text in the input (selected) is conveyed required Default browser behavior

Narrow down the matching options in a filled in, expanded combobox in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on the combobox, type a character to narrow down the number of matching options in the listbox popup.
  • Commands:
    • L
  • Setup script description: sets focus on and expands the combobox, sets the combobox value to 'a', and de-selects all text in the input
Assertions
Assertion Priority Reference
Text of the automatically completed option ('Alabama') is conveyed required Value of <input> element with role="combobox"
State of the text in the input (selected) is conveyed required Default browser behavior

Narrow down the matching options in a filled in, expanded combobox

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on the combobox, type a character to narrow down the number of matching options in the listbox popup.
  • Commands:
    • L
  • Setup script description: sets focus on and expands the combobox, sets the combobox value to 'a', and de-selects all text in the input
Assertions
Assertion Priority Reference
Text of the automatically completed option ('Alabama') is conveyed required Value of <input> element with role="combobox"
State of the text in the input (selected) is conveyed required Default browser behavior

Close an empty combobox in reading mode

  • Applies to: JAWS, NVDA
  • Mode: reading
  • Instructions: With the reading cursor on the combobox, close the combobox.
  • Commands:
    • Escape
  • Setup script description: sets focus on and expands the combobox
Assertions
Assertion Priority Reference
Change in state (to collapsed) is conveyed required aria-expanded="false"

Close an empty combobox in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on the combobox, close the combobox.
  • Commands:
    • Enter
    • Escape
  • Setup script description: sets focus on and expands the combobox
Assertions
Assertion Priority Reference
Change in state (to collapsed) is conveyed required aria-expanded="false"

Close an empty combobox

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on the combobox, close the combobox.
  • Commands:
    • Enter
    • Escape
  • Setup script description: sets focus on and expands the combobox
Assertions
Assertion Priority Reference
Change in state (to collapsed) is conveyed required aria-expanded="false"

Close a filled in combobox in reading mode

  • Applies to: JAWS, NVDA
  • Mode: reading
  • Instructions: With the reading cursor on the combobox, close the combobox.
  • Commands:
    • Escape
  • Setup script description: sets focus on and expands the combobox, and sets the combobox value to 'Alabama'
Assertions
Assertion Priority Reference
Change in state (to collapsed) is conveyed required aria-expanded="false"

Close a filled in combobox in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on the combobox, close the combobox.
  • Commands:
    • Enter
    • Escape
  • Setup script description: sets focus on and expands the combobox, and sets the combobox value to 'Alabama'
Assertions
Assertion Priority Reference
Change in state (to collapsed) is conveyed required aria-expanded="false"

Close a filled in combobox

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on the combobox, close the combobox.
  • Commands:
    • Enter
    • Escape
  • Setup script description: sets focus on and expands the combobox, and sets the combobox value to 'Alabama'
Assertions
Assertion Priority Reference
Change in state (to collapsed) is conveyed required aria-expanded="false"

Navigate from an empty, collapsed combobox to the first option in a listbox popup in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on the combobox, open the combobox and navigate to the first option in the listbox popup.
  • Commands:
    • Down Arrow
  • Setup script description: sets focus on the combobox
Assertions
Assertion Priority Reference
State of the combobox (expanded) is conveyed required aria-expanded="true"
Role of the popup ('listbox') is conveyed required role="listbox"
Name of the popup ('States') is conveyed required aria-label
Text of the focused option in the popup ('Alabama') is conveyed required Visible text content contained within the element with role="option"
State of the focused option in the popup (selected) is conveyed optional aria-selected="true"
Position of the focused option in the popup (1) is conveyed required Calculated by browser
Number of options in the popup (56) is conveyed required Calculated by browser

Navigate from an empty, collapsed combobox to the first option in a listbox popup

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on the combobox, open the combobox and navigate to the first option in the listbox popup.
  • Commands:
    • Down Arrow
  • Setup script description: sets focus on the combobox
Assertions
Assertion Priority Reference
State of the combobox (expanded) is conveyed required aria-expanded="true"
Role of the popup ('listbox') is conveyed required role="listbox"
Name of the popup ('States') is conveyed required aria-label
Text of the focused option in the popup ('Alabama') is conveyed required Visible text content contained within the element with role="option"
State of the focused option in the popup (selected) is conveyed optional aria-selected="true"
Position of the focused option in the popup (1) is conveyed required Calculated by browser
Number of options in the popup (56) is conveyed required Calculated by browser

Navigate from an empty, collapsed combobox to the last option in a listbox popup interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on the combobox, open the combobox and navigate to the last option in the listbox popup.
  • Commands:
    • Up Arrow
  • Setup script description: sets focus on the combobox
Assertions
Assertion Priority Reference
State of the combobox (expanded) is conveyed required aria-expanded="true"
Role of the popup ('listbox') is conveyed required role="listbox"
Name of the popup ('States') is conveyed required aria-label
Text of the focused option in the popup ('Wyoming') is conveyed required Visible text content contained within the element with role="option"
State of the focused option in the popup (selected) is conveyed optional aria-selected="true"
Position of the focused option in the popup (56) is conveyed required Calculated by browser
Number of options in the popup (56) is conveyed required Calculated by browser

Navigate from an empty, collapsed combobox to the last option in a listbox popup

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on the combobox, open the combobox and navigate to the last option in the listbox popup.
  • Commands:
    • Up Arrow
  • Setup script description: sets focus on the combobox
Assertions
Assertion Priority Reference
State of the combobox (expanded) is conveyed required aria-expanded="true"
Role of the popup ('listbox') is conveyed required role="listbox"
Name of the popup ('States') is conveyed required aria-label
Text of the focused option in the popup ('Wyoming') is conveyed required Visible text content contained within the element with role="option"
State of the focused option in the popup (selected) is conveyed optional aria-selected="true"
Position of the focused option in the popup (56) is conveyed required Calculated by browser
Number of options in the popup (56) is conveyed required Calculated by browser

Navigate from a filled in, collapsed combobox to the first option in a listbox popup in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on the combobox, open the combobox and navigate to the first option in the listbox popup.
  • Commands:
    • Down Arrow
  • Setup script description: sets focus on the combobox, and sets the combobox value to 'a'
Assertions
Assertion Priority Reference
State of the combobox (expanded) is conveyed required aria-expanded="true"
Role of the popup ('listbox') is conveyed required role="listbox"
Name of the popup ('States') is conveyed required aria-label
Text of the focused option in the popup ('Alabama') is conveyed required Visible text content contained within the element with role="option"
State of the focused option in the popup (selected) is conveyed optional aria-selected="true"
Position of the focused option in the popup (1) is conveyed required Calculated by browser
Number of options in the popup (5) is conveyed required Calculated by browser

Navigate from a filled in, collapsed combobox to the first option in a listbox popup

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on the combobox, open the combobox and navigate to the first option in the listbox popup.
  • Commands:
    • Down Arrow
  • Setup script description: sets focus on the combobox, and sets the combobox value to 'a'
Assertions
Assertion Priority Reference
State of the combobox (expanded) is conveyed required aria-expanded="true"
Role of the popup ('listbox') is conveyed required role="listbox"
Name of the popup ('States') is conveyed required aria-label
Text of the focused option in the popup ('Alabama') is conveyed required Visible text content contained within the element with role="option"
State of the focused option in the popup (selected) is conveyed optional aria-selected="true"
Position of the focused option in the popup (1) is conveyed required Calculated by browser
Number of options in the popup (5) is conveyed required Calculated by browser

Navigate from a filled in, collapsed combobox to the last option in a listbox popup interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on the combobox, open the combobox and navigate to the last option in the listbox popup.
  • Commands:
    • Up Arrow
  • Setup script description: sets focus on the combobox, and sets the combobox value to 'a'
Assertions
Assertion Priority Reference
State of the combobox (expanded) is conveyed required aria-expanded="true"
Role of the popup ('listbox') is conveyed required role="listbox"
Name of the popup ('States') is conveyed required aria-label
Text of the focused option in the popup ('Arkansas') is conveyed required Visible text content contained within the element with role="option"
State of the focused option in the popup (selected) is conveyed optional aria-selected="true"
Position of the focused option in the popup (5) is conveyed required Calculated by browser
Number of options in the popup (5) is conveyed required Calculated by browser

Navigate from a filled in, collapsed combobox to the last option in a listbox popup

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on the combobox, open the combobox and navigate to the last option in the listbox popup.
  • Commands:
    • Up Arrow
  • Setup script description: sets focus on the combobox, and sets the combobox value to 'a'
Assertions
Assertion Priority Reference
State of the combobox (expanded) is conveyed required aria-expanded="true"
Role of the popup ('listbox') is conveyed required role="listbox"
Name of the popup ('States') is conveyed required aria-label
Text of the focused option in the popup ('Arkansas') is conveyed required Visible text content contained within the element with role="option"
State of the focused option in the popup (selected) is conveyed optional aria-selected="true"
Position of the focused option in the popup (5) is conveyed required Calculated by browser
Number of options in the popup (5) is conveyed required Calculated by browser

Navigate from an empty, expanded combobox to the first option in a listbox popup in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on the combobox, navigate to the the first option in the listbox popup.
  • Commands:
    • Down Arrow
  • Setup script description: sets focus on and expands the combobox
Assertions
Assertion Priority Reference
Role of the popup ('listbox') is conveyed required role="listbox"
Name of the popup ('States') is conveyed required aria-label
Text of the focused option in the popup ('Alabama') is conveyed required Visible text content contained within the element with role="option"
State of the focused option in the popup (selected) is conveyed optional aria-selected="true"
Position of the focused option in the popup (1) is conveyed required Calculated by browser
Number of options in the popup (56) is conveyed required Calculated by browser

Navigate from an empty, expanded combobox to the first option in a listbox popup

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on the combobox, navigate to the the first option in the listbox popup.
  • Commands:
    • Down Arrow
  • Setup script description: sets focus on and expands the combobox
Assertions
Assertion Priority Reference
Role of the popup ('listbox') is conveyed required role="listbox"
Name of the popup ('States') is conveyed required aria-label
Text of the focused option in the popup ('Alabama') is conveyed required Visible text content contained within the element with role="option"
State of the focused option in the popup (selected) is conveyed optional aria-selected="true"
Position of the focused option in the popup (1) is conveyed required Calculated by browser
Number of options in the popup (56) is conveyed required Calculated by browser

Navigate from an empty, expanded combobox to the last option in a listbox popup interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on the combobox, navigate to the the last option in the listbox popup.
  • Commands:
    • Up Arrow
  • Setup script description: sets focus on and expands the combobox
Assertions
Assertion Priority Reference
Role of the popup ('listbox') is conveyed required role="listbox"
Name of the popup ('States') is conveyed required aria-label
Text of the focused option in the popup ('Wyoming') is conveyed required Visible text content contained within the element with role="option"
State of the focused option in the popup (selected) is conveyed optional aria-selected="true"
Position of the focused option in the popup (56) is conveyed required Calculated by browser
Number of options in the popup (56) is conveyed required Calculated by browser

Navigate from an empty, expanded combobox to the last option in a listbox popup

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on the combobox, navigate to the the last option in the listbox popup.
  • Commands:
    • Up Arrow
  • Setup script description: sets focus on and expands the combobox
Assertions
Assertion Priority Reference
Role of the popup ('listbox') is conveyed required role="listbox"
Name of the popup ('States') is conveyed required aria-label
Text of the focused option in the popup ('Wyoming') is conveyed required Visible text content contained within the element with role="option"
State of the focused option in the popup (selected) is conveyed optional aria-selected="true"
Position of the focused option in the popup (56) is conveyed required Calculated by browser
Number of options in the popup (56) is conveyed required Calculated by browser

Navigate from a filled in, expanded combobox to the first option in a listbox popup in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on the combobox, navigate to the the first option in the listbox popup.
  • Commands:
    • Down Arrow
  • Setup script description: sets focus on and expands the combobox, and sets the combobox value to 'a'
Assertions
Assertion Priority Reference
Role of the popup ('listbox') is conveyed required role="listbox"
Name of the popup ('States') is conveyed required aria-label
Text of the focused option in the popup ('Alabama') is conveyed required Visible text content contained within the element with role="option"
State of the focused option in the popup (selected) is conveyed optional aria-selected="true"
Position of the focused option in the popup (1) is conveyed required Calculated by browser
Number of options in the popup (5) is conveyed required Calculated by browser

Navigate from a filled in, expanded combobox to the first option in a listbox popup

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on the combobox, navigate to the the first option in the listbox popup.
  • Commands:
    • Down Arrow
  • Setup script description: sets focus on and expands the combobox, and sets the combobox value to 'a'
Assertions
Assertion Priority Reference
Role of the popup ('listbox') is conveyed required role="listbox"
Name of the popup ('States') is conveyed required aria-label
Text of the focused option in the popup ('Alabama') is conveyed required Visible text content contained within the element with role="option"
State of the focused option in the popup (selected) is conveyed optional aria-selected="true"
Position of the focused option in the popup (1) is conveyed required Calculated by browser
Number of options in the popup (5) is conveyed required Calculated by browser

Navigate from a filled in, expanded combobox to the last option in a listbox popup interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on the combobox, navigate to the the last option in the listbox popup.
  • Commands:
    • Up Arrow
  • Setup script description: sets focus on and expands the combobox, and sets the combobox value to 'a'
Assertions
Assertion Priority Reference
Role of the popup ('listbox') is conveyed required role="listbox"
Name of the popup ('States') is conveyed required aria-label
Text of the focused option in the popup ('Arkansas') is conveyed required Visible text content contained within the element with role="option"
State of the focused option in the popup (selected) is conveyed optional aria-selected="true"
Position of the focused option in the popup (5) is conveyed required Calculated by browser
Number of options in the popup (5) is conveyed required Calculated by browser

Navigate from a filled in, expanded combobox to the last option in a listbox popup

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on the combobox, navigate to the the last option in the listbox popup.
  • Commands:
    • Up Arrow
  • Setup script description: sets focus on and expands the combobox, and sets the combobox value to 'a'
Assertions
Assertion Priority Reference
Role of the popup ('listbox') is conveyed required role="listbox"
Name of the popup ('States') is conveyed required aria-label
Text of the focused option in the popup ('Arkansas') is conveyed required Visible text content contained within the element with role="option"
State of the focused option in the popup (selected) is conveyed optional aria-selected="true"
Position of the focused option in the popup (5) is conveyed required Calculated by browser
Number of options in the popup (5) is conveyed required Calculated by browser

Navigate to the next option in a listbox popup in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on an option in the listbox popup, navigate forwards to the next option.
  • Commands:
    • Down Arrow
  • Setup script description: expands the combobox, sets the combobox value to 'Alabama' and places focus on that option in the listbox popup
Assertions
Assertion Priority Reference
State of the combobox (expanded) is conveyed required aria-expanded="true"
Role of the popup ('listbox') is conveyed required role="listbox"
Name of the popup ('States') is conveyed required aria-label
Text of the focused option in the popup ('Alaska') is conveyed required Visible text content contained within the element with role="option"
State of the focused option in the popup (selected) is conveyed optional aria-selected="true"
Position of the focused option in the popup (2) is conveyed required Calculated by browser
Number of options in the popup (56) is conveyed required Calculated by browser

Navigate to the next option in a listbox popup

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on an option in the listbox popup, navigate forwards to the next option.
  • Commands:
    • Control+Option+Right
    • Down Arrow
  • Setup script description: expands the combobox, sets the combobox value to 'Alabama' and places focus on that option in the listbox popup
Assertions
Assertion Priority Reference
State of the combobox (expanded) is conveyed required aria-expanded="true"
Role of the popup ('listbox') is conveyed required role="listbox"
Name of the popup ('States') is conveyed required aria-label
Text of the focused option in the popup ('Alaska') is conveyed required Visible text content contained within the element with role="option"
State of the focused option in the popup (selected) is conveyed optional aria-selected="true"
Position of the focused option in the popup (2) is conveyed required Calculated by browser
Number of options in the popup (56) is conveyed required Calculated by browser

Navigate to the previous option in a listbox popup in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on an option in the listbox popup, navigate backwards to the previous option.
  • Commands:
    • Up Arrow
  • Setup script description: expands the combobox, sets the combobox value to 'Alaska' and places focus on that option in the listbox popup
Assertions
Assertion Priority Reference
State of the combobox (expanded) is conveyed required aria-expanded="true"
Role of the popup ('listbox') is conveyed required role="listbox"
Name of the popup ('States') is conveyed required aria-label
Text of the focused option in the popup ('Alabama') is conveyed required Visible text content contained within the element with role="option"
State of the focused option in the popup (selected) is conveyed optional aria-selected="true"
Position of the focused option in the popup (1) is conveyed required Calculated by browser
Number of options in the popup (56) is conveyed required Calculated by browser

Navigate to the previous option in a listbox popup

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on an option in the listbox popup, navigate backwards to the previous option.
  • Commands:
    • Control+Option+Left
    • Up Arrow
  • Setup script description: expands the combobox, sets the combobox value to 'Alaska' and places focus on that option in the listbox popup
Assertions
Assertion Priority Reference
State of the combobox (expanded) is conveyed required aria-expanded="true"
Role of the popup ('listbox') is conveyed required role="listbox"
Name of the popup ('States') is conveyed required aria-label
Text of the focused option in the popup ('Alabama') is conveyed required Visible text content contained within the element with role="option"
State of the focused option in the popup (selected) is conveyed optional aria-selected="true"
Position of the focused option in the popup (1) is conveyed required Calculated by browser
Number of options in the popup (56) is conveyed required Calculated by browser

Read information about a listbox popup in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on an option in the listbox popup, read information about the listbox popup.
  • Commands:
    • Insert+Tab
  • Setup script description: expands the combobox, and places focus on the first option in the listbox popup
Assertions
Assertion Priority Reference
Role of the popup ('listbox') is conveyed required role="listbox"
Name of the popup ('States') is conveyed required aria-label
Text of the focused option in the popup ('Alabama') is conveyed required Visible text content contained within the element with role="option"
State of the focused option in the popup (selected) is conveyed optional aria-selected="true"
Position of the focused option in the popup (1) is conveyed required Calculated by browser
Number of options in the popup (56) is conveyed required Calculated by browser

Read information about a listbox popup

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on an option in the listbox popup, read information about the listbox popup.
  • Commands:
    • Control+Option+F3
    • Control+Option+F4
  • Setup script description: expands the combobox, and places focus on the first option in the listbox popup
Assertions
Assertion Priority Reference
Role of the popup ('listbox') is conveyed required role="listbox"
Name of the popup ('States') is conveyed required aria-label
Text of the focused option in the popup ('Alabama') is conveyed required Visible text content contained within the element with role="option"
State of the focused option in the popup (selected) is conveyed optional aria-selected="true"
Position of the focused option in the popup (1) is conveyed required Calculated by browser
Number of options in the popup (56) is conveyed required Calculated by browser

Navigate out of a listbox popup by moving the editing cursor to the right in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on an option in the listbox popup, navigate back to the textbox by moving the editing cursor to the right.
  • Commands:
    • Right Arrow
  • Setup script description: expands the combobox, sets the combobox value to 'Alabama', places focus on that option in the listbox popup and positions the editing cursor at the beginning of the textbox
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (expanded) is conveyed required aria-expanded="true"
Text of the selected option ('Alabama') is conveyed required Value of <input> element with role="combobox"
The ability to enter or edit text is conveyed required input[type="text"]
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"
Cursor position (on the character 'l') is conveyed required default browser behavior

Navigate out of a listbox popup by moving the editing cursor to the left in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on an option in the listbox popup, navigate back to the textbox by moving the editing cursor to the left.
  • Commands:
    • Left Arrow
  • Setup script description: expands the combobox, sets the combobox value to 'Alabama', places focus on that option in the listbox popup and positions the editing cursor at the end of the textbox
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (expanded) is conveyed required aria-expanded="true"
Text of the selected option ('Alabama') is conveyed required Value of <input> element with role="combobox"
The ability to enter or edit text is conveyed required input[type="text"]
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"
Cursor position (on the character 'a') is conveyed required default browser behavior

Navigate out of a listbox popup by moving the editing cursor to the right

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on an option in the listbox popup, navigate back to the textbox by moving the editing cursor to the right.
  • Commands:
    • Right Arrow
  • Setup script description: expands the combobox, sets the combobox value to 'Alabama', places focus on that option in the listbox popup and positions the editing cursor at the beginning of the textbox
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (expanded) is conveyed required aria-expanded="true"
Text of the selected option ('Alabama') is conveyed required Value of <input> element with role="combobox"
The ability to enter or edit text is conveyed required input[type="text"]
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"
Cursor position (on the character 'l') is conveyed required default browser behavior

Navigate out of a listbox popup by moving the editing cursor to the left

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on an option in the listbox popup, navigate back to the textbox by moving the editing cursor to the left.
  • Commands:
    • Left Arrow
  • Setup script description: expands the combobox, sets the combobox value to 'Alabama', places focus on that option in the listbox popup and positions the editing cursor at the end of the textbox
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (expanded) is conveyed required aria-expanded="true"
Text of the selected option ('Alabama') is conveyed required Value of <input> element with role="combobox"
The ability to enter or edit text is conveyed required input[type="text"]
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"
Cursor position (on the character 'a') is conveyed required default browser behavior

Navigate out of a listbox popup by moving the editing cursor to the end of the textbox in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on an option in the listbox popup, navigate back to the textbox by moving the editing cursor to the end of the text.
  • Commands:
    • End
  • Setup script description: expands the combobox, sets the combobox value to 'Alabama', places focus on that option in the listbox popup and positions the editing cursor at the beginning of the textbox
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (expanded) is conveyed required aria-expanded="true"
Text of the selected option ('Alabama') is conveyed required Value of <input> element with role="combobox"
The ability to enter or edit text is conveyed required input[type="text"]
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"
Cursor position (at the end of the textbox) is conveyed required default browser behavior

Navigate out of a listbox popup by moving the editing cursor to the beginning of the textbox in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on an option in the listbox popup, navigate back to the textbox by moving the editing cursor to the beginning of the text.
  • Commands:
    • Home
  • Setup script description: expands the combobox, sets the combobox value to 'Alabama', places focus on that option in the listbox popup and positions the editing cursor at the end of the textbox
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (expanded) is conveyed required aria-expanded="true"
Text of the selected option ('Alabama') is conveyed required Value of <input> element with role="combobox"
The ability to enter or edit text is conveyed required input[type="text"]
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"
Cursor position (on the character 'a') is conveyed required default browser behavior

Navigate out of a listbox popup by moving the editing cursor to the end of the textbox

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on an option in the listbox popup, navigate back to the textbox by moving the editing cursor to the end of the text.
  • Commands:
    • End
  • Setup script description: expands the combobox, sets the combobox value to 'Alabama', places focus on that option in the listbox popup and positions the editing cursor at the beginning of the textbox
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (expanded) is conveyed required aria-expanded="true"
Text of the selected option ('Alabama') is conveyed required Value of <input> element with role="combobox"
The ability to enter or edit text is conveyed required input[type="text"]
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"
Cursor position (at the end of the textbox) is conveyed required default browser behavior

Navigate out of a listbox popup by moving the editing cursor to the beginning of the textbox

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on an option in the listbox popup, navigate back to the textbox by moving the editing cursor to the beginning of the text.
  • Commands:
    • Home
  • Setup script description: expands the combobox, sets the combobox value to 'Alabama', places focus on that option in the listbox popup and positions the editing cursor at the end of the textbox
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (expanded) is conveyed required aria-expanded="true"
Text of the selected option ('Alabama') is conveyed required Value of <input> element with role="combobox"
The ability to enter or edit text is conveyed required input[type="text"]
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"
Cursor position (on the character 'a') is conveyed required default browser behavior

Select an option in a listbox popup in interaction mode

  • Applies to: JAWS, NVDA
  • Mode: interaction
  • Instructions: With focus on an option in the listbox popup, select the focused option.
  • Commands:
    • Enter
    • Escape
  • Setup script description: expands the Combobox and places focus on 'Alabama' in the listbox popup
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (collapsed) is conveyed required aria-expanded="false"
Text of the selected option ('Alabama') is conveyed required <label>
The ability to enter or edit text is conveyed required input[type="text"]
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

Select an option in a listbox popup

  • Applies to: macOS VoiceOver
  • Mode: interaction
  • Instructions: With focus on an option in the listbox popup, select the focused option.
  • Commands:
    • Control+Option+Space
    • Enter
    • Escape
  • Setup script description: expands the Combobox and places focus on 'Alabama' in the listbox popup
Assertions
Assertion Priority Reference
Role 'combobox' is conveyed required role="combobox"
Name of the combobox ('State') is conveyed required <label>
State of the combobox (collapsed) is conveyed required aria-expanded="false"
Text of the selected option ('Alabama') is conveyed required <label>
The ability to enter or edit text is conveyed required input[type="text"]
The presence of autocomplete behavior is conveyed required aria-autocomplete="both"

@mfairchild365
Copy link
Contributor

Reading through this and looking at the PR. First, this is awesome work! Second, was there any discussion on if the value of aria-autocomplete needs to be conveyed (both, list, or inline)? Or is just that the presence of autocomplete behavior in general sufficient?

@jscholes
Copy link
Contributor

@mfairchild365 Thanks for reviewing! I haven't been involved in a discussion about how we feel different values of aria-autocomplete should be conveyed (if indeed we feel there should be a difference), but I think it's a great question. I'll add a TODO to my list to file an issue to bring up on a future meeting.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
3 participants