مؤشرات التقدم
تُظهر مقدار ما أُنجز من مهمة: الرفع والأهداف والخطوات. استخدمها حين يمكن قياس التقدم، ومؤشر التحميل حين لا يمكن.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add progressويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/progressالاعتماديات التي يضيفها
@base-ui/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { ProgressBar } from "@/components/ui/progress";<ProgressBar value={60} label="Uploading statement.pdf" />أمثلة
المقاسات وغير المحدد
sm وmd وlg بارتفاع 2 و4 و8 بكسل؛ وvalue={null} يُظهر خطوطًا مائلة حين لا يُعرف المقدار.
بالخطوات
ProgressBarStepped من 3 إلى 8 خطوات: المكتملة والحالية والقادمة، ويُقرأ «الخطوة 3 من 8».
الدائرة
ProgressCircle لصفوف الرفع والمساحات الصغيرة، بمقاس 16 أو 20 أو 24، ويحتاج label.
مرجع الخصائص
ProgressBar
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
value | number | null | لا يوجد | المُنجز من min إلى max؛ null غير محدد. |
min / max | number | 0 / 100 | المدى. |
label | ReactNode | لا يوجد | ما يتقدم. |
showValue | boolean | true | خاصية Show text: النسبة في نهاية السطر. |
size | "sm" | "md" | "lg" | "md" | خاصية Size. |
numerals / aria-label | … | لا يوجد | نظام الأرقام، والاسم إن لم توجد تسمية ظاهرة. |
ProgressBarStepped
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
steps | number | لا يوجد | من 3 إلى 8. |
current | number | لا يوجد | الخطوات المكتملة؛ التالية قيد التنفيذ. |
label / size | … | لا يوجد | التسمية أسفل الشريط، والمقاس. |
inset | boolean | true | يُبقي المقاطع على بُعد 16 بكسل من الحافتين كما في Figma؛ false يمدّها بعرض الحاوية. |
ProgressCircle
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
value / min / max | number | لا يوجد | كما في الشريط. |
label | string | لا يوجد | مطلوب: لا نص ظاهر. |
size | 16 | 20 | 24 | 16 | المقاس. |
إمكانية الوصول
ARIA
-
role="progressbar"معaria-valuenowوaria-valueminوaria-valuemaxونص القيمة، ومسمّى بتسميته. - لا تعرضه لانتظار أقل من ثانية، ولا تجعله يعود للخلف.
ملاحظات العربية والاتجاه
ينعكس
- الشريط يمتلئ من بداية السطر: من اليمين في العربية، والخطوات كذلك.
لا ينعكس
- الدائرة تدور مع عقارب الساعة من الأعلى في الاتجاهين.
- الأرقام
- النسبة تتبع
numeralsأوRitlaProvider(٤٠٪). - الخط العربي
- التسمية
label-14بوزن Medium، وتسمية الخطواتlabel-16. - النص ثنائي الاتجاه
- أسماء الملفات اللاتينية في
<bdi>داخل تسمية عربية.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.