דילוג לתוכן
1.6k

קבוצת רדיו

סט כפתורי רדיו לבחירה אחת עבור טפסי תוכניות, אפשרויות משלוח והגדרות — עם עיצוב ניאו-ברוטליסטי המשלב מסגרות וצללים.

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

ה-radio group מציג קבוצת אפשרויות בלעדיות הדדית — סימון פריט אחד מבטל את הסימון בשאר. נבנה על גבי רכיב Base UI Radio Group ומעוצב לפי המתכון הנאו-ברוטליסטי: מסגרות עבות, צללים חדים וטיפוגרפיה מודגשת.

השתמשו בו כש:

  • בוחרי תוכניות — free / pro / enterprise ככרטיסי בחירה, בחירה אחת נאכפת.
  • אפשרויות checkout — מהירות משלוח או אמצעי תשלום, כשכל בחירה חייבת להישאר גלויה.
  • הגדרות עם 2–5 אפשרויות — ערכת נושא, צפיפות, תדירות התראות; פחות לחיצות מ-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 { 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"

נגישות

ה-radio group עוקב אחרי דפוס Radio Group של WAI-ARIA: המיכל מרנדר role="radiogroup", כל פריט הוא כפתור role="radio" עם aria-checked, ו-roving tabindex משאיר את כל הקבוצה כ-tab stop יחיד.

אינטראקציות מקלדת:

מקשפעולה
Tab / Shift + Tabמעבירים מוקד אל הקבוצה (הפריט המסומן, או הראשון) / החוצה
Spaceמסמנים את הפריט שבפוקוס אם הוא עדיין לא
ArrowDown / ArrowRightמעבירים מוקד לפריט הבא ומסמנים אותו
ArrowUp / ArrowLeftמעבירים מוקד לפריט הקודם ומסמנים אותו

חצים שמאלה וימינה עוקבים אחרי כיוון הקריאה ב-RTL.

תיעוד ה-API

עיינו בתיעוד של Base UI Radio Group.