Components · Form Controls

Checkbox

Lets people turn independent options on or off.

Automated a11y scan passing Element: <input type="checkbox">

Component Workbench

Switch between the live interactive preview, syntax-highlighted implementation code, copyable AI coding agent prompt, and designer anatomy blueprint.

Checkbox · Canonical Spec

When to use it

Do

  • Use it when several options can be chosen.
  • Use the mixed state only for a parent of partly selected items.

Don't

  • Use it when only one option is allowed. Use Radio instead.
  • Use it for settings that apply instantly. Use Switch instead.

Accessibility & Keyboard Interaction

Requirements for using this component accessibly, following the W3C ARIA Authoring Practices Guide.

Interaction / KeyBehavior & Compliance Requirement
SpaceToggles checked state natively.
Target Size28x28px hit target exceeds WCAG 2.5.8 24px minimum.

Tokens

Values update with the current theme.

RoleTokenCurrent value
Checked Fill--as-semantic-color-interactive-primary
Corner Radius--as-radius-sm
Esc
↑↓ navigateEnter openEsc close