Form Primitive

TaavCurrencyInput

این کامپوننت برای ورود مبلغ استفاده می‌شود. عدد به‌صورت سه‌رقمی جدا می‌شود و واحد پول داخل فیلد در سمت راست نمایش داده می‌شود.

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

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

نمای مرجع (RTL)

Screenshot-like demo

مبلغ ثابت

مبلغ ثابت قرارداد به ریال

پیش‌پرداخت

مبلغ پیش‌پرداخت به تومان

پیش‌نمایش

<TaavCurrencyInput defaultValue={2500000} currency="rial" />

پیش‌نمایشvalue: 2500000

پیش‌نمایش

پیش‌نمایش

Prop	نوع	پیش‌فرض	توضیح
`value / defaultValue`	number \| string	—	مقدار کنترل‌شده یا اولیه
`onValueChange`	(value: number \| null) => void	—	عدد خام بدون جداکننده
`currency`	'rial' \| 'toman'	rial	واحد پول پیش‌فرض
`currencyLabel`	ReactNode	—	جایگزین برچسب واحد
`min / max`	number	—	محدودیت عددی — clamp در blur
`size`	'sm' \| 'md' \| 'lg'	md	ارتفاع کنترل
`tone`	'neutral' \| 'success' \| 'warning' \| 'danger'	neutral	رنگ مرز
`invalid`	boolean	false	خطای خارجی یا خارج از بازه
`inputMode`	'numeric' \| 'decimal'	numeric	نوع ورودی موبایل
`disabled / readOnly`	boolean	—	حالت غیرفعال یا فقط خواندنی

Affix colorvar(--taav-input-affix-color)

Radiusvar(--taav-input-radius-xl)

Height lgvar(--taav-input-height-lg)

Invalidvar(--taav-input-focus-ring-danger)