フォームと選択@neumorphism-ui/checkbox

Checkbox

透明な native input の上にニューモーフィックなサーフェスを重ね、form 送信とブラウザーのアクセシビリティを維持します。shadcn 形式の onCheckedChange callback とともに、制御・非制御・indeterminate の各状態に対応します。

@neumorphism-ui/checkbox
Registry JSON

プレビュー

インストール

インストール: checkboxnpx shadcn@latest add @neumorphism-ui/checkbox

CLI が npm 依存関係、base token、utils、コンポーネントソースを順番に処理します。

この Registry を初めて使う場合は、先に namespace の設定 を完了してください。

使い方

使い方: インストールnpx shadcn@latest add @neumorphism-ui/checkbox @neumorphism-ui/label

Import

Checkbox の import コード
import { Checkbox } from "@/components/ui/checkbox"
import { Label } from "@/components/ui/label"

Example

Checkbox の使用コード
<div className="flex items-center gap-2">
  <Checkbox id="updates" defaultChecked />
  <Label htmlFor="updates">製品アップデートを受け取る</Label>
</div>

API リファレンス

コンポーネントプロパティ型デフォルト説明
Checkboxcheckedboolean | "indeterminate"—制御された checked 状態または mixed 状態です。
CheckboxdefaultCheckedbooleanfalse非制御時の初期 checked 状態です。
CheckboxonCheckedChange(checked: boolean | "indeterminate") => void—checked 状態が変わったときに呼び出されます。
Checkboxdisabledbooleanfalseinput とポインターによる操作を無効にします。
Checkboxname / value / requirednative input props—form 送信に使用する native checkbox 属性です。

アクセシビリティ

  • 01

    実際の input[type=checkbox] により、form 送信と Space キーによる操作が維持されます。

  • 02

    Label の htmlFor と Checkbox の id を関連付けるか、Checkbox を label 内に配置してください。

  • 03

    indeterminate 状態では aria-checked=mixed と DOM の indeterminate property の両方が設定されます。