Skip to main content
U.S. flag

An official website of the United States government

Dot gov

The .gov means it’s official.
Federal government websites often end in .gov or .mil. Before sharing sensitive information, make sure you’re on a federal government site.

Https

The site is secure.
The https:// ensures that you are connecting to the official website and that any information you provide is encrypted and transmitted securely.

Latest release: Component Library v56.18.0 (Oct 13, 2026)

Components

Action list - Accessibility tests

Baseline accessibility test results for the va-action-list component across browsers and assistive technologies.

Test summary

The Design System team tested this component in isolation across a mix of browsers and assistive technologies using the . Our results may not capture accessibility issues that arise from surrounding context like page structure, content, or how multiple components interact.

To ensure accessibility, you must also test the Action list component within your own product. See the conditional tests section for a list of tests that require additional testing in your context.

Version tested Passed Failed Conditional 56.19.0 35 0 5

General tests

  • Screen readers announce lists.

    When you use a screen reader to navigate to a list, you hear an announcement that indicates that you are in a list, and accurately announces the number of items in that list and the position of each item.

    Environment Result Last tested macOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     Windows Chrome/JAWS October 20, 2026
    Version: 56.19.0     Windows Edge/NVDA October 20, 2026
    Version: 56.19.0     iOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     Android Chrome/Talkback October 20, 2026
    Version: 56.19.0

  • Content is presented in a logical order.

    When you view and interact with the page or component, you find that content is presented in a meaningful sequence that supports comprehension and navigation.

    Environment Result Last tested macOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     iOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0

  • Content is available in both portrait and landscape orientations.

    When you rotate your device, you see that content remains visible and functional in both portrait and landscape orientations.

    Environment Result Last tested macOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     iOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0

  • Text isn't presented as images.

    When you view the component or page, you find that text is rendered as real text, not as an image of text.

    Environment Result Last tested macOS Chrome October 20, 2026
    Version: 56.19.0

  • Text remains readable when spacing is adjusted.

    When you adjust text spacing (line spacing to 1.5x font size, letter spacing to 0.12x, word spacing to 0.16x), you find that no content or functionality is lost.

    Environment Result Last tested macOS Chrome October 20, 2026
    Version: 56.19.0

  • Pointer actions are reversible and don't execute on touch down.

    When you press and hold on an interactive element, you can cancel the action by moving your pointer away before releasing.

    Environment Result Last tested iOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     Android Chrome/Talkback October 20, 2026
    Version: 56.19.0

  • Link size is at least 24 pixels, except for links in sentences.

    When you check the size of links on the page, you find that each link either has both width and height of at least 24 pixels, or has at least 24 pixels of clear space between it and the next link. Links in sentences or paragraphs are typically exempt from the size requirement.

    Environment Result Last tested macOS Chrome October 20, 2026
    Version: 56.19.0

  • Button size is at least 24 pixels.

    When you check the size of buttons on the page, you find that each button either has both width and height of at least 24 pixels, or has at least 24 pixels of clear space between it and the next button.

    Environment Result Last tested macOS Chrome October 20, 2026
    Version: 56.19.0

  • Links navigate to pages; buttons perform actions.

    When you activate a link, it takes you to a new page or section. When you activate a button, it performs an action on the current page.

    Environment Result Last tested macOS Safari October 20, 2026
    Version: 56.19.0

  • Links navigate to a new page or section.

    When you activate a link, you are taken to a different page or a section on the current page.

    Environment Result Last tested macOS Safari October 20, 2026
    Version: 56.19.0

  • Buttons perform actions on the current page.

    When you activate a button, you find that it performs an action on the current page.

    Environment Result Last tested macOS Safari October 20, 2026
    Version: 56.19.0

Keyboard tests

  • Interactive elements are fully operable using only a keyboard.

    When you access an interactive element using only a keyboard, you can navigate to the element, activate it, and navigate away from it.

    Environment Result Last tested macOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     windows-chrome-nvda October 20, 2026
    Version: 56.19.0     Windows Chrome/JAWS October 20, 2026
    Version: 56.19.0

  • Links are fully operable using only a keyboard.

    When you interact with a link using only a keyboard, you can navigate to the link, activate it, and navigate away from it.

    Environment Result Last tested macOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     windows-chrome-nvda October 20, 2026
    Version: 56.19.0     Windows Chrome/JAWS October 20, 2026
    Version: 56.19.0

  • Keyboard focus doesn't get trapped.

    When you move focus to an interactive element with a keyboard, you can move focus away from that element using only standard keyboard keys (Tab, Shift+Tab, arrow keys, or Escape).

    Environment Result Last tested macOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     windows-chrome-nvda October 20, 2026
    Version: 56.19.0     Windows Chrome/JAWS October 20, 2026
    Version: 56.19.0     iOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     Android Chrome/Talkback October 20, 2026
    Version: 56.19.0

  • Links don't trap keyboard focus.

    When you navigate to the link using a keyboard, you can move focus away from the link using only standard keyboard keys (Tab, Shift+Tab, arrow keys, or Escape).

    Environment Result Last tested macOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     windows-chrome-nvda October 20, 2026
    Version: 56.19.0     Windows Chrome/JAWS October 20, 2026
    Version: 56.19.0

  • Tab order follows a logical sequence.

    When you navigate the page or component with a keyboard, you find focus moves through interactive elements in a meaningful order.

    Environment Result Last tested macOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     windows-chrome-nvda October 20, 2026
    Version: 56.19.0     Windows Chrome/JAWS October 20, 2026
    Version: 56.19.0     Android Chrome/Talkback October 20, 2026
    Version: 56.19.0

  • Interactive elements display a clear focus indicator.

    When you navigate to an interactive element with a keyboard, you see a clear visual indicator around the element showing that it has focus.

    Environment Result Last tested macOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     windows-chrome-nvda October 20, 2026
    Version: 56.19.0     Windows Chrome/JAWS October 20, 2026
    Version: 56.19.0     iOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     Android Chrome/Talkback October 20, 2026
    Version: 56.19.0

  • Focused elements are fully visible.

    When you focus on an element with a keyboard, you see that the element that has focus remains visible on screen and is not obscured by sticky headers, footers, modals, tooltips, or other overlaying content.

    Environment Result Last tested macOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     windows-chrome-nvda October 20, 2026
    Version: 56.19.0     Windows Chrome/JAWS October 20, 2026
    Version: 56.19.0     iOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     Android Chrome/Talkback October 20, 2026
    Version: 56.19.0

  • Focusing on an element doesn't trigger unexpected changes.

    When you focus on an element, it doesn't trigger a change of context such as opening a new page, displaying a modal, or causing content to appear or disappear.

    Environment Result Last tested macOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     Windows Chrome/JAWS October 20, 2026
    Version: 56.19.0     Windows Edge/NVDA October 20, 2026
    Version: 56.19.0     iOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0

Screen reader tests

  • Screen readers don't announce decorative images.

    When you navigate to a decorative image with a screen reader, you don't hear any information about the image.

    Environment Result Last tested macOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     Windows Chrome/JAWS October 20, 2026
    Version: 56.19.0     Windows Edge/NVDA October 20, 2026
    Version: 56.19.0     iOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     Android Chrome/Talkback October 20, 2026
    Version: 56.19.0

  • Headings are used to convey structure.

    When you use a screen reader to navigate the page by heading, you find that all elements that act as content headings are included in the heading structure.

    Environment Result Last tested macOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     Windows Chrome/JAWS October 20, 2026
    Version: 56.19.0     Windows Edge/NVDA October 20, 2026
    Version: 56.19.0

    Notes: Teams should use the heading-level and heading-text properties provided in the component

  • Screen readers announce relationships in expandable and collapsible content.

    When you use a screen reader to navigate expandable or collapsible content, you hear announcements that clearly indicate which element controls which content and the current expanded or collapsed state.

    Environment Result Last tested macOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     Windows Chrome/JAWS October 20, 2026
    Version: 56.19.0     Windows Edge/NVDA October 20, 2026
    Version: 56.19.0     iOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     Android Chrome/Talkback October 20, 2026
    Version: 56.19.0

    Notes: Teams must set heading-text so the expandable list has an accessible name.

  • Screen reader announcements match visible text.

    When you focus on an interactive element with a screen reader, you hear an announcement that matches the element's visible text.

    Environment Result Last tested macOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     Windows Chrome/JAWS October 20, 2026
    Version: 56.19.0     Windows Edge/NVDA October 20, 2026
    Version: 56.19.0

  • Screen readers announce state.

    When you use a screen reader, you hear announcements for dynamic states like expanded, checked, or disabled.

    Environment Result Last tested macOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     Windows Chrome/JAWS October 20, 2026
    Version: 56.19.0     Windows Edge/NVDA October 20, 2026
    Version: 56.19.0     iOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     Android Chrome/Talkback October 20, 2026
    Version: 56.19.0

    Notes: Buttons reliably announce their expanded and collapsed state.

  • Screen readers announce elements that receive focus automatically.

    When an action moves focus to another element, you hear your screen reader announce the newly focused element. This includes content that was added to the page after it loaded.

    Environment Result Last tested macOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0     Windows Chrome/JAWS October 20, 2026
    Version: 56.19.0     Windows Edge/NVDA October 20, 2026
    Version: 56.19.0     iOS Safari/VoiceOver October 20, 2026
    Version: 56.19.0

Voice control tests

  • Voice control users can activate an element by speaking its visible text.

    When you use voice control to say the visible text of an interactive element, the element activates as expected.

    Environment Result Last tested macOS Voice Control October 20, 2026
    Version: 56.19.0     Windows Voice Recognition October 20, 2026
    Version: 56.19.0

Zoom tests

  • Content adapts to small screens and zoom.

    When you zoom in 400% on a viewport that is 1280 pixels wide, you can see and interact with all content without needing to scroll both horizontally and vertically.

    Environment Result Last tested macOS Safari October 20, 2026
    Version: 56.19.0     macOS Chrome October 20, 2026
    Version: 56.19.0     Windows Chrome October 20, 2026
    Version: 56.19.0     windows-firefox October 20, 2026
    Version: 56.19.0

Visual tests

  • Color is not the only method used to convey information.

    When you view the page or component, you find that anything shown by color is also communicated through another visual cue like shape or text.

    Environment Result Last tested macOS Chrome October 20, 2026
    Version: 56.19.0

  • Links use more than just color to indicate purpose.

    When you view a link, you see that the link has a text underline and uses the expected VA colors for default, hover, focus, and visited states.

    Environment Result Last tested macOS Chrome October 20, 2026
    Version: 56.19.0

  • Text has sufficient contrast against its background.

    When you use a contrast checker tool to compare the color of text against its background, you find that it has a contrast ratio of at least 4.5:1.

    Environment Result Last tested macOS Chrome October 20, 2026
    Version: 56.19.0

  • Text resizes to 200% without loss of content or functionality.

    When you increase text size up to 200%, all content remains visible and functional without needing to scroll both horizontally and vertically.

    Environment Result Last tested macOS Chrome October 20, 2026
    Version: 56.19.0

  • Interactive elements have sufficient contrast against their surroundings.

    When you use a color contrast checker tool to compare the color of an interactive element against its surroundings, you find it has a contrast ratio of at least 3:1.

    Environment Result Last tested macOS Chrome October 20, 2026
    Version: 56.19.0

  • Icons have sufficient contrast against their background.

    When you use a color contrast checker tool to compare the color of an icon against its background, you find it has a contrast ratio of at least 3:1.

    Environment Result Last tested macOS Chrome October 20, 2026
    Version: 56.19.0

  • Buttons have sufficient contrast against their background.

    When you use a color contrast checker tool to compare the background color of a button against its surroundings, you find it has a contrast ratio of at least 3:1.

    Environment Result Last tested macOS Chrome October 20, 2026
    Version: 56.19.0

Conditional tests

Teams are responsible for verifying these tests in their own context.

  • Headings follow a logical order.

    When you navigate the page by headings, you find that heading levels follow a logical order and don't skip levels.

    Notes: Teams must select the appropriate value for the heading-level prop based on the page heading structure.

  • Link text is clear and descriptive.

    When you read the link text, it is easy to understand both the link's purpose and destination.

  • Headings are descriptive.

    When you read heading text, you find that it accurately describes the topic or purpose of the content that follows.

    Notes: Teams must define the appropriate text for the heading-text prop based on the page heading structure.

  • Every interactive element has a clear name and purpose.

    When you interact with an interactive element such as a link, button, or form input, you can easily understand what it is and what it does based on its accessible name and role.

  • Labels on repeated interactive elements describe their specific purpose.

    When you view a page that has multiple interactive elements with similar functions, you find that each element's label describes its specific purpose and what it applies to.

Edit this page in GitHub (Permissions required)
Last updated: Oct 20, 2026