Checkbox
Bindable tri-state checkbox with a visible or ARIA-only accessible name.
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.
Interactive example
Loading interactive example
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