Toggle
固定や書式設定など、押された状態を保持するボタンに使います。
プレビュー
固定ボタンの状態
アイコンとテキスト、初期状態で押されたボタン、無効状態を比較します。
プレビューを読み込んでいます。
インストール
この Registry を初めて使う場合は、先に 基本設定と共通スタイルの導入 を完了してください。
npx shadcn@latest add @neumorphism-ui/toggle共有 base を一度導入した後、CLI でコンポーネントと依存関係を追加します。
使い方
明確な名前を付け、defaultPressed または制御された pressed を指定します。関連する複数の操作は ToggleGroup にまとめます。
"use client";
import { Toggle } from "@/components/ui/toggle";
export default function Example() {
return <Toggle aria-label="Bold">Bold</Toggle>;
}API リファレンス
押下状態を保持する独立したトグルボタン。 アイコンのみのボタンにラベルを付け、色だけでなく凹面と境界で選択を示します。
| コンポーネント | プロパティ | 型 | デフォルト | 説明 |
|---|---|---|---|---|
Toggle | pressed / defaultPressed | boolean | — | 制御状態または初期状態を指定します。 |
Toggle | size | "sm" | "default" | "lg" | — | コントロールのサイズを選びます。 |
Toggle | disabled | boolean | — | ユーザー操作を無効にします。 |
アクセシビリティ
- 01
アイコンのみのボタンにラベルを付け、色だけでなく凹面と境界で選択を示します。
- 02
render や className を変更する際もラベルと可視フォーカスを保ちます。