Caroa UI

Checkbox

チェックボックスコンポーネント。

インポート

import { Checkbox } from '@caroainc/ui-components/client'

個別サブパス(バンドルサイズを抑えたい場合):

import { Checkbox } from '@caroainc/ui-components/checkbox'

基本的な使い方

Loading...
<div className="flex items-center gap-2">
  <Checkbox id="terms" />
  <Label htmlFor="terms">利用規約に同意する</Label>
</div>

デフォルトでチェック

Loading...
<Checkbox id="checked" defaultChecked />

不確定状態(indeterminate)

checked="indeterminate"を指定すると、チェックマークの代わりにマイナス記号が表示されます。「一部の子項目のみ選択されている」状態(全選択チェックボックス等)を表現する際に使用します。

Loading...
<Checkbox checked="indeterminate" />

無効状態

Loading...
<Checkbox disabled />
<Checkbox disabled defaultChecked />

Props

PropTypeDefaultDescription
checkedboolean | 'indeterminate'-チェック状態(制御コンポーネント)。indeterminate指定時はマイナス記号を表示
defaultCheckedboolean-初期チェック状態
onCheckedChange(checked: boolean) => void-チェック状態変更時のコールバック
disabledbooleanfalse無効状態

On this page