Checkbox
A control that allows the user to toggle between checked and not checked states. Built on Radix UI Checkbox for full accessibility.
Preview
Default
Amenities Filter
Disabled
Usage
tsx
import { Checkbox } from "zostel-ui";
import { Label } from "zostel-ui";
<div className="flex items-center gap-2">
<Checkbox id="terms" />
<Label htmlFor="terms">Accept terms and conditions</Label>
</div>
{/* Controlled */}
<Checkbox
checked={isChecked}
onCheckedChange={setIsChecked}
/>Props
| Prop | Type | Default | Description |
|---|---|---|---|
checked | boolean | 'indeterminate' | false | The controlled checked state. |
defaultChecked | boolean | false | The default checked state when uncontrolled. |
onCheckedChange | (checked: boolean | 'indeterminate') => void | — | Called when the checked state changes. |
disabled | boolean | false | Disables the checkbox. |
className | string | "" | Additional CSS classes to apply. |
checkedType:
boolean | 'indeterminate'Default: false
The controlled checked state.
defaultCheckedType:
booleanDefault: false
The default checked state when uncontrolled.
onCheckedChangeType:
(checked: boolean | 'indeterminate') => voidDefault: —
Called when the checked state changes.
disabledType:
booleanDefault: false
Disables the checkbox.
classNameType:
stringDefault: ""
Additional CSS classes to apply.