انتقل إلى المحتوى

المبلغ

تجريبي
احصل على Ritla UI

المال بعملته وإشارة وكسور اختيارية، بالأرقام التي يقرأ بها القارئ.

المعاينة

«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.

المعاينةالكود
إنجليزيمعكوسعربي
← RTL

التثبيت

  1. أضف المكوّن

    npx ritla add amount

    ويعمل أيضًا مع shadcn: npx shadcn@latest add @ritla/amount

  2. أو انسخه يدويًا

    التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.

الاستخدام

amount.tsx
import { Amount } from "@/components/ui/amount";<Amount value={2450.75} decimals={3} unit="JOD" size="lg" />

مرجع الخصائص

Amount

الخاصيةالنوعالافتراضيالوصف
valuenumberلا يوجدالقيمة؛ السالبة تظهر بالأحمر مع إشارة ناقص.
unitReactNodeلا يوجدخاصية Unit: رمز العملة أو أيقونتها أو وحدة أخرى.
unitAfterbooleanfalseالوحدة بعد الرقم (مثل الغرام).
decimalsnumber2خاصية Decimals: ‏3 للدينار.
size"sm" | "md" | "lg" | "xl" | "2xl" | "3xl""md"خاصية Size.
tone"default" | "positive" | "negative"لا يوجدخاصية Tone.
showSignbooleanfalseخاصية Show sign.
fraction"small" | "dimmed" | "same"لا يوجدخاصية Fraction.
numerals"latn" | "arab"لا يوجدالأرقام الغربية أو المشرقية. الافتراضي ما يحدده RitlaProvider.

إمكانية الوصول

ARIA

  • يُقرأ المبلغ كاملًا مع وحدته وإشارته.

ملاحظات العربية والاتجاه

ينعكس

  • الوحدة تبقى في بداية المبلغ: على اليمين في العربية («د.أ 2,450.750»).

لا ينعكس

  • الرقم معزول من اليسار إلى اليمين.
الأرقام
يتبع المبلغ إعداد الأرقام كسائر المبالغ في الصفحة: ٢٬٤٥٠٫٧٥٠ بالأرقام المشرقية بفاصلتيها، و2,450.750 بالغربية. يرسم Figma أرقامًا غربية في اللغتين.
الخط العربي
أنماط numeric-* بوزن Semibold.