Resources · 57

Dialogs and keyboards: test the focus journey

Check opening, movement, closing and context restoration in interfaces that interrupt a task.

· 4 min

Empty digital forensics bench with storage devices and precision tools AI-generated editorial illustration

What this guide helps achieve

  • Choose the right component
  • Place understandable focus
  • Allow closing
  • Restore context

Quick check

  • Is a modal necessary?
  • Where does opening focus land?
  • Is the background actually inert?
  • Can the dialog close by keyboard?
  • Where does focus return if the trigger disappears?

Step-by-step method

  1. 01

    Choose the interruption

    Decide whether information needs a modal or can remain in the page. Separate modal dialogs, panels and menus. Prefer appropriate native elements and check behaviour; an ARIA role does not create interactions automatically.

    Deliverable: component choice and rationale.

  2. 02

    Name and open

    Connect an accessible name to a visible heading. Place focus appropriately: at the start of structured content, a useful field or a safe action depending on the task. Opening should not scroll the beginning out of view.

    Deliverable: tested opening.

  3. 03

    Navigate by keyboard

    Under W3C’s modal-dialog pattern, Tab and Shift+Tab remain inside and outside content is inert. Verify visible focus, logical order and no traps in nested controls.

    Deliverable: forward and reverse navigation.

  4. 04

    Close and restore

    Provide visible closing and expected Escape behaviour. Return focus to the trigger or a logical step if the trigger no longer exists. After submission, users should find what changed and what can happen next.

    Deliverable: restored focus and context.

  5. 05

    Test errors and space

    Include long messages, invalid fields, mobile keyboards and zoom. Scrolling must not permanently hide actions or headings. Errors should be understandable and reachable without losing entered values.

    Deliverable: narrow-screen edge cases.

  6. 06

    Check in the page

    Test the integrated component with keyboard and assistive technology, not only in an isolated demo. Check duplicate opening and focus after repeated closing. Local acceptance alone does not establish WCAG certification.

    Deliverable: acceptance record and known limits.

Four situations for testing the method

Fictional teaching cases. Each situation connects a signal, a check and a decision bounded by evidence; none represents a client outcome.

Fictional situationConcrete checkDecision and limit
A shared component needs shared focus behaviour — Two teams use the same visual dialog, but one implementation lets keyboard users reach the page behind it.Test opening, focus movement, dismissal and return to the trigger in each deployed implementation.Document behaviour with the component and prevent reuse of a variant that makes the journey inconsistent.
A component style does not validate its behaviour — A button styled after a design system opens a convincing dialog, but Escape does not dismiss it and focus is lost.Compare the actual component with the chosen interaction pattern using keyboard and relevant assistive technology.Assess the full integration. A design-system name or visual resemblance is not evidence of accessibility.
Test a micro-interaction without a pointer — Help appears when an icon is hovered but remains absent when the same icon receives keyboard focus.Identify the essential information and check its availability on focus, readability and dismissal without moving a mouse.Fix access to the information before polishing animation. Information needed for the task cannot depend on hover alone.
Replay the task after a usability redesign — A redesigned journey has fewer screens, but its confirmation dialog traps focus after a validation error.Replay error, correction, cancellation and reopening; record focus placement after every transition.Compare task completion and error recovery. Fewer screens alone do not establish better usability.

Reusable worksheet

Complete with your authorised observations. These fields are a working template, not observed results.

FieldInformation to record
OpeningTrigger, heading and initial focus
JourneyTab, Shift+Tab, inert background and visible focus
ClosingEscape, button and logical return
LimitsTested zoom, long content, errors and assistance

Worked example

Illustrative situation

Fictional example: a dialog confirms row deletion and its opening button disappears.

Decision and expected evidence

After confirmation, focus returns to a logical next element or the list heading, with an announced result and a visible next step.

Distinguish the mechanisms

MechanismPurposeCheck or limitation
Modal dialogInterrupt for a bounded taskInert background and contained focus
Nonmodal panelKeep context availableCoherent focus movement
Page sectionPresent continuing informationOften easier to consult

Management indicators

IndicatorWhat it measuresFirst action
Completed keyboard journeysTasks performed without a pointerFix blockers
Correct focus returnsClosures restoring useful contextHandle missing triggers
Tested edge statesZoom, errors and long contentDocument omissions

Common pitfalls

  • Adding aria-modal without inert content
  • Losing focus after closure
  • Blocking Escape without a clear exit
  • Testing only mouse opening

Frequently asked questions

Is a native dialog enough?

It provides useful behaviour, but naming, initial focus, content, errors and integration still require testing.

Should the first button receive focus?

Not always. The appropriate point depends on content and task, especially for irreversible decisions.

Can automation validate the journey?

It detects some defects, but comprehension, useful order and restored context need manual acceptance.

Official references

References consulted: . The method and worksheet propose checks to adapt to your context; they do not constitute certification.