コンテンツへスキップ
1.6k

ラジオグループ

プラン、配送オプション、設定フォーム用の単一選択式ラジオボタンセットです。ネオブルータリズム風の枠線と影の演出が施されています。

import { Label } from "@/components/ui/label"
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group"

Radio Group は互いに排他的な選択肢の集合を提示します。1つを選ぶと他は外れます。Base UI Radio Group コンポーネント上に構築し、ネオブルータリストのレシピに沿ってスタイルしています。太い枠線、硬い影、太字のタイポグラフィです。

次のような場面で使います：

  • プラン選択 — free / pro / enterprise を選択カードに。1つだけ選べます。
  • チェックアウトの選択肢 — 配送速度や支払い方法など、すべての選択肢を見せたままにしたい場面。
  • 2〜5 個の設定 — テーマ、密度、通知頻度。セレクトよりクリックが少なくて済みます。

インストール

pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/radio-group.json
npx shadcn@latest add https://neobrutalism.com/r/base/radio-group.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/radio-group.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/radio-group.json

以下の依存関係をインストールします。

pnpm add @base-ui/react
npm install @base-ui/react
yarn add @base-ui/react
bun add @base-ui/react

以下のコードをコピーして、プロジェクトに貼り付けます。

components/ui/radio-group.tsx
"use client"

import * as React from "react"
import { RadioGroup as RadioGroupPrimitive } from "radix-ui"

import { cn } from "@/lib/utils"

function RadioGroup({
  className,
  ...props
}: React.ComponentProps<typeof RadioGroupPrimitive.Root>) {
  return (
    <RadioGroupPrimitive.Root
      data-slot="radio-group"
      className={cn("grid w-full gap-2", className)}
      {...props}
    />
  )
}

function RadioGroupItem({
  className,
  ...props
}: React.ComponentProps<typeof RadioGroupPrimitive.Item>) {
  return (
    <RadioGroupPrimitive.Item
      data-slot="radio-group-item"
      className={cn(
        "group/radio-group-item peer relative flex aspect-square size-5 shrink-0 rounded-full border-2 bg-input shadow-sm outline-none after:absolute after:-inset-x-3 after:-inset-y-2 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:border-destructive",
        className
      )}
      {...props}
    >
      <RadioGroupPrimitive.Indicator
        data-slot="radio-group-indicator"
        className="flex size-4 items-center justify-center"
      >
        <span className="absolute top-1/2 left-1/2 size-2 -translate-x-1/2 -translate-y-1/2 rounded-full bg-primary" />
      </RadioGroupPrimitive.Indicator>
    </RadioGroupPrimitive.Item>
  )
}

export { RadioGroup, RadioGroupItem }

インポートのパスをプロジェクトの構成に合わせて更新します。

使い方

import { Label } from "@/components/ui/label"
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group"
<RadioGroup defaultValue="option-one">
  <div className="flex items-center gap-3">
    <RadioGroupItem value="option-one" id="option-one" />
    <Label htmlFor="option-one">Option One</Label>
  </div>
  <div className="flex items-center gap-3">
    <RadioGroupItem value="option-two" id="option-two" />
    <Label htmlFor="option-two">Option Two</Label>
  </div>
</RadioGroup>

コンポジション

RadioGroup を構築するには、次のコンポジションを使用します。

RadioGroup
├── RadioGroupItem
└── RadioGroupItem

使用例

説明

Field コンポーネントを使って説明を付けたラジオグループの項目です。

import {
  Field,
  FieldContent,

選択カード

FieldLabel で Field 全体を包むと、クリック可能なカード形式の選択にできます。

import {
  Field,
  FieldContent,

Fieldset

FieldSet と FieldLegend を使って、ラベルと説明とともにラジオ項目をグループ化します。

import {
  Field,
  FieldDescription,

無効

RadioGroup の disabled プロパティを使って、すべての項目を無効化します。

import { Field, FieldLabel } from "@/components/ui/field"
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group"

不正な値

RadioGroupItem に aria-invalid、Field に data-invalid を指定して、バリデーションエラーを表示します。

import {
  Field,
  FieldDescription,

RTL

Neobrutalism で RTL を有効にする方法は、RTL 設定ガイドをご覧ください。

"use client"

import * as React from "react"

アクセシビリティ

Radio Group は WAI-ARIA Radio Group パターン に従います。コンテナは role="radiogroup"、各項目は aria-checked 付きの role="radio" ボタンで、roving tabindex によりグループ全体が1つのタブストップになります。

キーボード操作：

キー操作
Tab / Shift + Tabグループへ（チェック済み、なければ先頭）／外へフォーカスを移動
Space未チェックならフォーカス中の項目をチェック
ArrowDown / ArrowRight次の項目へフォーカスを移し、チェックする
ArrowUp / ArrowLeft前の項目へフォーカスを移し、チェックする

左右矢印は RTL では読み方向に従います。

APIリファレンス

詳しくは Base UI のドキュメントをご覧ください。