Checkbox Group

Loading...

Installation

Add the component with the CLI.

npx shadcn@latest add @intentui/checkbox

Composed components

When you install this component via the CLI, it automatically loads all composed components, so you don’t need to add them individually.

Manual installation

Install the dependencies, then copy the component source into your project.

npm install react-aria-components @heroicons/react cn

Anatomy

import { CheckboxField, CheckboxGroup, Checkbox } from "@/components/ui/checkbox"
import { Description, Label } from "@/components/ui/field"
<CheckboxGroup defaultValue={["delete"]}>
  <Label>User Permissions</Label>
  <Description>
    Select the permissions you want to grant to the user.
  </Description>
  <CheckboxField value="read">
    <Checkbox>Read</Checkbox>
    <Description>
      Can view content but cannot make changes.
    </Description>
  </CheckboxField>
  <CheckboxField value="write">
    <Checkbox>Write</Checkbox>
    <Description>
      Can create and modify existing content.
    </Description>
  </CheckboxField>
  <CheckboxField value="delete">
    <Checkbox>Delete</Checkbox>
    <Description>Can permanently remove content.</Description>
  </CheckboxField>
  <CheckboxField value="admin">
    <Checkbox>Admin</Checkbox>
    <Description>
      Full access to all actions and settings.
    </Description>
  </CheckboxField>
</CheckboxGroup>

Examples

Description

Add a description to the checkbox group using the description prop.

Loading...

Validation

The checkbox group is in an error state.

Loading...

Indeterminate

The checkbox group is in an indeterminate state.

Loading...

Controlled

Control the checkbox group value with the value prop.

Loading...

Uncontrolled

Control the checkbox group value with the defaultValue prop.

Loading...

Disabled

Disable the entire checkbox group by passing the isDisabled prop.

Loading...

Read only

When you need just a read-only checkbox group, pass the isReadOnly prop.

<CheckboxGroup isReadOnly/>

Component API

Checkbox

Checkbox extends the React Aria Components <CheckboxButton> component.

classNamestring

CheckboxGroup

CheckboxGroup extends the React Aria Components <CheckboxGroup> component.

classNamestring

See the React Aria for the full API reference.

Design