@k8ordo/ui

RadioCard

選択肢をカードで見せる単一選択です。説明や図を添えて、選択肢を大きく見せたいときに使います。

インポート

ts
import { RadioCard } from '@k8ordo/ui';

使い方

Choose a plan

tsx
import { RadioCard } from '@k8ordo/ui';
import { useState } from 'react';

const options = [
  { value: 'starter', label: 'Starter', description: '...' },
  { value: 'pro', label: 'Pro', description: '...' },
  { value: 'team', label: 'Team', description: '...' },
];

const [value, setValue] = useState('pro');

<p id="plan-label">Choose a plan</p>
<RadioCard
  disabled={false}
  invalid={false}
  aria-labelledby="plan-label"
  onChange={(value) => setValue(value)}
  options={options}
  value={value}
/>

既定値

Choose a plan

tsx
const options = [
  { value: 'starter', label: 'Starter', description: '...' },
  { value: 'pro', label: 'Pro', description: '...' },
  { value: 'team', label: 'Team', description: '...' },
];

<p id="plan-default-label">Choose a plan</p>
<RadioCard
  defaultValue="starter"
  disabled={false}
  invalid={false}
  aria-labelledby="plan-default-label"
  options={options}
/>

フォームでの送信

中身は本物のinput[type=radio]です。nameを渡すと、ブラウザが同じ名前のラジオを1つのグループにします。選んだ値はFormDataからそのまま取り出せます。

Choose a plan

tsx
const [submitted, setSubmitted] = useState<string | null>(null);

<Form
  action={(formData) => {
    const plan = formData.get('plan');
    setSubmitted(typeof plan === 'string' ? plan : null);
  }}
>
  <p id="plan-form-label">Choose a plan</p>
  <RadioCard
    defaultValue="pro"
    disabled={false}
    invalid={false}
    aria-labelledby="plan-form-label"
    name="plan"
    options={options}
  />
  <Button type="submit">Submit</Button>
</Form>

Props

aria-labelledby
Type: string
Default: -
options
Type: readonly RadioCardOption[]
Default: -
defaultValue?
Type: string
Default: -
invalid?
Type: boolean
Default: false
onChange?
Type: (value: string) => void
Default: -
ref?
Type: Ref<HTMLFieldSetElement>
Default: -
required?
Type: boolean
Default: false
value?
Type: string
Default: -
PropTypeDefault
aria-labelledbystring-
optionsreadonly RadioCardOption[]-
defaultValue?string-
invalid?booleanfalse
onChange?(value: string) => void-
ref?Ref<HTMLFieldSetElement>-
required?booleanfalse
value?string-

継承する属性(内部で固定するものを除く): FieldsetHTMLAttributes<HTMLFieldSetElement>

k8ordo

Baselineに入った機能を、制限なく使うReactのライブラリ群。