Skip to main content

Visible focus

When an interactive element has keyboard focus, there should be a visible focus state. For those navigating by keyboard, this indicates their current position within the interface—just as a cursor indicates current placement of the mouse.

Note:

Some screen readers offer their own version of a visible focus state. This is not the same as the visible focus state that appears on interactive elements, as screen readers access all content, not just interactive elements.

Two low-fidelity browser screens containing a list of cards, one displaying a border focus on a card, the other displaying a mouse cursor on a card

Because people perceive color differently, the focus state cannot be represented by color alone and must pass a graphical element contrast ratio of 3:1. Esri’s Calcite Design System uses both color and a thick border-stroke in their focus states.

Two Calcite accordions collapsed with the first one displaying a blue 2 px border stroke as a focus indicator

Note:

Focus state and active state are not the same and should not be presented the same visually. Active state indicates a previous selection, whereas focus state indicates the current location of keyboard navigation.

Related criteria

The Web Content Accessibility Guidelines tied to this topic are as follows: