TaavUI Lab
Form Control

TaavRadio & TaavRadioGroup

انتخاب تک‌گزینه‌ای با چیدمان عمودی/افقی — مناسب wizard و setup flows.

import { TaavRadio, TaavRadioGroup } from "@repo/ui/taav/forms";

فقط از props رسمی TaavUI استفاده کنید. unsafeClassName و escape hatchهای مشابه فقط برای موارد نادر هستند و نباید در مثال‌های عادی دیده شوند.

استفاده پایه

Controlled RTL example
<TaavRadioGroup name="plan" value={value} onValueChange={setValue} options={options} />

Orientation

پیش‌نمایش

States

پیش‌نمایش

Props

Propنوعپیش‌فرضتوضیح
size'sm' | 'md' | 'lg'mdاندازه radio
tone'brand' | 'neutral' | 'success' | 'warning' | 'danger'brandرنگ dot
orientation'horizontal' | 'vertical'verticalچیدمان TaavRadioGroup
options*TaavRadioOption[]گزینه‌های گروه
onValueChange(value: string) => voidتغییر مقدار گروه

Design Specs

Size mdvar(--taav-control-size-md)
Dot mdvar(--taav-radio-dot-size-md)
Focusvar(--taav-control-focus-ring)

دسترس‌پذیری

راهنمای استفاده در DastRanj / VahedYek

  • role=radiogroup روی TaavRadioGroup
  • name مشترک برای keyboard navigation

Do / Don't

انجام دهید

  • برای لیست گزینه از TaavRadioGroup استفاده کنید

انجام ندهید

  • radio row سفارشی در VahedYek نسازید