# 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.

## API

The package declarations define these public members.

### Inherited prop contracts

- `AccessibleName` — Requires exactly one accessible name: `label`, `aria-label`, or `aria-labelledby`.
- `LegacyOptionalLabelCheckbox` — This shared prop contract also applies.

| Member | Type | Kind | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `aria-label` | `string` | prop | No | `undefined` | No additional description. |
| `aria-labelledby` | `string` | prop | No | `undefined` | No additional description. |
| `checked` | `boolean` | binding | No | `false` | No additional description. |
| `disabled` | `boolean` | prop | No | `false` | No additional description. |
| `indeterminate` | `boolean` | binding | No | `false` | Shows a mixed state for partial group selection. |
| `label` | `string` | prop | No | `undefined` | No additional description. |
| `onCheckedChange` | `(checked: boolean) => void` | callback | No | `undefined` | No additional description. |
| `size` | `ControlSize` | prop | No | `'md'` | No additional description. |

## Related

- [Label](/docs/components/label): Visible form label with required-state treatment.
- [Input](/docs/components/input): Single-line field with internal or external labeling, hint, error, icons, and password reveal.
- [Switch](/docs/components/switch): Bindable binary switch with visible or aria-only labeling.