پرش به محتوا
1.6k

گروه رادیویی

مجموعه‌ای از دکمه‌های رادیویی تک‌گزینه‌ای برای طرح‌ها، گزینه‌های ارسال و فرم‌های تنظیمات — با جلوه‌ی نئوبروتالیستی حاشیه‌ها و سایه‌ها.

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

گروه radio مجموعه‌ای از گزینه‌های متقابلاً انحصاری را نشان می‌دهد — انتخاب یکی بقیه را uncheck می‌کند. بر پایهٔ Base UI Radio Group ساخته شده و با دستور پخت نئوبروتالیستی استایل شده: حاشیه‌های ضخیم، سایه‌های سخت و تایپوگرافی پررنگ.

برای این موارد از آن استفاده کنید:

  • انتخابگر پلن — free / pro / enterprise به‌صورت کارت انتخاب، با اجبار یک انتخاب.
  • گزینه‌های checkout — سرعت ارسال یا روش پرداخت، جایی که هر انتخاب باید نمایان بماند.
  • تنظیمات با 2–5 گزینه — تم، density، تناوب اعلان؛ کمتر از select کلیک می‌خواهد.

نصب

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 را مطابق با پیکربندی پروژهٔ خود به‌روزرسانی کنید.

استفاده

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,

Choice Card

برای یک انتخاب قابل‌کلیک به‌سبک کارت، از FieldLabel برای در بر گرفتن کل Field استفاده کنید.

import {
  Field,
  FieldContent,

Fieldset

برای گروه‌بندی آیتم‌های رادیویی همراه با برچسب و توضیح، از FieldSet و FieldLegend استفاده کنید.

import {
  Field,
  FieldDescription,

غیرفعال

برای غیرفعال کردن همهٔ آیتم‌ها، از ویژگی disabled روی RadioGroup استفاده کنید.

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

نامعتبر

برای نمایش خطاهای اعتبارسنجی، از aria-invalid روی RadioGroupItem و data-invalid روی Field استفاده کنید.

import {
  Field,
  FieldDescription,

RTL

برای فعال‌سازی پشتیبانی RTL در Neobrutalism، راهنمای پیکربندی RTL را ببینید.

"use client"

import * as React from "react"

دسترسی‌پذیری

گروه radio از الگوی WAI-ARIA Radio Group پیروی می‌کند: کانتینر role="radiogroup" رندر می‌کند، هر آیتم دکمهٔ role="radio" با aria-checked است، و roving tabindex کل گروه را یک tab stop نگه می‌دارد.

تعاملات صفحه‌کلید:

کلیدعمل
Tab / Shift + Tabورود فوکوس به گروه (آیتم checked، یا اولین آیتم) / خروج
Spacecheck آیتم فوکوس‌شده اگر هنوز نیست
ArrowDown / ArrowRightانتقال فوکوس به آیتم بعدی و check کردنش
ArrowUp / ArrowLeftانتقال فوکوس به آیتم قبلی و check کردنش

پیکان چپ و راست در RTL از جهت خواندن پیروی می‌کنند.

مرجع API

مستندات Base UI Radio Group را ببینید.