التقييم
متوسط التقييم بالنجوم مع الدرجة وعدد المراجعات، يُقرأ جملة واحدة: «التقييم 4.8 من 5».
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
المعاينةالكود
إنجليزيمعكوسعربي
← RTL
التثبيت
أضف المكوّن
npx ritla add ratingويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/ratingأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { Rating } from "@/components/ui/rating";<Rating value={4.8} count={126} />مرجع الخصائص
Rating
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
value | number | لا يوجد | المتوسط من 0 إلى max. النجوم تُقرَّب إلى أقرب نجمة، والدرجة تُكتب بخانة عشرية. |
max | number | 5 | عدد النجوم. |
count | number | لا يوجد | عدد المراجعات، بين قوسين. |
showScore / showCount | boolean | true | خاصيتا Show score وShow count. |
label | string | لا يوجد | الاسم المقروء. افتراضيًا «التقييم 4.8 من 5، عدد المراجعات 126» بلغة الصفحة. |
إمكانية الوصول
ARIA
- التقييم كله صورة واحدة (
role="img") باسمه، فلا تقرأ قارئات الشاشة النجوم واحدة واحدة. - النجوم الممتلئة
icon/warning/dimوالفارغةicon/gray/faint: الفرق في الامتلاء أيضًا، لا في اللون وحده.
ملاحظات العربية والاتجاه
ينعكس
- النجوم تمتلئ من اليمين، والدرجة والعدد بعدها على اليسار، لأن الصف يتبع اتجاه الصفحة.
لا ينعكس
- شكل النجمة نفسه لا ينعكس.
- الأرقام
- الدرجة والعدد بأرقام الصفحة: 4.8 أو ٤٫٨ مع
numeralsفي RitlaProvider. - الخط العربي
label-14Semibold للدرجة وlabel-14بلونgray/mutedللعدد.