TaavUI Lab
Form Control

TaavSwitch

تنظیم boolean با track/thumb توکن‌محور — جایگزین switchهای محلی در settings panels.

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

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

استفاده پایه

RTL Preview
<TaavSwitch label="اعلان ایمیل" defaultChecked />

Sizes & tones

پیش‌نمایش

States

پیش‌نمایش

Props

Propنوعپیش‌فرضتوضیح
size'sm' | 'md' | 'lg'mdابعاد track/thumb
tone'brand' | 'neutral' | 'success' | 'warning' | 'danger'brandرنگ track روشن
onCheckedChange(checked: boolean) => voidتغییر boolean
label / descriptionReactNodeبرچسب تنظیمات

Design Specs

Track mdvar(--taav-switch-track-w-md)
Thumb mdvar(--taav-switch-thumb-md)
On brandvar(--taav-switch-track-on-brand)

دسترس‌پذیری

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

  • role=switch روی input
  • label/description استاندارد RTL

Do / Don't

انجام دهید

  • برای boolean settings از TaavSwitch استفاده کنید

انجام ندهید

  • BusinessSwitch legacy را برای UI جدید تکرار نکنید