رفتن به محتوای اصلی

فارسی

نمایش مبلغ

مبلغ با تومان یا ریال، حالت خلاصه مثل «۱٫۲ میلیون» و مبلغ به حروف برای صفحه‌خوان.

import { Money } from "@kashi-ui/react";

نمونه

یک میلیون و دویست و پنجاه هزار تومانیک میلیون و دویست و پنجاه هزار تومانچهار میلیون و هشتصد و پنجاه هزار تومان
مثبت سیصد و بیست هزار تومانمنفی هشتاد و پنج هزار تومان
چهار تریلیون و دویست میلیارد تومان
<Money value={1250000} />
<Money value={1250000} compact />
<Money value={48500000} from="rial" compact />   {/* ریال به تومان */}
<Money value={-85000} signed />

در محصولات ایرانی مبلغ معمولاً در پایگاه داده به ریال است و به کاربر به تومان نشان داده می‌شود. با from="rial" تبدیل خودکار انجام می‌شود. حالت compact برای کارت‌ها و جدول‌ها مناسب است و برای اعداد بسیار بزرگ «همت» (هزار میلیارد تومان) را به کار می‌برد.

import { formatMoney } from "@kashi-ui/persian";
formatMoney(1250000);                    // "۱٬۲۵۰٬۰۰۰ تومان"
formatMoney(1250000, { compact: true }); // "۱٫۲۵ میلیون تومان"
formatMoney(5000, { unit: "rial" });     // "۵۰٬۰۰۰ ریال"
نامنوعپیش‌فرضتوضیح
valuenumber—
unit"toman" | "rial""toman"واحد نمایش
from"toman" | "rial""toman"واحد مقدار ورودی
compactbooleanfalseهزار، میلیون، میلیارد، همت
signedbooleanfalse+ و رنگ سبز یا قرمز
wordsbooleantrueمبلغ به حروف در title و برای صفحه‌خوان
size"sm" | "md" | "lg" | "xl""md"

دسترس‌پذیری

عنصر <data> مقدار عددی خام را در value نگه می‌دارد. صفحه‌خوان به جای ارقام جداشده، مبلغ را به حروف می‌خواند («یک میلیون و دویست و پنجاه هزار تومان»). رنگ مثبت و منفی همیشه همراه علامت + و − است.