Accessibility

Keyboard order is part of product direction

A practical field note from Jimmy Design about making complicated digital services easier to understand and maintain.

This article offers general product-design information. It is not legal, financial, insurance or accessibility compliance advice.

Order communicates structure

Keyboard focus order is not a technical afterthought. It reveals the product’s reading sequence and determines whether actions, explanations and errors form a coherent journey. A visual composition that depends on columns or overlays may become confusing when focus follows source order. Decide the semantic sequence first, then arrange it visually.

Review prompt

Review the decision, supporting source, responsible owner, failure path and next update for this specific part of the journey. Test it with realistic content and record any unresolved assumption before release.

Use native elements

Buttons, links, headings, inputs and lists carry behaviour that custom containers do not. Native controls reduce the amount of code required for keyboard, screen reader and form support. A clickable card should not become a nest of competing actions. Choose one primary destination or provide clearly separated controls with meaningful names.

Review prompt

Review the decision, supporting source, responsible owner, failure path and next update for this specific part of the journey. Test it with realistic content and record any unresolved assumption before release.

Keep focus visible

A person should always know which control will respond. Focus indicators need sufficient contrast and must not be clipped by overflow or covered by sticky elements. Do not remove outlines without an equally visible replacement. Test high zoom and forced-colour modes, where subtle shadows and brand colours may disappear.

Review prompt

Review the decision, supporting source, responsible owner, failure path and next update for this specific part of the journey. Test it with realistic content and record any unresolved assumption before release.

Manage dynamic changes

Drawers, dialogs and inline updates change the focus landscape. On open, move focus only when the new context requires it; contain it in a modal dialog; return it to the triggering control on close. Announce meaningful status changes without repeating every decorative update. Preserve user input when validation fails.

Review prompt

Review the decision, supporting source, responsible owner, failure path and next update for this specific part of the journey. Test it with realistic content and record any unresolved assumption before release.

Reflow without reordering meaning

Responsive layouts often move content across columns. CSS visual order should not contradict DOM and focus order. Test at narrow widths, 200 percent zoom and with long translated strings. If a sidebar becomes an accordion, confirm that headings and controls remain in a logical sequence without duplicated navigation.

Review prompt

Review the decision, supporting source, responsible owner, failure path and next update for this specific part of the journey. Test it with realistic content and record any unresolved assumption before release.

Make it an acceptance criterion

Keyboard review belongs in design critiques and release checks, not only a late audit. Document the expected sequence for complex components, error summaries and menus. Test with standard keys and without a mouse. Record defects as product-flow problems because they often reveal ambiguity that affects everyone.

Review prompt

Review the decision, supporting source, responsible owner, failure path and next update for this specific part of the journey. Test it with realistic content and record any unresolved assumption before release.

A route-level keyboard review

Start at the browser chrome and complete the primary journey using only standard keyboard commands. Record every unexpected jump, hidden control, focus trap and point where visible order disagrees with interaction order. Repeat after validation errors and dynamic updates. The test should include opening and closing navigation, selecting options, reading help, submitting, correcting and returning—not merely tabbing through the header once.

Complex cards and nested actions

A large clickable card containing favourites, menus and links often creates ambiguous focus and speech output. Decide whether the card has one destination or several independent actions. Use a real heading and explicit links or buttons. Keep target sizes generous without overlaying an invisible link across interactive children. On mobile and desktop, the visual grouping should match the semantic relationship rather than relying on hover alone.

Forms and errors

Place labels in the programmatic name, describe formats before entry and connect additional help with the control. On submit, provide an error summary that links to each invalid field while preserving all valid input. Move focus deliberately to the summary when it is the new task, then let the person proceed in document order. Do not announce errors on every keystroke when the result becomes noisy or premature.

Menus, drawers and dialogs

A mobile drawer should be absent from focus when closed. Opening it should expose a logical sequence and a clear close control; closing should restore focus to the menu button. Modal dialogs need an accessible name, contained focus, Escape behaviour when safe and a return target. Avoid using a dialog for ordinary page content simply to achieve a visual overlay.

Evidence for release

Document browser, viewport, zoom level, input method and assistive technology used for each check. Capture the expected sequence for custom components and the result after errors or route changes. Automated rules can identify missing names and invalid markup, but they cannot prove that order tells a coherent story. Keep manual keyboard acceptance in the definition of done for every changed journey.

A focused workshop format

Bring the people who own the policy, interface, content, operational handoff and support response. Begin by writing the central accessibility decision without screen names. Mark every statement that needs evidence, then walk a realistic scenario through the service. Capture disagreements as assumptions with owners rather than resolving them through visual preference. End with the smallest prototype or source check able to reduce the uncertainty.

Materials and output

Use representative content, a route map, source register and acceptance checklist. The useful output is a decision record: what the team believes, which evidence supports it, where the service can fail, who owns recovery and what will trigger another review. Avoid producing a polished journey map that hides unresolved rules or implies certainty the group did not establish.

Edge cases to include

Include a first-time visitor, a returning person with saved state, a narrow mobile viewport, keyboard-only operation, slow or interrupted service, changed source information and an unavailable downstream owner. Test cancellation and reversal as deliberately as completion. Where the subject is regulated or consequential, ask a qualified domain specialist to verify claims; interface review cannot replace that responsibility.

Definition of ready

The work is ready to move forward when the audience decision is stable enough to explain, consequential statements have accountable sources, the complete route includes recovery, and the team can name what it will verify after release. Remaining assumptions are visible with owners and review dates. This is not a guarantee of outcome; it is a practical threshold for responsible iteration.

Questions to take into the next review

  • What decision is the person making, and what consequence follows?
  • Which statement needs a source, owner and freshness rule?
  • Where can context be lost during a channel or service handoff?
  • What recovery route exists when the expected path fails?
  • Which measurement will change an owned product decision?