این کامپوننت برای ورود درصد استفاده میشود. علامت درصد داخل فیلد در سمت چپ نمایش داده میشود و مقدار باید در بازه مجاز تعیینشده باقی بماند.
import { TaavPercentageInput } from "@repo/ui/taav/forms";فقط از props رسمی TaavUI استفاده کنید. unsafeClassName و escape hatchهای مشابه فقط برای موارد نادر هستند و نباید در مثالهای عادی دیده شوند.
درصد پیشپرداخت از کل مبلغ
<TaavPercentageInput defaultValue={4} min={0} max={100} />| Prop | نوع | پیشفرض | توضیح |
|---|---|---|---|
value / defaultValue | number | string | — | مقدار کنترلشده یا اولیه |
onValueChange | (value: number | null) => void | — | عدد نرمالشده |
min / max | number | 0 / 100 | بازه مجاز — clamp در blur |
size | 'sm' | 'md' | 'lg' | md | ارتفاع کنترل |
tone | 'neutral' | 'success' | 'warning' | 'danger' | neutral | رنگ مرز |
invalid | boolean | false | خطای خارجی یا خارج از بازه |
inputMode | 'numeric' | 'decimal' | numeric | ورود اعشاری اختیاری |
disabled / readOnly | boolean | — | حالت غیرفعال یا فقط خواندنی |