TaavUI Lab
Form Control

TaavSegmentedControl

انتخاب compact از چند mode — فیلترها، yes/no، view switch در DastRanj/VahedYek.

import { TaavSegmentedControl } from "@repo/ui/taav/forms";

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

استفاده پایه

Controlled RTL example
<TaavSegmentedControl value={value} onValueChange={setValue} options={options} />

Variants & width

پیش‌نمایش

States

پیش‌نمایش

Props

Propنوعپیش‌فرضتوضیح
size'sm' | 'md' | 'lg'mdارتفاع segment
tone'brand' | 'neutral'brandنقش رنگی
variant'solid' | 'soft' | 'outline'solidسبک segment
width'auto' | 'full'autoعرض کنترل
options*TaavSegmentedOption[]label/value/icon

Design Specs

Height mdvar(--taav-segmented-height-md)
Selected bgvar(--taav-segmented-selected-bg)
Radiusvar(--taav-segmented-radius)

دسترس‌پذیری

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

  • aria-label برای radiogroup بدون label visible
  • role=radio روی هر segment

Do / Don't

انجام دهید

  • برای ۲–۴ گزینه compact از segmented استفاده کنید

انجام ندهید

  • ChoicePills legacy را برای UI TaavUI جدید کپی نکنید