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

التقييم

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

متوسط التقييم بالنجوم مع الدرجة وعدد المراجعات، يُقرأ جملة واحدة: «التقييم 4.8 من 5».

المعاينة

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

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

التثبيت

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

    npx ritla add rating

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

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

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

الاستخدام

rating.tsx
import { Rating } from "@/components/ui/rating";<Rating value={4.8} count={126} />

مرجع الخصائص

Rating

الخاصيةالنوعالافتراضيالوصف
valuenumberلا يوجدالمتوسط من 0 إلى max. النجوم تُقرَّب إلى أقرب نجمة، والدرجة تُكتب بخانة عشرية.
maxnumber5عدد النجوم.
countnumberلا يوجدعدد المراجعات، بين قوسين.
showScore / showCountbooleantrueخاصيتا Show score وShow count.
labelstringلا يوجدالاسم المقروء. افتراضيًا «التقييم 4.8 من 5، عدد المراجعات 126» بلغة الصفحة.

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

ARIA

  • التقييم كله صورة واحدة (role="img") باسمه، فلا تقرأ قارئات الشاشة النجوم واحدة واحدة.
  • النجوم الممتلئة icon/warning/dim والفارغة icon/gray/faint: الفرق في الامتلاء أيضًا، لا في اللون وحده.

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

ينعكس

  • النجوم تمتلئ من اليمين، والدرجة والعدد بعدها على اليسار، لأن الصف يتبع اتجاه الصفحة.

لا ينعكس

  • شكل النجمة نفسه لا ينعكس.
الأرقام
الدرجة والعدد بأرقام الصفحة: 4.8 أو ٤٫٨ مع numerals في RitlaProvider.
الخط العربي
label-14 Semibold للدرجة وlabel-14 بلون gray/muted للعدد.