الانتقال إلى المحتوى
1.6k

مجموعة أزرار اختيار

مجموعة من أزرار الاختيار أحادية الخيار الخاصة بنماذج الخطط وخيارات الشحن والإعدادات — مع تطبيق أسلوب «النيوبروتاليستي» في تصميم الحدود والظلال.

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

تقدم مجموعة الخيارات المتعددة مجموعة من الخيارات المتنافية — حيث يؤدي تحديد عنصر واحد إلى إلغاء تحديد الباقي. وهي مبنية على مكون Base UI Radio Group ومصممة وفقًا لأسلوب «النيوبروتالية»: حدود سميكة، وظلال حادة، وخط عريض.

استخدمه عندما:

  • أدوات اختيار الباقات — مجانية / احترافية / مؤسسية كبطاقات اختيار، مع فرض اختيار واحد فقط.
  • خيارات الدفع — سرعة الشحن أو طريقة الدفع، حيث يجب أن تظل كل الخيارات مرئية.
  • الإعدادات التي تحتوي على 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,

معطّل

استخدم الخاصية 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"

إمكانية الوصول

تتبع مجموعة عناصر الراديو معيار WAI-ARIA Radio Group pattern: حيث يعرض الحاوية role="radiogroup"، ويكون كل عنصر زرًا من نوع role="radio" مع aria-checked، ويضمن مؤشر tabindex المتنقل أن تكون المجموعة بأكملها نقطة توقف واحدة لـtab.

تفاعلات لوحة المفاتيح:

المفتاحالإجراء
Tab / Shift + Tabنقل التركيز إلى داخل المجموعة (العنصر المحدد، أو العنصر الأول) / خارجها
Spaceتحديد العنصر الذي عليه التركيز إذا لم يكن محددًا بالفعل
ArrowDown / ArrowRightنقل التركيز إلى العنصر التالي وتحديده
ArrowUp / ArrowLeftنقل التركيز إلى العنصر السابق وتحديده

تتبع أسهم اليسار واليمين اتجاه القراءة في RTL.

مرجع API

راجع وثائق Base UI Radio Group.