Skip to content

This is an unpublished draft preview that might include content that is not yet approved. The published website is at w3.org/WAI/.

Keyboard Focus Appearance

Goal

The keyboard focus must have a sufficient visual indicator.

Normative Text

Guideline

Users can see which element has keyboard focus.

Foundational Requirements

For each focusable item:

  1. Is the user-agent default focus indicator used?

    1. Yes, the user-agent default indicator is used AND the accessibility support set meets Custom focus indicators. Stop.
    2. No, continue.
  2. Is the focus indicator defined by the author?

    1. Yes, indicator must meet Custom focus indicators. Stop.
    2. No, fail.

Supplemental Requirements

None defined at this time.

Assertions

  • Style guide: The organization has a documented style guide which includes guidance on focus indicators, and a policy that designers and developers are required to follow the style guide. The style guide includes focus indicators that meet one of the baseline scenarios in the decision tree.

We would like to conduct research once we have an initial pass/fail set of examples to see if we are making decisions that support various disabilities. Please get in touch if you could facilitate this research.

What to do

Ensure focusable elements include focus indicators that are visible for people using an input device that relies on the keyboard focus to navigate.

An outline, or indicator which surrounds the focusable element is generally the most easily visible.

All indicators for keyboard-focusable elements must be: