Frontend accessibility
The a11y lens on the rendered surface. The code lens already read the source, so a finding here should be one a source read could not produce — naming the element, the mode, the measured value, the fix.
Measure the composited pixel, not the token. Opacity, overlays, backdrop-filter, a
photo behind text and antialiasing on thin weights all change the pair the eye receives,
so a token that passes in the palette can fail where it landed. House convention, and the
commonest false pass here.
When to use
- Judging a screenshot set or live page for accessibility inside a design review.
- A visual surface changed and renders exist in more than one mode.
- Auditing a shipped surface for failures that appear only once composited.
When NOT to use
- No render. Labels, input types, tab order and
aria-*read off the diff belong to web-interface-guidelines-review. - Setting a threshold. apca-contrast and wcag-contrast own contrast; component-sizing-principles owns the height ladder. Cite them, never re-derive them — this lens measures what the render gives the pointer.
- Non-visual diffs — routing, state wiring, backend. Nothing renders; stay silent.
What only the render shows
- Composited contrast. Report the sampled pair and value, then cite the owner: apca-contrast for Lc targets and the primary-model policy, wcag-contrast for the 2.2 thresholds and the points-not-pixels rule. Obey the system's declared primary model and name it; absent one, the pairing fails if either model fails.
- Focus rings, in place. Source shows a ring exists; only the render shows it
survives — clipped by an ancestor
overflow: hidden, drowned against the actual adjacent surface, or gone in forced-colors. SC 2.4.11 Focus Not Obscured (Minimum), AA in 2.2 is separate: sticky chrome hiding the focused control entirely fails even with a perfect ring, so capture the row scrolling under it. Partial occlusion is 2.4.12, AAA. Ring contrast is SC 1.4.11; SC 2.4.13 Focus Appearance is AAA — an enhancement, never an AA failure. Tooltips and hover cards have their own rule: hoverable, dismissible without moving the pointer, persistent (SC 1.4.13, AA). - Hit area, as laid out. SC 2.5.8, AA — 24 by 24 CSS px, exceptions: Inline — a target inline in text, or sized by non-target line-height — never flag an inline link; Spacing — a 24 px circle on each undersized target must miss another target, not its circle, and another undersized target's circle, so a 20 px button 1 px from a 40 px one fails; also Equivalent, User Agent Control, Essential. Icon toolbars fail on spacing more than size; measure the gap. Touch surfaces have a higher platform floor; read that platform's HIG. The ladder behind the height is component-sizing-principles.
- Meaning that can vanish. SC 1.4.1 Use of Color, A — status as red/green with no icon, text or shape; and on a render, meaning carried by a gradient or a shadow, which forced-colors removes outright.
- Names, as exposed. A control that renders as a bare glyph must still expose a
name, so read the accessibility tree rather than
aria-*in the source —aria-labelon a role-less element is never exposed (SC 4.1.2, A), and visual structure the markup does not carry is SC 1.3.1, A.
The modes you must actually look at
A mode not captured is not checked — name the ones you saw.
| Mode | What fails first |
|---|---|
| Light and dark, both primary | Borders, disabled text, shadow-drawn separators |
forced-colors: active |
box-shadow and text-shadow compute to none, background-image to none without a url() — anything drawn as a shadow or gradient is gone. System colours come from native semantics, not ARIA roles |
prefers-contrast: more |
Deliberately subtle borders; placeholder text already near the floor |
prefers-reduced-motion |
CSS transitions usually honour it; JS/WAAPI animation, autoplaying video and carousels usually do not |
| Reflow — SC 1.4.10, AA | 320 CSS px wide (≈ 400% zoom at 1280), no two-dimensional scrolling; 256 CSS px tall when scrolling horizontally |
| Text spacing — SC 1.4.12, AA | No loss of content at line-height 1.5×, paragraph 2×, letter-spacing 0.12em, word-spacing 0.16em: fixed-height buttons, single-line chips |
Motion has two obligations: auto-starting motion over five seconds must be pausable
(SC 2.2.2, A); disabling interaction-triggered motion is SC 2.3.3, AAA.
prefers-reduced-motion is the mechanism, not the criterion; reduced-path rules: motion-continuity.
Silent failures
- A
box-shadowfocus ring. Passes source review and both theme screenshots, gone in forced-colors. Fix:outline+outline-offset(only its colour is forced), or a@media (forced-colors: active)rule. - Reduced motion honoured in CSS only. The
@mediablock exists, the JS animation ignores it, and static screenshots never show it. Check the JS/WAAPI path,<video autoplay>, library defaults. - A clean automated run read as a pass. A checker reports what it can compute — not a ring lost under sticky chrome, meaning in a gradient, or text over a photo.
Verification
- Every finding names element + mode + measured value + the SC with its level, or the skill owning it. No bare "low contrast".
- Contrast findings cite apca-contrast / wcag-contrast, name the system's primary model, and quote a value sampled from the composited render rather than read off a token.
- No AAA criterion (2.4.13, 2.3.3) is reported as an AA failure, and focus was exercised
by tabbing rather than inferred from a
:focus-visiblerule. - Every mode in the table is reported as checked or as not captured, including a clean pass, which must name the modes checked or it is not evidence.
Cross-references
- REQUIRED BACKGROUND: apca-contrast — Lc targets and which model is primary; wcag-contrast — the 2.2 thresholds and the points-not-pixels rule. This lens measures; they own the numbers.
- Target size: component-sizing-principles and spacing-system. Code side: web-interface-guidelines-review — a finding makeable from the diff alone is theirs.
- Siblings: design-system-consistency (off-system, not inaccessible) · visual-polish (passes but reads dull) · designing-elite-ui (the bar). reviewing-design-work orders all four, and orchestrating-elite-agent-qa drives the browser pass producing these renders.
Sources
- WCAG 2.2 — every SC above carries its published level (2.5.8, 2.4.11). 2.4.13 and 2.4.12 are AAA there, not AA.
- CSS Color Adjust 1 is normative for
the forced-colors
box-shadow/text-shadow/background-imagebehaviour; MDN supports the native-semantics point above. Media Queries 5 defines the preference queries. - House convention, not a standard: the composited-pixel and per-mode rules above.