Radyo grubu

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

Radyo grubu, birbirini dışlayan seçeneklerden oluşan bir set sunar — bir öğe seçildiğinde diğerlerinin seçimi kalkar. Base UI Radio Group bileşeni üzerine kuruludur ve neobrütalist reçeteye göre stillendirilmiştir: kalın kenarlıklar, keskin gölgeler ve iddialı tipografi.

Şu durumlarda tercih edin:

• Plan seçiciler — seçim kartları olarak ücretsiz / pro / kurumsal; her zaman tek bir seçim geçerlidir.
• Ödeme seçenekleri — kargo hızı veya ödeme yöntemi gibi tüm seçeneklerin görünür kalması gereken durumlar.
• 2–5 seçenekli ayarlar — tema, yoğunluk, bildirim sıklığı; bir select'e göre daha az tıklama gerektirir.

Kurulum#

pnpmnpmyarnbun
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
Kopyala

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

"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 }

Kullanım#

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

Kopyala<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>

Kompozisyon#

Bir RadioGroup oluşturmak için aşağıdaki kompozisyonu kullanın:

KopyalaRadioGroup
├── RadioGroupItem
└── RadioGroupItem

Örnekler#

Açıklama#

Field bileşeni kullanılarak açıklama içeren radyo grubu öğeleri.

import {
  Field,
  FieldContent,

Choice Card#

Tıklanabilir, kart tarzı bir seçim için tüm Field'i sarmak üzere FieldLabel kullanın.

import {
  Field,
  FieldContent,

Fieldset#

Radyo öğelerini bir etiket ve açıklamayla gruplamak için FieldSet ve FieldLegend kullanın.

import {
  Field,
  FieldDescription,

Devre Dışı#

Tüm öğeleri devre dışı bırakmak için RadioGroup üzerinde disabled prop'unu kullanın.

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

Geçersiz#

Doğrulama hatalarını göstermek için RadioGroupItem üzerinde aria-invalid ve Field üzerinde data-invalid kullanın.

import {
  Field,
  FieldDescription,

RTL#

Neobrutalism'de RTL desteğini etkinleştirmek için RTL yapılandırma kılavuzuna bakın.

"use client"

import * as React from "react"

Erişilebilirlik#

Radyo grubu, WAI-ARIA Radio Group desenini izler: kapsayıcı role="radiogroup" olarak işlenir, her öğe aria-checked özniteliğine sahip bir role="radio" düğmesidir ve gezici tabindex sayesinde grubun tamamı tek bir sekme durağı olarak davranır.

Klavye etkileşimleri:

RTL düzeninde sol ve sağ ok tuşları okuma yönünü izler.

API Referansı#

Base UI Radio Group belgelerine bakın.