Skip to content

a11y(2.5.8): checkbox — add min-h-6 min-w-6 to Label for 24×24 hit area#3545

Merged
ardiewen merged 4 commits into
mainfrom
wcag/2.5.8-labelhidden-checkbox
Jun 17, 2026
Merged

a11y(2.5.8): checkbox — add min-h-6 min-w-6 to Label for 24×24 hit area#3545
ardiewen merged 4 commits into
mainfrom
wcag/2.5.8-labelhidden-checkbox

Conversation

@rosanusi

@rosanusi rosanusi commented Jun 11, 2026

Copy link
Copy Markdown
Contributor

Description

When labelHidden={true} the <Checkbox> Label's visible width collapses to ~16 px (the surrogate h-4 w-4 box), giving a clickable region of ~16×18 CSS px — below the WCAG 2.5.8 (Target Size Minimum, Level AA) 24×24 requirement.

Fix: add min-h-6 and min-w-6 (min-height: 24px; min-width: 24px) to the Label's class array in checkbox.svelte. This ensures the <label> element — which is the actual click target wrapping the sr-only native input — is at least 24×24 for all consumers. With a visible label the Label continues to grow with its text content as before; only the floor changes.

The alternative of enlarging the visual surrogate from h-4 w-4 to h-6 w-6 was not chosen — it would change the checkbox's appearance across every consumer and require updating the inner icon positioning.

Changed file: src/lib/holocene/checkbox.svelte — 2 lines added to the Label class array.

This fix cascades to all Checkbox consumers in both ui-main and cloud-ui-main (via the @temporalio/ui tarball).

Screenshots

No visual change for labelHidden=false (label text keeps the Label wider than 24 px). For labelHidden=true the invisible click region grows from ~16×18 to 24×24 around the same 16×16 visual surrogate.

Design

No design changes. The 24-px floor is transparent to sighted users; the 16×16 checkbox appearance is unchanged.

Testing

  • Find a <Checkbox labelHidden> consumer (e.g. row-select checkboxes on the workflows list).
  • Inspect the <label> element: getBoundingClientRect() returns height ≥ 24 and width ≥ 24.
  • Tap-test on a touch device: confirm reliable activation.
  • Tab to a labelHidden checkbox: focus-visible ring appears on the visual surrogate.
  • labelHidden=false consumer (e.g. namespace settings auth form): checkbox rows visually unchanged.
  • axe-core: no target-size violations on labelHidden checkboxes.
  • Storybook checkbox stories: spot-check both labelHidden and default variants.

Checklist

  • No new i18n keys
  • No visual change to checkbox appearance
  • Cascades to cloud-ui-main via @temporalio/ui tarball

Docs

No documentation changes required.

A11y-Audit-Ref: 2.5.8-labelhidden-checkbox


Correction (post-review)

Measured the actual <label> (the click target) before/after; the "no visual change" statements above need amending:

  • Every checkbox row grows ~6px taller — not only labelHidden. min-h-6 raises the height floor to 24px, but the <label> is naturally only ~18px tall (leading-[18px] + the 16px surrogate + its 1px border = 18×18). So visible-label checkboxes go 153×18 → 153×24 as well; the labelHidden=false row is not unchanged.
  • The visual surrogate is 18×18 (not 16×16) — h-4 w-4 (16px) plus border with box-content. The glyph itself is unchanged.
  • Centering added: with min-w-6, a labelHidden label is 24px wide and the 18px surrogate was flush-left (6px of dead space). Added justify-center only when labelHidden, so the checkbox is centered in the 24×24 target (3px all sides). Visible-label checkboxes keep the surrogate left, next to the text.

Decision (with reviewer): keep the 24px floor on all checkboxes — it guarantees a 24px-tall target everywhere for 2.5.8; the ~6px height growth on labelled rows is accepted.

Also merged latest main (resolved a scripts/a11y/manifest.yml append conflict with #3544).

When labelHidden=true the Label's visible width collapses to ~16 px
(the surrogate width), giving a ~16×18 px hit area below the WCAG
2.5.8 24×24 minimum. Adding min-h-6 / min-w-6 (24 px each) to the
Label class ensures the clickable region is at least 24×24 regardless
of slot content. With a visible label the Label still expands with its
text content as before.

A11y-Audit-Ref: 2.5.8-labelhidden-checkbox

Co-Authored-By: Claude Sonnet 4.6 <[email protected]>
@vercel

vercel Bot commented Jun 11, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
holocene Ready Ready Preview, Comment Jun 17, 2026 10:25pm

Request Review

@github-actions github-actions Bot added a11y Accessibility audit PR a11y:broken-ref A11y-Audit-Ref slug not in manifest labels Jun 11, 2026
@temporal-cicd

temporal-cicd Bot commented Jun 11, 2026

Copy link
Copy Markdown
Contributor
Warnings
⚠️

📊 Strict Mode: 3 errors in 1 file (0.3% of 906 total)

src/lib/holocene/checkbox.svelte (3)
  • L33:13: Type 'undefined' is not assignable to type 'T'.
  • L34:13: Type 'undefined' is not assignable to type 'T[]'.
  • L13:12: Argument of type '$$Props' is not assignable to parameter of type '{ id?: string | undefined; checked?: boolean | undefined; label?: string | undefined; labelHidden?: boolean | undefined; indeterminate?: boolean | undefined; disabled?: boolean | undefined; ... 5 more ...; class?: string | undefined; }'.

Generated by 🚫 dangerJS against 19ebad2

@rosanusi
rosanusi marked this pull request as ready for review June 15, 2026 16:44
@rosanusi
rosanusi requested a review from a team as a code owner June 15, 2026 16:44
…erious

Adds the audit fix-doc manifest entry referenced by this PR's
A11y-Audit-Ref trailer, so the triage workflow resolves the slug
instead of labeling it a11y:broken-ref.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
@github-actions github-actions Bot added a11y:bucket-1 Bucket 1: design-mergeable, CSS / tokens a11y:sc-2.5.8 and removed a11y:broken-ref A11y-Audit-Ref slug not in manifest labels Jun 16, 2026
@ardiewen

ardiewen commented Jun 17, 2026

Copy link
Copy Markdown
Contributor

@rosanusi you may want to examine this one too:

Example 1:
Screenshot 2026-06-17 at 2 20 51 PM

Example 2:
Screenshot 2026-06-17 at 2 20 37 PM

It appears the checkbox is left aligned inside of its tap target ("label").

ardiewen and others added 2 commits June 17, 2026 18:23
…n-checkbox

# Conflicts:
#	scripts/a11y/manifest.yml
With min-w-6, a labelHidden checkbox's <label> collapses to 24px wide while the
visible 18px surrogate sat flush-left (6px of dead space on the right). Add
justify-center only when labelHidden so the surrogate is centered in the hit
area (3px on all sides). Visible-label checkboxes are unaffected — the surrogate
stays left, next to its text.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
@ardiewen
ardiewen merged commit d401123 into main Jun 17, 2026
20 checks passed
@ardiewen
ardiewen deleted the wcag/2.5.8-labelhidden-checkbox branch June 17, 2026 22:33
laurakwhit added a commit that referenced this pull request Jun 23, 2026
Auto-generated version bump from 2.51.0 to 2.51.1

Specific version: 2.51.1

Changes included:
- [`c848ec54`](c848ec5) fix(a11y): announce workflow / event status on timeline graph nodes (WCAG 1.4.1) (#3443)
- [`af6b12a9`](af6b12a) fix(deployments): align version/status/compute badges in worker deployments table (#3489)
- [`df86587c`](df86587) Add SDK version to standalone activity details (#3447)
- [`59695290`](5969529) Use shared FilterBar component for workflows (#3448)
- [`ded94469`](ded9446) Set display contents in wrapper div if no afterLabel in Input component (#3513)
- [`d7e5eb43`](d7e5eb4) fix(standalone-activities): decode failure encodedAttributes in activity detail (#3507)
- [`81a255a9`](81a255a) fix(DT-4151): fix bottom nav scrollability and double-menu on mobile (#3514)
- [`368f646e`](368f646) Fix exports to work properly with vite8 (#3519)
- [`231bdaff`](231bdaf) chore(deps-dev): bump vitest from 3.2.4 to 3.2.6 (#3509)
- [`1de44ea6`](1de44ea) fix(workers): soften no-workers-polling alert for serverless worker deployments (#3524)
- [`689955a8`](689955a) fix(DT-4080): surface error when validate connection has no compute config, warn on set current (#3516)
- [`93323db9`](93323db) feat(DT-4078): Add Set Ramping Version to Worker Deployment Versions (#3508)
- [`9d3450c0`](9d3450c) fix(DT-4081): surface task queue not registered error in validate connection modal (#3517)
- [`b7f56237`](b7f5623) feat(DT-4079): miscellaneous WD UI fixes (#3511)
- [`83b2d4ec`](83b2d4e) feat(deployments): simplify create worker deployment UX (#3518)
- [`ccb4cb73`](ccb4cb7) Standalone Activity write guards (#3534)
- [`ab20ef03`](ab20ef0) Worker insights UI updates (#3520)
- [`aaf63bdc`](aaf63bd) [wcag] Replace text-[12px] with text-xs in DatePicker action buttons (SC 1.4.4) (#3525)
- [`743be902`](743be90) a11y(2.4.3): replace flex-wrap-reverse with flex-wrap on workflow history toolbar (#3527)
- [`41b73e87`](41b73e8) a11y(2.4.2): ui-main — set distinct, descriptive titles on login/signin, task-queues list, and activity-workers sub-tab (#3535)
- [`3d64cdbf`](3d64cdb) [WCAG 2.4.3] group-details-row — remove redundant outer focus stop on <g> wrapper (#3537)
- [`883e5db1`](883e5db) a11y(2.4.6): datepicker — replace empty label with translate('common.start') (#3543)
- [`9da915e2`](9da915e) a11y(2.4.5): import history — add back-link to Import landing page (#3542)
- [`ca4c1d61`](ca4c1d6) Cache new Intl.DateTimeFormat (#3565)
- [`38376e4d`](38376e4) Fix required activity timeout inputs on Start a Standalone Activity form (#3567)
- [`49d7c9e4`](49d7c9e) Use separate copy for title vs menu item (#3568)
- [`3c7dcdc3`](3c7dcdc) a11y(2.5.8): pagination — grow caret buttons from 12×12 to 24×24 CSS px (#3547)
- [`b5171825`](b517182) a11y(2.5.8): chip — pad remove button to 24×24 CSS px minimum (#3544)
- [`1fea5d5c`](1fea5d5) a11y(2.1.1): fake-button widgets — replace deprecated onkeypress with onkeydown handling Enter and Space (#3528)
- [`5bf09000`](5bf0900) a11y(2.1.1): navigation primitives — replace hover-only CSS :after label tooltip with focusable Tooltip (#3529)
- [`deed43f0`](deed43f) a11y(2.1.1): event summary row — add keyboard-accessible expand control alongside the mouse-only <tr onclick> (#3526)
- [`d401123e`](d401123) a11y(2.5.8): checkbox — add min-h-6 min-w-6 to Label for 24×24 hit area (#3545)
- [`aef4166f`](aef4166) [a11y] Expose toggled state via aria-pressed on ToggleButton (#3559)
- [`797f8831`](797f883) Show single attempt in Standalone Activity details (#3572)
- [`893bc58c`](893bc58) feat(DT-4183): Add Tabs (Primitive) (#3574)
- [`323c1993`](323c199) Date picker input field bug/kt (#3522)
- [`3ac34ce2`](3ac34ce) Various serverless UI updates (#3573)
- [`f365416a`](f365416) a11y(2.1.1): ZoomSvg — add keyboard pan/zoom controls so the workflow family tree is operable without a mouse (#3530)
- [`feb6897e`](feb6897) Fix gaps in slot cards on worker details page (#3580)
- [`b3c80072`](b3c8007) Remove font weight on cache size (#3583)
- [`0e7337ea`](0e7337e) Bump API to v1.62.14 (#3575)

Co-authored-by: laurakwhit <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

a11y:bucket-1 Bucket 1: design-mergeable, CSS / tokens a11y:sc-2.5.8 a11y Accessibility audit PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants