← Components/primitives

Checkbox

Carbon-spec checkbox. Wraps Radix Checkbox for ARIA + keyboard. Adds Carbon's label / helper text / state structure on top.

primitivesstablea11y: untested3/3 coverageEdit on GitHub ↗
primitives-checkbox--defaultOpen all variants →

When to use

  • Multi-of-many selection — any subset of options can be on at once.
  • Single boolean toggle that lives inside a form (consent, "remember me", subscribe).
  • Indeterminate states (e.g. "select all" when only some children are selected).

When not to use

  • Single-of-many selection → use `RadioButton` inside a RadioButtonGroup.
  • Settings-row on/off control with explicit Off / On text → use `Toggle`.
  • Compact iOS-style switch → use `Switch`.