Forms
Checkbox
Selects independent options with optional card presentation.
idle
Usage
Examples
Notification preferences
Choose which updates you want to receive.
Control states
Compare mixed, unavailable, invalid, and alternate sizes.
Recommendations
| Guidance | Practice |
|---|---|
| Do | Use a visible label for each independent choice. Put explanations beside the option they describe. |
Usage boundaries
| Guidance | Boundary |
|---|---|
| Scope | Use Radio Group for mutually exclusive choices. Use Switch for a setting that takes effect immediately. |
API reference
Public props from @mizen-labs/ui. Use exported prop types for the complete TypeScript contract.
| Prop | Type | Default | Description |
|---|---|---|---|
| | false | Controls the checked state. |
| | false | Sets the initial checked state. |
| | false | Shows a mixed state, often for a partial group selection. |
| | false | Prevents interaction. |
| | false | Marks the control invalid for the rendered state. |
| | false | Prevents changes while keeping the value submitted. |
| | "default" | Selects the control size. |