CurrencyInput — مبلغ با ارز

برای هر مبلغی که کاربر وارد می‌کند: سرمایه‌گذاری، مبلغ هدف، قیمت. مقدار همیشه عدد خام است (مثلاً )؛ قالب‌بندی با ارقام محلی و نماد ارز فقط نمایش است و در داده ذخیره نمی‌شود.

وضعیت: beta · لایه: ۳ () · کد:

TSX

import { CurrencyInput } from '@tokapps/tuk';

نمونهٔ زنده

مبلغ سرمایه‌گذاری

Amount

مبلغ هدف

بین ۱ میلیون تا ۵ میلیارد ریال

مبلغ

مبلغ باید بیشتر از صفر باشد

کوچک

متوسط

بزرگ

کد قابل کپی

ریال با ارقام فارسی

TSX

import { CurrencyInput } from '@tokapps/tuk';<CurrencyInput label="مبلغ سرمایه‌گذاری" currency="IRR" locale="fa-IR" value={amount} onChange={setAmount} />

دلار با ارقام لاتین

TSX

<CurrencyInput label="Amount" currency="USD" locale="en-US" />

بازهٔ مجاز با توضیح

TSX

<CurrencyInput  name="target"  label="مبلغ هدف"  currency="IRR"  minValue={1_000_000}  maxValue={5_000_000_000}  step={100_000}  description="بین ۱ میلیون تا ۵ میلیارد ریال"  isRequired/>

همهٔ پیکربندی‌ها

پراپ	نوع	پیش‌فرض	توضیح
		—	برچسب قابل‌مشاهده.
		—	توضیح زیر فیلد (مثلاً بازهٔ مجاز).
		—	پیام خطا؛ فقط با .
	(کد ISO)		کد ارز، مثل یا . نماد با نشان داده می‌شود.
			زبان و ارقام. ارقام فارسی و ارقام لاتین.
	· ·		اندازهٔ فیلد.
	·		نمایش مبلغ در چاپ.
/		—	مقدار عددی خام (کنترل‌شده یا اولیه).
		—	با هر تغییر؛ عدد خام می‌دهد، نه متن.
/		—	کرانه‌ها؛ خارج از بازه خطا می‌دهد.
			گام با دکمه‌های بالا و پایین و کلید فلش.
			باید مقدار داشته باشد.
			حالت خطا.
			مقدار دیده می‌شود، تغییر نمی‌کند.
			غیرفعال.
		—	نام فیلد در .
		—	کلاس روی ریشه.

این کامپوننت پراپ ندارد؛ مبلغ‌ها بی‌صدا هستند تا تجربهٔ مالی آرام بماند.

حالت‌ها

حالت	نمایش
خالی	نماد ارز و placeholder
با مقدار	مبلغ قالب‌بندی‌شده با جداکنندهٔ هزارگان و نماد
	حاشیهٔ خطا، آیکون و پیام
/	همان الگوی Input

RTL و کیبورد

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

حرکت و چاپ

حرکت: فقط گذار حاشیه با توکن‌های Input؛ در کاهش حرکت بی‌انیمیشن.
چاپ: پیش‌فرض؛ مبلغ با نماد ارز چاپ می‌شود.

توکن‌ها

کامپوننتی: ، (با و )، ، ، (اندازه‌ها در //)، ، (رنگ نماد ارز)، ، ، ، .
تعریف در ؛ فهرست کامل در .

نکات

مقدار را همیشه به‌صورت عدد ذخیره کنید؛ رشتهٔ قالب‌بندی‌شده را به سرور نفرستید.
برای مبلغ یک‌بار مصرف به‌صورت بازه از Slider با هم می‌توانید استفاده کنید.