Skip to main content
Tu navegador es demasiado antiguo para mostrar este sitio correctamente. Actualiza a la última versión de Chrome, Edge, Firefox o Safari.
Volver al blog
TestingKeyboardQA

How to Test for Keyboard Accessibility: A Developer's Guide

How to test keyboard accessibility by hand and with automated tools, so your website works without a mouse and meets WCAG 2.1.1.

AccessiSight team
Accessibility engineering
1 de agosto de 2026

Why Keyboard Accessibility Matters

Many users rely on a keyboard, rather than a mouse or trackpad, to navigate the web. This includes users with motor disabilities or tremors, and people who simply prefer keyboard shortcuts. Screen reader users also depend on keyboard operability.

WCAG Success Criterion 2.1.1 Keyboard (Level A) mandates that all functionality must be operable through a keyboard interface.

Manual Keyboard Testing Basics

The basic test is simple. Put your mouse aside and try to use your website with only these keys:

  • Tab: Move focus to the next interactive element (links, buttons, form fields).
  • Shift + Tab: Move focus to the previous interactive element.
  • Enter / Return: Activate links and buttons.
  • Spacebar: Activate buttons, toggle checkboxes, and scroll the page down.
  • Arrow Keys: Navigate within components (like radio button groups, dropdown menus, sliders, and tabs).
  • Escape: Close modals, dropdowns, and cancel actions.

What to Look For During Testing

While navigating with the keyboard, ask yourself these questions:

1. Is the Focus Indicator Visible? (WCAG 2.4.7)

As you Tab through the page, can you easily see which element currently has focus? The browser's default outline is often insufficient; ensure your CSS provides a clear, highly visible focus ring (e.g., :focus-visible { outline: 2px solid blue; }).

2. Is the Focus Order Logical? (WCAG 2.4.3)

Does the Tab sequence follow the visual layout of the page (usually left-to-right, top-to-bottom)? Elements manipulated by CSS (like float or flex-direction: row-reverse) can cause the visual order to differ from the DOM order, creating a confusing keyboard experience.

3. Are There Any Keyboard Traps? (WCAG 2.1.2)

If you Tab into a component (like a modal dialog or a complex widget), can you Tab your way back out? A "keyboard trap" occurs when focus cannot be moved away from an element using standard keyboard navigation.

4. Can I Access All Functionality?

Can you open menus, submit forms, dismiss alerts, and trigger custom interactions without a mouse? Custom UI components (like custom select dropdowns or drag-and-drop interfaces) often fail this test if not built with ARIA keyboard support in mind.

Automated Keyboard Testing

Manual testing is still essential, but automated tools can cover more pages. AccessiSight's KITS (Keyboard Interaction Telemetry Simulator) engine presses real keys (Tab, Shift+Tab, Enter, Space, Escape and the arrow keys) in a real browser. It traces the focus order, tests for keyboard traps, and checks that interactive elements can be reached with the Tab key.

Preguntas frecuentes

Should I use tabindex="1" to fix the focus order?

No. Avoid using tabindex values greater than 0. It creates a brittle, confusing tab sequence that breaks the logical reading order. Instead, rearrange the HTML source code to match the desired visual and logical order.

What is the difference between :focus and :focus-visible?

:focus applies styles whenever an element receives focus, regardless of how it got there (mouse click or keyboard). :focus-visible only applies styles when the browser determines the user needs a visible indicator (usually when navigating via keyboard), so mouse users don't see an outline on every click.