المبلغ
المال بعملته وإشارة وكسور اختيارية، بالأرقام التي يقرأ بها القارئ.
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
المعاينةالكود
إنجليزيمعكوسعربي
← RTL
التثبيت
أضف المكوّن
npx ritla add amountويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/amountأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { Amount } from "@/components/ui/amount";<Amount value={2450.75} decimals={3} unit="JOD" size="lg" />مرجع الخصائص
Amount
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
value | number | لا يوجد | القيمة؛ السالبة تظهر بالأحمر مع إشارة ناقص. |
unit | ReactNode | لا يوجد | خاصية Unit: رمز العملة أو أيقونتها أو وحدة أخرى. |
unitAfter | boolean | false | الوحدة بعد الرقم (مثل الغرام). |
decimals | number | 2 | خاصية Decimals: 3 للدينار. |
size | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "md" | خاصية Size. |
tone | "default" | "positive" | "negative" | لا يوجد | خاصية Tone. |
showSign | boolean | false | خاصية Show sign. |
fraction | "small" | "dimmed" | "same" | لا يوجد | خاصية Fraction. |
numerals | "latn" | "arab" | لا يوجد | الأرقام الغربية أو المشرقية. الافتراضي ما يحدده RitlaProvider. |
إمكانية الوصول
ARIA
- يُقرأ المبلغ كاملًا مع وحدته وإشارته.
ملاحظات العربية والاتجاه
ينعكس
- الوحدة تبقى في بداية المبلغ: على اليمين في العربية («د.أ 2,450.750»).
لا ينعكس
- الرقم معزول من اليسار إلى اليمين.
- الأرقام
- يتبع المبلغ إعداد الأرقام كسائر المبالغ في الصفحة:
٢٬٤٥٠٫٧٥٠بالأرقام المشرقية بفاصلتيها، و2,450.750بالغربية. يرسم Figma أرقامًا غربية في اللغتين. - الخط العربي
- أنماط
numeric-*بوزن Semibold.