السعر
سعر المنتج بعملته، ومعه في التخفيض السعر السابق مشطوبًا ووسم بنسبة الخصم. «JOD 288.00» بالإنجليزية و«288.00 د.أ» بالعربية.
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
المعاينةالكود
إنجليزيمعكوسعربي
← RTL
التثبيت
أضف المكوّن
npx ritla add priceويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/priceالاعتماديات التي يضيفها
tagأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { Price } from "@/components/ui/price";<Price amount={288} compareAt={360} />أمثلة
عملات الخليج
currency بالرمز الدولي. في العربية يُكتب الرمز المختصر كما في إيصالات المنطقة: ر.س، د.إ، د.ك.
إنجليزيمعكوسعربي
← RTL
مرجع الخصائص
Price
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
amount | number | لا يوجد | السعر بالوحدة الكبرى (288 لـ JOD 288.00). |
compareAt | number | لا يوجد | Type = Sale: السعر قبل الخصم. يظهر فقط إن كان أعلى من amount. |
size | "md" | "lg" | "md" | خاصية Size: numeric-16 للبطاقات والسلة، وnumeric-32 لصفحة المنتج. |
currency | string | "JOD" | رمز ISO 4217. |
fractionDigits | number | 2 | المنازل العشرية. المتاجر تكتب منزلتين حتى للدينار، فلا يظهر السعر بمنزلة واحدة. |
discount | string | false | لا يوجد | نص الوسم. افتراضيًا النسبة بلغة الصفحة («خصم 20%»)، وfalse يخفيه. |
formatPrice
الدالة نفسها لكتابة سعر في نص: formatPrice(288, { locale, numerals, currency }).
| الخاصية | النوع | الافتراضي | الوصف |
|---|
إمكانية الوصول
ARIA
- السعر السابق عنصر
delتسبقه كلمة «كان» مخفية، والحالي تسبقه «الآن»، فيُقرأ التخفيض كما يُرى. - النسبة نص في وسم، لا لون وحده.
ملاحظات العربية والاتجاه
ينعكس
- السعر أولًا على اليمين، ثم السعر السابق ثم وسم الخصم إلى اليسار.
لا ينعكس
- كل مبلغ معزول بـ
<bdi>، فلا ينقلب ترتيب «288.00 د.أ» داخل جملة عربية.
- الأرقام
- المبالغ والنسبة تتبع
numeralsفي RitlaProvider: 288.00 أو ٢٨٨٫٠٠. - الخط العربي
- أنماط
numeric-*بأرقام متساوية العرض، فلا تقفز الأسعار حين تتغير. - النص ثنائي الاتجاه
- العربية تكتب الرمز بعد الرقم (288.00 د.أ) بلا نقطة ختام، كما في إيصالات الأردن والخليج؛ Intl يضيف نقطة وعلامات اتجاه، لذا تُكتب الرموز الشائعة يدويًا.