Checkbox
A single binary choice, with an optional description and a third indeterminate state.
With a description
Use the description for the consequence of ticking the box, not a restatement of the label.
States
Indeterminate parent
indeterminate is presentational only: the underlying input is still either checked or not, so drive it from whether the children are partly selected.
Props
Every other native input attribute is forwarded to the underlying <input type="checkbox">.
| Prop | Type | Default | Description |
|---|---|---|---|
| label | string | Text rendered beside the box. | |
| description | string | Supporting line under the label. | |
| indeterminate | boolean | false | Renders the dash state, for a parent whose children are partly selected. |
| checked | boolean | Controlled checked state. | |
| defaultChecked | boolean | Uncontrolled initial state. | |
| disabled | boolean | false | Disables the input. |
| onChange | (e: ChangeEvent<HTMLInputElement>) => void | Fires on toggle. |