Radio Group
1つだけ選択できる選択肢のセットです。
Radio GroupはRadio GroupのWAI-ARIAデザインパターン(ロービングtabindexバージョン)に従います。
import { component$, useStyles$ } from '@builder.io/qwik';
import { RadioGroup } from '@leve-ui/radio-group';
import styles from './default.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<RadioGroup.Root class="radio-group-default-root">
<RadioGroup.Label class="radio-group-default-label">Plan</RadioGroup.Label>
<RadioGroup.Item value="free" class="radio-group-default-item">
<RadioGroup.Indicator class="radio-group-default-indicator" />
Free
</RadioGroup.Item>
<RadioGroup.Item value="starter" class="radio-group-default-item">
<RadioGroup.Indicator class="radio-group-default-indicator" />
Starter
</RadioGroup.Item>
<RadioGroup.Item value="pro" class="radio-group-default-item">
<RadioGroup.Indicator class="radio-group-default-indicator" />
Pro
</RadioGroup.Item>
</RadioGroup.Root>
);
});.radio-group-default-root {
font-family: inherit;
/* HiddenInput is absolutely positioned inside Root */
position: relative;
display: flex;
flex-direction: column;
align-items: flex-start;
gap: 12px;
}
.radio-group-default-label {
font-size: 14px;
font-weight: 600;
color: light-dark(#0f172a, #ffffff);
}
.radio-group-default-item {
display: inline-flex;
align-items: center;
gap: 10px;
padding: 0;
background: none;
border: none;
font: inherit;
font-size: 14px;
color: light-dark(#0f172a, #ffffff);
cursor: pointer;
text-align: left;
}
.radio-group-default-item:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.radio-group-default-item:disabled {
opacity: 0.5;
cursor: not-allowed;
}
.radio-group-default-indicator {
flex-shrink: 0;
width: 16px;
height: 16px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 9999px;
background: light-dark(#ffffff, #1b2045);
box-sizing: border-box;
}
/* A thick accent border draws the selected dot */
.radio-group-default-indicator[data-state="checked"] {
border: 5px solid #009dfd;
}インストール#
個別のパッケージをインストールするか、@leve-ui/coreを使用してすべてのコンポーネントを一度に取得します。
pnpm add @leve-ui/radio-groupnpm install @leve-ui/radio-groupyarn add @leve-ui/radio-groupbun add @leve-ui/radio-grouppnpm add @leve-ui/corenpm install @leve-ui/coreyarn add @leve-ui/corebun add @leve-ui/core構造#
import { RadioGroup } from '@leve-ui/radio-group'; // or '@leve-ui/core'
<RadioGroup.Root>
<RadioGroup.Label />
<RadioGroup.Item>
<RadioGroup.Indicator />
</RadioGroup.Item>
<RadioGroup.HiddenInput />
</RadioGroup.Root>
| パーツ | 要素 | 説明 |
|---|---|---|
RadioGroup.Root | <div> | role="radiogroup"を持つグループです。選択された値を保持します。 |
RadioGroup.Label | <span> | ラベルです。グループに名前を付けます。 |
RadioGroup.Item | <button> | role="radio"を持つ1つの選択肢です。 |
RadioGroup.Indicator | <span> | ドットやその他のアイコンを保持します。常に描画されます。 |
RadioGroup.HiddenInput | <input type="radio"> | 任意。ネイティブの<form>で選択された値を送信します。 |
例#
Controlled#
bind:valueはシグナルで選択された値を制御します。グループ外のボタンで値を変更でき、nullを設定すると選択がクリアされます。
Current value: banana
import { component$, useSignal, useStyles$ } from '@builder.io/qwik';
import { RadioGroup } from '@leve-ui/radio-group';
import styles from './controlled.css?inline';
export default component$(() => {
useStyles$(styles);
const selected = useSignal<string | null>('banana');
return (
<div class="radio-group-controlled-wrapper">
<RadioGroup.Root bind:value={selected} class="radio-group-controlled-root">
<RadioGroup.Label class="radio-group-controlled-label">Favorite fruit</RadioGroup.Label>
<RadioGroup.Item value="apple" class="radio-group-controlled-item">
<RadioGroup.Indicator class="radio-group-controlled-indicator" />
Apple
</RadioGroup.Item>
<RadioGroup.Item value="banana" class="radio-group-controlled-item">
<RadioGroup.Indicator class="radio-group-controlled-indicator" />
Banana
</RadioGroup.Item>
<RadioGroup.Item value="orange" class="radio-group-controlled-item">
<RadioGroup.Indicator class="radio-group-controlled-indicator" />
Orange
</RadioGroup.Item>
</RadioGroup.Root>
<div class="radio-group-controlled-controls">
<button
type="button"
class="radio-group-controlled-button"
onClick$={() => {
selected.value = 'apple';
}}
>
Select Apple
</button>
<button
type="button"
class="radio-group-controlled-button"
onClick$={() => {
selected.value = 'orange';
}}
>
Select Orange
</button>
<button
type="button"
class="radio-group-controlled-button"
onClick$={() => {
selected.value = null;
}}
>
Clear Selection
</button>
</div>
<p class="radio-group-controlled-value">Current value: {selected.value ?? '(none)'}</p>
</div>
);
});.radio-group-controlled-wrapper {
display: flex;
flex-direction: column;
align-items: flex-start;
gap: 12px;
font-family: inherit;
}
.radio-group-controlled-root {
/* HiddenInput is absolutely positioned inside Root */
position: relative;
display: flex;
flex-direction: column;
align-items: flex-start;
gap: 12px;
}
.radio-group-controlled-label {
font-size: 14px;
font-weight: 600;
color: light-dark(#0f172a, #ffffff);
}
.radio-group-controlled-item {
display: inline-flex;
align-items: center;
gap: 10px;
padding: 0;
background: none;
border: none;
font: inherit;
font-size: 14px;
color: light-dark(#0f172a, #ffffff);
cursor: pointer;
text-align: left;
}
.radio-group-controlled-item:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.radio-group-controlled-item:disabled {
opacity: 0.5;
cursor: not-allowed;
}
.radio-group-controlled-indicator {
flex-shrink: 0;
width: 16px;
height: 16px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 9999px;
background: light-dark(#ffffff, #1b2045);
box-sizing: border-box;
}
/* A thick accent border draws the selected dot */
.radio-group-controlled-indicator[data-state="checked"] {
border: 5px solid #009dfd;
}
.radio-group-controlled-controls {
display: flex;
flex-wrap: wrap;
gap: 8px;
}
.radio-group-controlled-button {
height: 32px;
padding: 0 12px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 6px;
background: light-dark(#ffffff, #1b2045);
color: light-dark(#0f172a, #ffffff);
font: inherit;
font-size: 13px;
font-weight: 500;
cursor: pointer;
}
.radio-group-controlled-button:hover {
background: light-dark(#f1f5f9, #ffffff14);
}
.radio-group-controlled-button:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
}
.radio-group-controlled-value {
margin: 0;
font-size: 13px;
color: light-dark(#475569, #c9ddf0);
}デフォルト値#
defaultValueは初期選択値を設定します。
import { component$, useStyles$ } from '@builder.io/qwik';
import { RadioGroup } from '@leve-ui/radio-group';
import styles from './default-value.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<RadioGroup.Root defaultValue="starter" class="radio-group-default-value-root">
<RadioGroup.Label class="radio-group-default-value-label">Plan</RadioGroup.Label>
<RadioGroup.Item value="free" class="radio-group-default-value-item">
<RadioGroup.Indicator class="radio-group-default-value-indicator" />
Free
</RadioGroup.Item>
<RadioGroup.Item value="starter" class="radio-group-default-value-item">
<RadioGroup.Indicator class="radio-group-default-value-indicator" />
Starter
</RadioGroup.Item>
<RadioGroup.Item value="pro" class="radio-group-default-value-item">
<RadioGroup.Indicator class="radio-group-default-value-indicator" />
Pro
</RadioGroup.Item>
</RadioGroup.Root>
);
});.radio-group-default-value-root {
font-family: inherit;
/* HiddenInput is absolutely positioned inside Root */
position: relative;
display: flex;
flex-direction: column;
align-items: flex-start;
gap: 12px;
}
.radio-group-default-value-label {
font-size: 14px;
font-weight: 600;
color: light-dark(#0f172a, #ffffff);
}
.radio-group-default-value-item {
display: inline-flex;
align-items: center;
gap: 10px;
padding: 0;
background: none;
border: none;
font: inherit;
font-size: 14px;
color: light-dark(#0f172a, #ffffff);
cursor: pointer;
text-align: left;
}
.radio-group-default-value-item:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.radio-group-default-value-item:disabled {
opacity: 0.5;
cursor: not-allowed;
}
.radio-group-default-value-indicator {
flex-shrink: 0;
width: 16px;
height: 16px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 9999px;
background: light-dark(#ffffff, #1b2045);
box-sizing: border-box;
}
/* A thick accent border draws the selected dot */
.radio-group-default-value-indicator[data-state="checked"] {
border: 5px solid #009dfd;
}Disabled#
Rootのdisabledはすべてのアイテムを無効化します。
import { component$, useStyles$ } from '@builder.io/qwik';
import { RadioGroup } from '@leve-ui/radio-group';
import styles from './disabled.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<RadioGroup.Root disabled defaultValue="opt1" class="radio-group-disabled-root">
<RadioGroup.Label class="radio-group-disabled-label">Disabled group</RadioGroup.Label>
<RadioGroup.Item value="opt1" class="radio-group-disabled-item">
<RadioGroup.Indicator class="radio-group-disabled-indicator" />
Option 1
</RadioGroup.Item>
<RadioGroup.Item value="opt2" class="radio-group-disabled-item">
<RadioGroup.Indicator class="radio-group-disabled-indicator" />
Option 2
</RadioGroup.Item>
</RadioGroup.Root>
);
});.radio-group-disabled-root {
/* HiddenInput is absolutely positioned inside Root */
position: relative;
display: flex;
flex-direction: column;
align-items: flex-start;
gap: 12px;
font-family: inherit;
}
.radio-group-disabled-label {
font-size: 14px;
font-weight: 600;
color: light-dark(#0f172a, #ffffff);
}
.radio-group-disabled-item {
display: inline-flex;
align-items: center;
gap: 10px;
padding: 0;
background: none;
border: none;
font: inherit;
font-size: 14px;
color: light-dark(#0f172a, #ffffff);
cursor: pointer;
text-align: left;
}
.radio-group-disabled-item:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.radio-group-disabled-item:disabled {
opacity: 0.5;
cursor: not-allowed;
}
.radio-group-disabled-indicator {
flex-shrink: 0;
width: 16px;
height: 16px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 9999px;
background: light-dark(#ffffff, #1b2045);
box-sizing: border-box;
}
/* A thick accent border draws the selected dot */
.radio-group-disabled-indicator[data-state="checked"] {
border: 5px solid #009dfd;
}
.radio-group-disabled-label[data-disabled] {
opacity: 0.5;
}無効化されたアイテム#
Itemのdisabledはそのオプションのみを無効化します。矢印キーでスキップされます。
import { component$, useStyles$ } from '@builder.io/qwik';
import { RadioGroup } from '@leve-ui/radio-group';
import styles from './disabled-item.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<RadioGroup.Root class="radio-group-disabled-item-root">
<RadioGroup.Label class="radio-group-disabled-item-label">Shipping method</RadioGroup.Label>
<RadioGroup.Item value="standard" class="radio-group-disabled-item-item">
<RadioGroup.Indicator class="radio-group-disabled-item-indicator" />
Standard (3-5 days)
</RadioGroup.Item>
<RadioGroup.Item value="express" disabled class="radio-group-disabled-item-item">
<RadioGroup.Indicator class="radio-group-disabled-item-indicator" />
Express (Unavailable)
</RadioGroup.Item>
<RadioGroup.Item value="overnight" class="radio-group-disabled-item-item">
<RadioGroup.Indicator class="radio-group-disabled-item-indicator" />
Overnight
</RadioGroup.Item>
</RadioGroup.Root>
);
});.radio-group-disabled-item-root {
/* HiddenInput is absolutely positioned inside Root */
position: relative;
display: flex;
flex-direction: column;
align-items: flex-start;
gap: 12px;
font-family: inherit;
}
.radio-group-disabled-item-label {
font-size: 14px;
font-weight: 600;
color: light-dark(#0f172a, #ffffff);
}
.radio-group-disabled-item-item {
display: inline-flex;
align-items: center;
gap: 10px;
padding: 0;
background: none;
border: none;
font: inherit;
font-size: 14px;
color: light-dark(#0f172a, #ffffff);
cursor: pointer;
text-align: left;
}
.radio-group-disabled-item-item:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.radio-group-disabled-item-item:disabled {
opacity: 0.5;
cursor: not-allowed;
}
.radio-group-disabled-item-indicator {
flex-shrink: 0;
width: 16px;
height: 16px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 9999px;
background: light-dark(#ffffff, #1b2045);
box-sizing: border-box;
}
/* A thick accent border draws the selected dot */
.radio-group-disabled-item-indicator[data-state="checked"] {
border: 5px solid #009dfd;
}水平方向#
orientation="horizontal"はグループを行方向にレイアウトします。aria-orientationとdata-orientationを設定します。
import { component$, useStyles$ } from '@builder.io/qwik';
import { RadioGroup } from '@leve-ui/radio-group';
import styles from './horizontal.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<RadioGroup.Root
orientation="horizontal"
defaultValue="card"
class="radio-group-horizontal-root"
>
<RadioGroup.Label class="radio-group-horizontal-label">Payment method</RadioGroup.Label>
<RadioGroup.Item value="card" class="radio-group-horizontal-item">
<RadioGroup.Indicator class="radio-group-horizontal-indicator" />
Card
</RadioGroup.Item>
<RadioGroup.Item value="paypal" class="radio-group-horizontal-item">
<RadioGroup.Indicator class="radio-group-horizontal-indicator" />
PayPal
</RadioGroup.Item>
<RadioGroup.Item value="bank" class="radio-group-horizontal-item">
<RadioGroup.Indicator class="radio-group-horizontal-indicator" />
Bank transfer
</RadioGroup.Item>
</RadioGroup.Root>
);
});.radio-group-horizontal-root {
/* HiddenInput is absolutely positioned inside Root */
position: relative;
display: flex;
flex-direction: column;
align-items: flex-start;
gap: 12px;
font-family: inherit;
}
.radio-group-horizontal-label {
font-size: 14px;
font-weight: 600;
color: light-dark(#0f172a, #ffffff);
}
.radio-group-horizontal-item {
display: inline-flex;
align-items: center;
gap: 10px;
padding: 0;
background: none;
border: none;
font: inherit;
font-size: 14px;
color: light-dark(#0f172a, #ffffff);
cursor: pointer;
text-align: left;
}
.radio-group-horizontal-item:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.radio-group-horizontal-item:disabled {
opacity: 0.5;
cursor: not-allowed;
}
.radio-group-horizontal-indicator {
flex-shrink: 0;
width: 16px;
height: 16px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 9999px;
background: light-dark(#ffffff, #1b2045);
box-sizing: border-box;
}
/* A thick accent border draws the selected dot */
.radio-group-horizontal-indicator[data-state="checked"] {
border: 5px solid #009dfd;
}
/* Items sit in a row; the label takes the full first line */
.radio-group-horizontal-root[data-orientation="horizontal"] {
flex-direction: row;
flex-wrap: wrap;
column-gap: 20px;
}
.radio-group-horizontal-label {
flex-basis: 100%;
}Fieldと併用#
Field内では、グループはFieldのIDを使用し、そのinvalid、disabled、およびrequired状態を読み取ります。Field.DescriptionとField.ErrorMessageはaria-describedbyでリンクされます。グループの名前付けにはField.LabelではなくRadioGroup.Labelを使用してください。<label>でグループに名前を付けることはできません。
import { component$, useStyles$ } from '@builder.io/qwik';
import { Field } from '@leve-ui/field';
import { RadioGroup } from '@leve-ui/radio-group';
import styles from './with-field.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<Field.Root hasDescription required class="radio-group-with-field-field">
{/* RadioGroup.Label names the group; a <label> cannot */}
<RadioGroup.Root defaultValue="standard" class="radio-group-with-field-root">
<RadioGroup.Label class="radio-group-with-field-label">Shipping</RadioGroup.Label>
<RadioGroup.Item value="standard" class="radio-group-with-field-item">
<RadioGroup.Indicator class="radio-group-with-field-indicator" />
Standard
</RadioGroup.Item>
<RadioGroup.Item value="express" class="radio-group-with-field-item">
<RadioGroup.Indicator class="radio-group-with-field-indicator" />
Express
</RadioGroup.Item>
</RadioGroup.Root>
<Field.Description class="radio-group-with-field-description">
Express arrives in one business day.
</Field.Description>
</Field.Root>
);
});.radio-group-with-field-field {
display: flex;
flex-direction: column;
gap: 8px;
font-family: inherit;
}
.radio-group-with-field-root {
font-family: inherit;
/* HiddenInput is absolutely positioned inside Root */
position: relative;
display: flex;
flex-direction: column;
align-items: flex-start;
gap: 12px;
}
.radio-group-with-field-label {
font-size: 14px;
font-weight: 600;
color: light-dark(#0f172a, #ffffff);
}
.radio-group-with-field-item {
display: inline-flex;
align-items: center;
gap: 10px;
padding: 0;
background: none;
border: none;
font: inherit;
font-size: 14px;
color: light-dark(#0f172a, #ffffff);
cursor: pointer;
text-align: left;
}
.radio-group-with-field-item:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.radio-group-with-field-item:disabled {
opacity: 0.5;
cursor: not-allowed;
}
.radio-group-with-field-indicator {
flex-shrink: 0;
width: 16px;
height: 16px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 9999px;
background: light-dark(#ffffff, #1b2045);
box-sizing: border-box;
}
/* A thick accent border draws the selected dot */
.radio-group-with-field-indicator[data-state="checked"] {
border: 5px solid #009dfd;
}
.radio-group-with-field-description {
margin: 0;
font-size: 13px;
color: light-dark(#475569, #c9ddf0);
}Formと併用#
RadioGroup.HiddenInputをnameとともに配置すると、ネイティブの<form>で選択された値を送信できます。
import { component$, useSignal, useStyles$ } from '@builder.io/qwik';
import { RadioGroup } from '@leve-ui/radio-group';
import styles from './with-form.css?inline';
export default component$(() => {
useStyles$(styles);
const submittedValue = useSignal<string | null>(null);
return (
<div class="radio-group-with-form-wrapper">
<form
class="radio-group-with-form-form"
preventdefault:submit
onSubmit$={(event) => {
const form = event.target as HTMLFormElement;
const formData = new FormData(form);
submittedValue.value = (formData.get('subscription') as string) || '(none)';
}}
>
<RadioGroup.Root defaultValue="monthly" class="radio-group-with-form-root">
<RadioGroup.Label class="radio-group-with-form-label">
Subscription billing
</RadioGroup.Label>
<RadioGroup.Item value="monthly" class="radio-group-with-form-item">
<RadioGroup.Indicator class="radio-group-with-form-indicator" />
Monthly billing ($10/mo)
</RadioGroup.Item>
<RadioGroup.Item value="yearly" class="radio-group-with-form-item">
<RadioGroup.Indicator class="radio-group-with-form-indicator" />
Yearly billing ($100/yr)
</RadioGroup.Item>
<RadioGroup.HiddenInput name="subscription" />
</RadioGroup.Root>
<button type="submit" class="radio-group-with-form-form-button">
Submit
</button>
</form>
{submittedValue.value !== null && (
<p class="radio-group-with-form-submitted" data-testid="submitted-value">
Submitted: {submittedValue.value}
</p>
)}
</div>
);
});.radio-group-with-form-wrapper {
display: flex;
flex-direction: column;
align-items: flex-start;
gap: 12px;
font-family: inherit;
}
.radio-group-with-form-form {
display: flex;
flex-direction: column;
align-items: flex-start;
gap: 12px;
}
.radio-group-with-form-root {
/* HiddenInput is absolutely positioned inside Root */
position: relative;
display: flex;
flex-direction: column;
align-items: flex-start;
gap: 12px;
}
.radio-group-with-form-label {
font-size: 14px;
font-weight: 600;
color: light-dark(#0f172a, #ffffff);
}
.radio-group-with-form-item {
display: inline-flex;
align-items: center;
gap: 10px;
padding: 0;
background: none;
border: none;
font: inherit;
font-size: 14px;
color: light-dark(#0f172a, #ffffff);
cursor: pointer;
text-align: left;
}
.radio-group-with-form-item:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
border-radius: 4px;
}
.radio-group-with-form-item:disabled {
opacity: 0.5;
cursor: not-allowed;
}
.radio-group-with-form-indicator {
flex-shrink: 0;
width: 16px;
height: 16px;
border: 1px solid light-dark(#cbd5e1, #ffffff3d);
border-radius: 9999px;
background: light-dark(#ffffff, #1b2045);
box-sizing: border-box;
}
/* A thick accent border draws the selected dot */
.radio-group-with-form-indicator[data-state="checked"] {
border: 5px solid #009dfd;
}
.radio-group-with-form-form-button {
height: 32px;
padding: 0 12px;
border: none;
border-radius: 6px;
background: #009dfd;
color: #ffffff;
font: inherit;
font-size: 13px;
font-weight: 500;
cursor: pointer;
}
.radio-group-with-form-form-button:hover {
background: #006ce9;
}
.radio-group-with-form-form-button:focus-visible {
outline: 2px solid #009dfd;
outline-offset: 2px;
}
.radio-group-with-form-submitted {
margin: 0;
font-size: 13px;
color: light-dark(#475569, #c9ddf0);
}APIリファレンス#
Root#
| Prop | デフォルト | 型 |
|---|---|---|
| ids | – | { label?: string; root?: string } 各パーツの要素IDを上書きします。Field内では、代わりにFieldのIDが使用されます。 |
| defaultValue | null | string | null 初期選択される値(非制御)。 |
| bind:value | – | Signal<string | null> 選択された値を保持するシグナル(制御)。 |
| onValueChange$ | – | QRL<(value: string) => void> ユーザーが値を選択したときに呼び出されます。 |
| orientation | 'vertical' | 'horizontal' | 'vertical' グループの向き。 |
| loop | true | boolean 矢印キーで最後の項目から最初の項目へ、またはその逆にラップするかどうか。 |
| disabled | false | boolean すべてのラジオボタンを無効化します。 |
| required | false | boolean グループを必須としてマークします。 |
すべての<div>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-radio-group | 常に存在 |
data-orientation | "vertical" | "horizontal" |
data-disabled | 無効時に存在 |
data-invalid | 囲んでいるFieldが無効な場合に存在します |
選択された値はdefaultValueで非制御、またはbind:valueで制御されます。ユーザーが値を選択するとonValueChange$が呼び出されます。orientationはaria-orientationとdata-orientationのみを変更します。どちらの向きでも4つの矢印キーすべてで選択を移動できます。
Label#
独自のpropはありません。 すべての<span>属性を受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-radio-group-label | 常に存在 |
data-disabled | グループが無効化されている場合に存在 |
LabelのidはRootから提供されます。これを変更するには、Rootにids={{ label: '...' }}を渡します(Labelに指定したidも使用されますが、その場合は同じIDをRootのaria-labelledbyにも渡してください)。Field内では、FieldのラベルIDが使用されます。
Item#
| Prop | デフォルト | 型 |
|---|---|---|
| value (必須) | – | string このラジオボタンの値。 |
| disabled | false | boolean このラジオボタンを無効化します。 |
すべての<button>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-radio-group-item | 常に存在 |
data-state | "checked" | "unchecked" |
data-disabled | アイテムまたはグループが無効化されている場合に存在 |
data-orientation | "vertical" | "horizontal" |
Indicator#
独自のpropはありません。 すべての<span>属性を受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-radio-group-indicator | 常に存在 |
data-state | "checked" | "unchecked" |
data-disabled | アイテムまたはグループが無効化されている場合に存在 |
インジケーターは常にレンダリングされます。[data-leve-radio-group-indicator][data-state="checked"]などのCSSを使用してコンテンツの表示・非表示を切り替えます。
HiddenInput#
| Prop | デフォルト | 型 |
|---|---|---|
| form | – | string inputを関連付けるform要素の |
すべての<input>属性も受け入れます。
| データ属性 | 値 |
|---|---|
data-leve-radio-group-hidden-input | 常に存在 |
data-state | 値が選択されている場合は"checked"、それ以外は"unchecked" |
data-disabled | グループが無効化されている場合に存在 |
隠しinputは選択された値を保持し、Rootのrequiredおよびdisabled状態に追従するため、ネイティブフォーム送信とrequiredバリデーションが機能します(ADR 0026)。インラインスタイルで絶対配置されるため、RadioGroup.Rootにposition: relativeを指定してください。
アクセシビリティ#
Radio Group WAI-ARIAデザインパターンに準拠しています。
RadioGroup.Label、またはRadioGroup.Rootのaria-label/aria-labelledbyでグループに名前を付けます。RadioGroup.Rootはrole="radiogroup"、aria-orientation、および必須または無効時にaria-required/aria-disabledを描画します。Field内では、Field.Description/Field.ErrorMessage用のaria-describedbyと、Fieldが無効な間のaria-invalid="true"も描画します。- 各
RadioGroup.Itemは、role="radio"とaria-checkedを持つ<button type="button">です。そのテキストコンテンツがアクセシブルな名前になります。無効化されたアイテムはネイティブのdisabled属性を使用するため、フォーカスできません。 - タブシーケンスに含まれるのは1つのアイテムのみです。選択されたアイテム、または何も選択されていない場合は最初の有効なアイテムです。
RadioGroup.IndicatorとRadioGroup.HiddenInputはaria-hidden="true"によって支援技術から隠されます。
キーボード操作#
| キー | 説明 |
|---|---|
Tab | フォーカスをグループ内(選択されたアイテム、または最初の有効なアイテム)に移動するか、グループ外に移動します。 |
Space | フォーカスされたアイテムを選択します。Enterは何もしません。 |
ArrowDown / ArrowRight | フォーカスを次の有効なアイテムに移動して選択します。loopがtrueの場合、最初のアイテムに折り返します。 |
ArrowUp / ArrowLeft | フォーカスを前の有効なアイテムに移動して選択します。loopがtrueの場合、最後のアイテムに折り返します。 |
Home | 有効な最初の項目にフォーカスを移動して選択します。 |
End | 有効な最後の項目にフォーカスを移動して選択します。 |