Radio
Radioは、複数の選択肢から一つだけを選択するためのフォームコントロールです。 RadioGroupでグループ化し、排他的選択を提供します。
2
Weights
3
Sizes
Single
Selection
Radix
Base
Playground
Preview
Dvertical16px
Size
Color
Weight
Items
Direction
Options
<RadioGroup
defaultValue="option-1"
>
<RadioGroupItem
value="option-1"
label="Option 1"
/>
<RadioGroupItem
value="option-2"
label="Option 2"
/>
<RadioGroupItem
value="option-3"
label="Option 3"
/>
</RadioGroup>Sizes
smサークル14px
ドット6px
フォント12px
Gap6px
クリック24px
defaultサークル16px
ドット8px
フォント14px
Gap8px
クリック32px
lgサークル20px
ドット10px
フォント16px
Gap10px
クリック36px
| Size | サークル | ドット | フォント | Gap | クリック領域 | プレビュー |
|---|---|---|---|---|---|---|
sm | 14px | 6px | 12px | 6px | 24px | |
default | 16px | 8px | 14px | 8px | 32px | |
lg | 20px | 10px | 16px | 10px | 36px |
Features
With Field
Fieldコンポーネントと組み合わせることで、disabledStatesを自動的に継承します。
States
Default
Disabled
API
Component Structure
RadioGroup— Radix RadioGroup.ItemProps
.ItemPropsラジオアイテム(label prop対応)Props
RadioGroup
valueundefinedstring制御モードでの選択値
defaultValueundefinedstring非制御モードでの初期値
onValueChangeundefined(value: string) => void選択変更時のコールバック
size"default""sm" | "default" | "lg"ラジオボタンのサイズ (14/16/20px)
color"default""default" | "primary"チェック時のボーダーとドットの色
weight"bold""thin" | "bold"ボーダーの太さ (thin: 1px / bold: 2px)
orientation"vertical""vertical" | "horizontal"アイテムの配置方向
disabledundefinedboolean無効States
requiredundefinedboolean必須フィールド
nameundefinedstringフォームのname属性
looptruebooleanキーボードナビゲーションのループ
| Name | Type | Default | Description |
|---|---|---|---|
value | string | undefined | 制御モードでの選択値 |
defaultValue | string | undefined | 非制御モードでの初期値 |
onValueChange | (value: string) => void | undefined | 選択変更時のコールバック |
size | "sm" | "default" | "lg" | "default" | ラジオボタンのサイズ (14/16/20px) |
color | "default" | "primary" | "default" | チェック時のボーダーとドットの色 |
weight | "thin" | "bold" | "bold" | ボーダーの太さ (thin: 1px / bold: 2px) |
orientation | "vertical" | "horizontal" | "vertical" | アイテムの配置方向 |
disabled | boolean | undefined | 無効States |
required | boolean | undefined | 必須フィールド |
name | string | undefined | フォームのname属性 |
loop | boolean | true | キーボードナビゲーションのループ |
RadioGroupItem
value*stringこのアイテムの値(必須)
labelundefinedstringラジオボタンのラベルテキスト
disabledundefinedboolean個別の無効States
| Name | Type | Default | Description |
|---|---|---|---|
value* | string | - | このアイテムの値(必須) |
label | string | undefined | ラジオボタンのラベルテキスト |
disabled | boolean | undefined | 個別の無効States |