خطوات التقدم
تبيّن موقع المستخدم في مسار من عدة مراحل مثل فتح حساب: علامة صح على المنجز، ولون العلامة على الخطوة الحالية، والباقي رمادي.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add progress-stepsويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/progress-stepsالاعتماديات التي يضيفها
@phosphor-icons/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { ProgressStep, ProgressSteps } from "@/components/ui/progress-steps";<ProgressSteps current={2} aria-label="Account opening"> <ProgressStep href="/open/details">Personal details</ProgressStep> <ProgressStep>Verify ID</ProgressStep> <ProgressStep>Address</ProgressStep></ProgressSteps>أمثلة
مرجع الخصائص
ProgressSteps
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
current | number | لا يوجد | خاصية Current step: الخطوة الحالية تبدأ من 1، وما قبلها منجز. |
variant | "numbers" | "minimal" | "icons" | "numbers" | مجموعات Figma الثلاث. |
orientation | "auto" | "horizontal" | "vertical" | "auto" | خاصية Direction. auto عمودي على الجوال وأفقي من md، فالخطوات بعناوينها لا تتسع جنبًا إلى جنب على الجوال. horizontal وvertical تثبّتان الاتجاه. minimal يبقى أفقيًا مع auto. |
numerals | "latn" | "arab" | "latn" | نظام أرقام الخطوات. |
aria-label | string | لا يوجد | اسم المسار لقارئ الشاشة («فتح الحساب»). |
ProgressStep
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
children | ReactNode | لا يوجد | خاصية Label: ما يفعله المستخدم في الخطوة. |
icon | IconComponent | لا يوجد | أيقونة الدائرة في نمط الأيقونات. |
href | string | لا يوجد | رابط للعودة إلى خطوة منجزة وتعديلها. |
إرشادات الاستخدام
خطوات التقدم تُري الناس أين هم في مسار مرتّب وكم بقي. هنا: متى تساعد، وأي نمط، وكيف تسمّي الخطوات وتعلّمها، وتخطيطها على الشاشات الصغيرة، وكيف تسير من اليمين في العربية، وما تتحقق منه قبل التسليم.
1. متى تساعد الخطوات
استخدم خطوات التقدم لمسار من ثلاث إلى ست مراحل تجري بترتيب ثابت: فتح حساب، أو إتمام شراء، أو تتبّع توصيل. وهي تجيب عن «أين أنا وكم بقي». وحين لا يكون هناك ترتيب، أو تكون مهمة واحدة، فمكوّنات أخرى أنسب.
| تحتاج إلى | استخدم | السبب |
|---|---|---|
| إرشاد الناس عبر 3 إلى 6 مراحل مرتّبة | خطوات التقدم | تُظهر المرحلة وما بقي. |
| تتبّع طلب أو معاملة مع الوقت | خطوات التقدم، النمط المختصر | نقاط مدمجة بتسميات حالة قصيرة. |
| إظهار مدى تقدّم مهمة واحدة (رفع ملف) | شريط التقدّم | مهمة واحدة ونسبة مئوية. |
| تقسيم المحتوى إلى أقسام متكافئة | التبويبات | لا ترتيب؛ ينتقل الناس بحرية. |
| مسار من أكثر من 6 مراحل | خطوات التقدم بمراحل مجمّعة | جمّع المراحل كي يرى الناس ستًا على الأكثر. |
2. أي نمط
ثلاثة أنماط تشترك في سلوك واحد: الخطوات المنجزة تحمل علامة صح، والحالية بلون العلامة، واللاحقة تنتظر بالرمادي.
| النمط | الاستخدام |
|---|---|
| أرقام | النماذج والتعريف بالتطبيق في 3 أو 4 مراحل؛ الأرقام تُظهر كم بقي. |
| أيقونات | الشيء نفسه، حين تقول الأيقونة أكثر من الرقم: الهوية، العنوان، البطاقة. |
| مختصر | حتى 6 مراحل في مساحة صغيرة، مثل تتبّع طلب أو توصيل. |
3. تسمية الخطوات وتعليمها
سمِّ كل خطوة بما يفعله الناس فيها، في كلمتين أو ثلاث: «البيانات الشخصية»، «التحقق من الهوية»، «العنوان»، «التمويل». ولا تعلّم الخطوة منجزةً إلا بعد حفظ بياناتها. ويستطيع الناس الرجوع إلى الخطوات المنجزة؛ والقفز إلى الأمام مسموح فقط حين لا يهم الترتيب.
سمِّ ما يحدث هناك
فتح حساب، في المرحلة الثانية.
افعل
- سمِّ الخطوات بالمهمة: «التحقق من الهوية»، لا «الخطوة 2».
- علّم الخطوة منجزةً فقط بعد حفظها.
- اسمح بالرجوع إلى الخطوات المنجزة لتعديلها.
- طابِق أسماء الخطوات مع عناوين صفحات كل مرحلة.
تجنّب
- تسمية الخطوات «الخطوة 1، الخطوة 2، الخطوة 3».
- السماح بالقفز إلى خطوة لاحقة تعتمد على ما قبلها.
- تغيير عدد الخطوات في منتصف المسار.
4. التخطيط والشاشات الصغيرة
استخدم الخطوات الأفقية فوق النموذج على الحاسوب. وعلى الهواتف، أو حين تطول الأسماء، استخدم الاتجاه العمودي، أو اعرض الخطوة الحالية وحدها مع «الخطوة 2 من 4» واسمها. وأبقِ الخطوات ظاهرة طوال المسار.
افعل
- خطوات أفقية على الشاشات العريضة، وعمودية في الأعمدة الضيقة.
- على الهواتف اعرض «الخطوة 2 من 4» مع اسم الخطوة الحالية.
- أبقِ الخطوات في المكان نفسه في كل مرحلة.
تجنّب
- حشر ست خطوات أفقية في شاشة هاتف.
- إخفاء الخطوات في بعض مراحل المسار.
5. العربية والاتجاه من اليمين إلى اليسار
تسير النسخ العربية من اليمين: الخطوة الأولى على اليمين والتقدّم يتجه يسارًا، والخط الواصل يمتلئ من اليمين. وتتبع الأرقام إعداد الأرقام. ولا تنعكس علامة الصح. والأسماء العربية للخطوات أطول غالبًا؛ فكّر في الاتجاه العمودي حين تلتف.
التقدّم يسير من اليمين
فتح حساب بالعربية، في المرحلة الثانية.
قبل التسليم
- من 3 إلى 6 خطوات بترتيب ثابت، مسمّاة بالمهمة.
- حالات المنجز والحالي واللاحق معروضة، والرجوع مصمّم.
- تخطيط الهاتف محسوم: عمودي أو «الخطوة 2 من 4».
- الشاشات العربية تستخدم النسخ العربية، بدءًا من اليمين.
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| Tab | إلى روابط الخطوات المنجزة فقط؛ الخطوات الأخرى ليست تفاعلية. |
ARIA
- قائمة مرتبة
olباسم المسار، والخطوة الحاليةaria-current="step". - كل خطوة تقول حالتها نصًا بلغة الصفحة: «الخطوة 2 من 4، الحالية»، لا باللون وحده.
- لا تعلّم خطوة كمنجزة قبل حفظ بياناتها.
افعل
- ضع
aria-current="step"على الخطوة الحالية. - قل «منجزة» للخطوات المنجزة، لا علامة الصح وحدها.
- أعلن الموقع: «الخطوة 2 من 4، التحقق من الهوية».
- اجعل الخطوات المنجزة روابط أو أزرارًا حين يستطيع الناس الرجوع إليها.
تجنّب
- الاكتفاء باللون لتمييز الخطوة الحالية.
- جعل الخطوات اللاحقة قابلة للتركيز وهي لا تُفتح.
ملاحظات العربية والاتجاه
ينعكس
- المسار يبدأ من اليمين، والخطوط تمتد نحو اليسار.
- في العمودي تكون الدوائر على اليمين والتسميات على يسارها.
لا ينعكس
- علامة الصح وأيقونات الخطوات.
- الأرقام
- أرقام الخطوات ونص الحالة بنظام الأرقام المختار (١ ٢ ٣ أو 1 2 3).
- الخط العربي
-
body-14للتسميات وlabel-16بوزن Medium للأرقام. - النص ثنائي الاتجاه
- التسمية لا تنكسر في الأفقي؛ اجعلها قصيرة.
افعل
- النسخة العربية، والخطوة الأولى على اليمين.
- اكتب أسماء الخطوات بالعربية أصلًا، وأبقِها قصيرة.
- أبقِ علامة الصح كما هي.
تجنّب
- خطوات إنجليزية في شاشة عربية، فيبدو التقدّم كأنه يسير إلى الوراء.
- عكس علامة الصح أو الأيقونات داخل الدوائر.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.