Creating access for everyone, everywhere requires attention to accessibility attributes, best practices, and requirements. Find accessibility guidance below.


Note: Components in each code library are implemented differently (especially Flutter). Many of the behaviors and attributes described are already handled for you as part of our components. Product teams are responsible for ensuring their apps meet all current requirements. Some of the information below may not apply to your implementation.

Best practices

Ensure the following best practices are met when implementing this component during development.


Note: Comboboxes are comprised of multiple components. Many of the attributes that comboboxes use are handled by our library components. As with other form components, use values to associate additional instructions or error messaging so screen readers will read them. Reference the coded examples.

  • Consider implementing a “no results found” message similar to the Angular examples.
  • Visit Listbox for notes on its roles which include .

Keyboard controls

Input

Maintain common keyboard shortcuts used for editing text unless uniquely specified. Refer to Input for details.

Keyboard actions and their corresponding behaviors for input
KeyBehavior
TabMoves to next interactive focusable element.
Shift + TabMoves to previous input field.
SpaceOpens the menu.
+ Opens the menu.
EscDismisses menu and clears any inline autocomplete while maintaining user-entered input.

Menu (listbox pop-up)

Reference Listbox for detailed interactions. Focus will loop in a circular direction among the menu items.

Keyboard actions and their corresponding behaviors for menu (listbox popup)
KeyBehavior
EnterConfirms the option in focus as the user’s selection and closes the menu.
TabDismisses the menu, moves to next interactive focusable element.
+ Moves focus between the options in the menu.
EscDismisses menu and clears any inline autocomplete while maintaining user-entered input.

VGAR (internal only)

Find links to the Visa Global Accessibility Requirements (VGAR) for this component.