المبلغ كتابةً
المبلغ بالأرقام ومكتوبًا بالحروف كما تطلبه الشيكات وإيصالات التحويل والفواتير، من رقم واحد فلا يختلفان أبدًا.
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
المعاينةالكود
إنجليزيمعكوسعربي
← RTL
التثبيت
أضف المكوّن
npx ritla add amount-in-wordsويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/amount-in-wordsأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { AmountInWords, amountInWords } from "@/components/ui/amount-in-words";<AmountInWords amount={1250.5} currency="SAR" /> // The words alone, for a PDF or an email:amountInWords(1250.5, "SAR", "ar"); // "فقط ألف ومئتان وخمسون ريالًا سعوديًا وخمسون هللة لا غير"أمثلة
العملات والمقاسات
الدينار بثلاث خانات للفلس، والمثنى «ديناران كويتيان»، والمقاس lg. note={null} يُخفي الملاحظة.
إنجليزيمعكوسعربي
← RTL
مرجع الخصائص
AmountInWords
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
amount | number | لا يوجد | المبلغ؛ يُقرّب إلى خانات العملة. |
currency | string | لا يوجد | SAR وJOD وKWD وBHD وAED وQAR وOMR وEGP وUSD (amountWordsCurrencies). |
size | "md" | "lg" | "md" | مقاس Figma. |
lang | "en" | "ar" | لا يوجد | لغة السطر المكتوب؛ لغة الصفحة افتراضيًا. |
label / wordsLabel / note | ReactNode | لا يوجد | التسميات والملاحظة؛ null يُخفي الملاحظة. |
amountInWords
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
(amount, currency, lang) | string | لا يوجد | السطر نفسه نصًّا، للمستندات والرسائل. |
إمكانية الوصول
ARIA
- مخرَج للقراءة فقط: لا شيء يُركَّز عليه. سطر الحروف يحمل
langالخاص به، فيقرؤه قارئ الشاشة بلغته حتى في صفحة إنجليزية.
ملاحظات العربية والاتجاه
ينعكس
- التسميات والصندوق تبدأ من اليمين.
لا ينعكس
- المبلغ بالأرقام وحدة واحدة من اليسار إلى اليمين، فلا تنفصل العملة عن الرقم.
- الأرقام
- المبلغ بالأرقام يبقى بالأرقام اللاتينية كما في Figma وكما تُكتب الشيكات، أيًّا كان إعداد الأرقام.
- الخط العربي
- بالعربية يتبع صيغة الشيك «فقط … لا غير»: العدد من ثلاثة إلى عشرة يخالف المعدود في التذكير والتأنيث («ثلاثة ريالات»، «خمس هللات»)، ومن أحد عشر إلى تسعة وتسعين يأتي المعدود مفردًا منصوبًا («خمسة عشر دينارًا»)، والمثنى المضاف يحذف نونه («ألفا دينار»).
- النص ثنائي الاتجاه
- سطر الحروف يحمل
langوdirلغته، فيمكن عرض الحروف العربية في صفحة إنجليزية دون أن تنقلب علامات الترقيم.