TaavUI Lab
Form Control

TaavSelect

انتخاب native با API کنترل‌شده — مناسب فیلترها و فرم‌های ساده DastRanj/VahedYek.

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

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

استفاده پایه

RTL Preview
<TaavSelect placeholder="انتخاب شهر" options={options} />

Sizes & variants

پیش‌نمایش

States

پیش‌نمایش

Props

Propنوعپیش‌فرضتوضیح
size'sm' | 'md' | 'lg'mdارتفاع و padding
variant'default' | 'filled' | 'soft' | 'ghost'defaultپس‌زمینه
tone'neutral' | 'success' | 'warning' | 'danger'neutralرنگ مرز
invalidbooleanfalseحالت خطا
placeholderstringگزینه placeholder غیرقابل انتخاب
options*TaavSelectOption[]لیست label/value
iconStartReactNodeآیکون RTL

Design Specs

Height mdvar(--taav-input-height-md)
Chevron gapvar(--taav-select-icon-gap)
Focusvar(--taav-input-focus-ring)

دسترس‌پذیری

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

  • با TaavFormField و htmlFor/id label بدهید
  • invalid → aria-invalid

Do / Don't

انجام دهید

  • برای helper/error از TaavFormField استفاده کنید

انجام ندهید

  • select محلی با Tailwind سفارشی نسازید