TaavUI Lab
Form Primitive

TaavInput

ورودی متنی استاندارد با variant، tone، prefix/suffix و حالت‌های invalid/disabled/loading.

import { TaavInput } from "@repo/ui/taav";

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

استفاده پایه

RTL Preview
<TaavInput placeholder="نام کسب‌وکار" />

Sizes

پیش‌نمایش

Variants

پیش‌نمایش

States

پیش‌نمایش

Icons & affixes

پیش‌نمایش
+98
تومان

Props

Propنوعپیش‌فرضتوضیح
size'sm' | 'md' | 'lg'mdارتفاع و padding
variant'default' | 'filled' | 'soft' | 'ghost'defaultپس‌زمینه سطح
tone'neutral' | 'success' | 'warning' | 'danger'neutralرنگ مرز معنادار
width'auto' | 'full'fullعرض کنترل
invalidbooleanfalseحالت خطا
loadingbooleanfalseاسپینر و غیرفعال‌سازی
iconStart / iconEndReactNodeآیکون RTL
prefix / suffixReactNodeمتن یا واحد کنار input

Design Specs

Height mdvar(--taav-input-height-md)
Paddingvar(--taav-input-px-md)
Focusvar(--taav-input-focus-ring)
Invalidvar(--taav-input-focus-ring-danger)

دسترس‌پذیری

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

  • همیشه label مرتبط با htmlFor/id داشته باشید — ترجیحاً via TaavFormField
  • invalid باعث aria-invalid می‌شود

Do / Don't

انجام دهید

  • از TaavFormField برای label و error استفاده کنید

انجام ندهید

  • inputClassName برای تغییر رنگ/ارتفاع ندهید