Checkbox
Bindable tri-state checkbox with a visible or ARIA-only accessible name.
Loading interactive example
Choose Checkbox for an independent option or multi-selection. New code supplies exactly one accessible name through `label`, `aria-label`, or `aria-labelledby`. The optional-label branch exists only for source compatibility with 0.19. Do not create an unnamed control. Selection marks fade and scale. Reduced motion shows the new state immediately.
API
Inherited prop contracts
AccessibleNameRequires exactly one accessible name:label,aria-label, oraria-labelledby.LegacyOptionalLabelCheckboxThis shared prop contract also applies.
| Member | Type | Kind | Required | Default |
|---|---|---|---|---|
aria-label | string | prop | No | undefined |
aria-labelledby | string | prop | No | undefined |
checked | boolean | binding | No | false |
disabled | boolean | prop | No | false |
indeterminate | boolean | binding | No | false |
label | string | prop | No | undefined |
onCheckedChange | (checked: boolean) => void | callback | No | undefined |
size | ControlSize | prop | No | 'md' |
Source
Loading source