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: VPDS uses native HTML and elements.

  • Use descriptive accordion titles that reflect the content within the associated panels.
  • Check that the icons in the accordion header use the library’s right-to-left class if needed.

Keyboard controls

Keyboard actions and their corresponding behaviors for accordion
Key Behavior
TabMoves focus to the next focusable element. All focusable elements in the accordion section are included in the tab sequence.
Shift+TabMoves focus to previous focusable element. All focusable elements in accordion section included in tab sequence.
SpaceorEnterExpands or collapses the section panel when focus is on the accordion’s header.

VGAR (internal only)

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