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

خطوات التقدم

احصل على Ritla UI

تبيّن موقع المستخدم في مسار من عدة مراحل مثل فتح حساب: علامة صح على المنجز، ولون العلامة على الخطوة الحالية، والباقي رمادي.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add progress-steps

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

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

    @phosphor-icons/react

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

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

الاستخدام

progress-steps.tsx
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>

أمثلة

مختصر

نقاط على خط والتسميات فوقها، حتى ست خطوات.

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

بالأيقونات

أيقونة في كل دائرة؛ الخطوات المنجزة تعرض علامة الصح.

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

عمودي

للهاتف واللوحات الجانبية.

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

مرجع الخصائص

ProgressSteps

الخاصيةالنوعالافتراضيالوصف
currentnumberلا يوجدخاصية 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-labelstringلا يوجداسم المسار لقارئ الشاشة («فتح الحساب»).

ProgressStep

الخاصيةالنوعالافتراضيالوصف
childrenReactNodeلا يوجدخاصية Label: ما يفعله المستخدم في الخطوة.
iconIconComponentلا يوجدأيقونة الدائرة في نمط الأيقونات.
hrefstringلا يوجدرابط للعودة إلى خطوة منجزة وتعديلها.

إرشادات الاستخدام

خطوات التقدم تُري الناس أين هم في مسار مرتّب وكم بقي. هنا: متى تساعد، وأي نمط، وكيف تسمّي الخطوات وتعلّمها، وتخطيطها على الشاشات الصغيرة، وكيف تسير من اليمين في العربية، وما تتحقق منه قبل التسليم.

1. متى تساعد الخطوات

استخدم خطوات التقدم لمسار من ثلاث إلى ست مراحل تجري بترتيب ثابت: فتح حساب، أو إتمام شراء، أو تتبّع توصيل. وهي تجيب عن «أين أنا وكم بقي». وحين لا يكون هناك ترتيب، أو تكون مهمة واحدة، فمكوّنات أخرى أنسب.

تحتاج إلىاستخدمالسبب
إرشاد الناس عبر 3 إلى 6 مراحل مرتّبةخطوات التقدمتُظهر المرحلة وما بقي.
تتبّع طلب أو معاملة مع الوقتخطوات التقدم، النمط المختصرنقاط مدمجة بتسميات حالة قصيرة.
إظهار مدى تقدّم مهمة واحدة (رفع ملف)شريط التقدّممهمة واحدة ونسبة مئوية.
تقسيم المحتوى إلى أقسام متكافئةالتبويباتلا ترتيب؛ ينتقل الناس بحرية.
مسار من أكثر من 6 مراحلخطوات التقدم بمراحل مجمّعةجمّع المراحل كي يرى الناس ستًا على الأكثر.

2. أي نمط

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

النمطالاستخدام
أرقامالنماذج والتعريف بالتطبيق في 3 أو 4 مراحل؛ الأرقام تُظهر كم بقي.
أيقوناتالشيء نفسه، حين تقول الأيقونة أكثر من الرقم: الهوية، العنوان، البطاقة.
مختصرحتى 6 مراحل في مساحة صغيرة، مثل تتبّع طلب أو توصيل.

3. تسمية الخطوات وتعليمها

سمِّ كل خطوة بما يفعله الناس فيها، في كلمتين أو ثلاث: «البيانات الشخصية»، «التحقق من الهوية»، «العنوان»، «التمويل». ولا تعلّم الخطوة منجزةً إلا بعد حفظ بياناتها. ويستطيع الناس الرجوع إلى الخطوات المنجزة؛ والقفز إلى الأمام مسموح فقط حين لا يهم الترتيب.

سمِّ ما يحدث هناك

فتح حساب، في المرحلة الثانية.

افعل: أسماء المهاميعرف الناس ما بقي: تحقق من الهوية، ثم عنوان، ثم تمويل.
تجنّب: أرقام بلا أسماء«الخطوة 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 للأرقام.
النص ثنائي الاتجاه
التسمية لا تنكسر في الأفقي؛ اجعلها قصيرة.

افعل

  • النسخة العربية، والخطوة الأولى على اليمين.
  • اكتب أسماء الخطوات بالعربية أصلًا، وأبقِها قصيرة.
  • أبقِ علامة الصح كما هي.

تجنّب

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

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

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

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