Docs Components
Checkbox & Radioexperimental
Pick one or many. A checked box fills with ink and shows a paper checkmark; radios get a dot. Checkboxes wait for Save — if a change should apply the moment you click, use a Switch instead.
States
unchecked— Raised background, ink rule border.checked— Inverse ink fill; paper check glyph (checkbox) or dot (radio).background: color-bg-inverseglyph: color-text-inversedisabled— Strong-border gray, sunken fill; row label goes muted.
API
| Prop | Type | Description |
|---|---|---|
label | string | Renders the control inside a .check-row label. Omit only when a FormField or table header supplies the label. |
…native | InputHTMLAttributes | type=checkbox/radio native input underneath. |
Design specifications
- size
space-4 - border
color-border-rule / border-width-rule - checked-fill
color-bg-inverse - glyph
color-text-inverse - radius-checkbox
radius-xs - radius-radio
radius-full - row-gap
space-2
Guidelines
- shouldRadios always ship as a named group with one option pre-selected where a sensible default exists.
- mustCheckbox toggles data to be submitted; for immediate-effect settings use Switch.
- mustA disabled control that is checked must still show its mark: the glyph drops to muted ink on the sunken fill (declared pair, AA in both themes). Disabled-checked and disabled-unchecked are never visually identical.