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

مؤشرات التقدم

احصل على Ritla UI

تُظهر مقدار ما أُنجز من مهمة: الرفع والأهداف والخطوات. استخدمها حين يمكن قياس التقدم، ومؤشر التحميل حين لا يمكن.

فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add progress

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

  2. الاعتماديات التي يضيفها

    @base-ui/react

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

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

الاستخدام

progress.tsx
import { ProgressBar } from "@/components/ui/progress";<ProgressBar value={60} label="Uploading statement.pdf" />

أمثلة

المقاسات وغير المحدد

‏sm وmd وlg بارتفاع 2 و4 و8 بكسل؛ وvalue={null} يُظهر خطوطًا مائلة حين لا يُعرف المقدار.

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

بالخطوات

ProgressBarStepped من 3 إلى 8 خطوات: المكتملة والحالية والقادمة، ويُقرأ «الخطوة 3 من 8».

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

الدائرة

ProgressCircle لصفوف الرفع والمساحات الصغيرة، بمقاس 16 أو 20 أو 24، ويحتاج label.

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

مرجع الخصائص

ProgressBar

الخاصيةالنوعالافتراضيالوصف
valuenumber | nullلا يوجدالمُنجز من min إلى max؛ null غير محدد.
min / maxnumber0 / 100المدى.
labelReactNodeلا يوجدما يتقدم.
showValuebooleantrueخاصية Show text: النسبة في نهاية السطر.
size"sm" | "md" | "lg""md"خاصية Size.
numerals / aria-label…لا يوجدنظام الأرقام، والاسم إن لم توجد تسمية ظاهرة.

ProgressBarStepped

الخاصيةالنوعالافتراضيالوصف
stepsnumberلا يوجدمن 3 إلى 8.
currentnumberلا يوجدالخطوات المكتملة؛ التالية قيد التنفيذ.
label / size…لا يوجدالتسمية أسفل الشريط، والمقاس.
insetbooleantrueيُبقي المقاطع على بُعد 16 بكسل من الحافتين كما في Figma؛ false يمدّها بعرض الحاوية.

ProgressCircle

الخاصيةالنوعالافتراضيالوصف
value / min / maxnumberلا يوجدكما في الشريط.
labelstringلا يوجدمطلوب: لا نص ظاهر.
size16 | 20 | 2416المقاس.

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

ARIA

  • ‏role="progressbar" مع aria-valuenow وaria-valuemin وaria-valuemax ونص القيمة، ومسمّى بتسميته.
  • لا تعرضه لانتظار أقل من ثانية، ولا تجعله يعود للخلف.

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

ينعكس

  • الشريط يمتلئ من بداية السطر: من اليمين في العربية، والخطوات كذلك.

لا ينعكس

  • الدائرة تدور مع عقارب الساعة من الأعلى في الاتجاهين.
الأرقام
النسبة تتبع numerals أو RitlaProvider (٤٠٪).
الخط العربي
التسمية label-14 بوزن Medium، وتسمية الخطوات label-16.
النص ثنائي الاتجاه
أسماء الملفات اللاتينية في <bdi> داخل تسمية عربية.

الفحوص التي يجتازها

فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.

  • R042نص مقصوص: محتوى أعرض من صندوقه مع overflow مخفي وبلا علامة حذف
  • R043حاوية بعرض ثابت بالبكسل يتجاوز نصها العربي المساحة
  • R050نص عربي يسقط إلى خط غير الخط المعلن (مقيسًا، أو وفق الإعلان، أو لأن خط الويب فشل في التحميل)
  • R051تباعد حروف مطبَّق على نص عربي (يكسر الخط المتصل)