مسار التنقل
يبيّن موقع الصفحة في التسلسل ويتيح الرجوع إلى المستويات الأعلى. آخر مستوى هو الصفحة الحالية وليس رابطًا.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add breadcrumbويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/breadcrumbالاعتماديات التي يضيفها
@base-ui/react@phosphor-icons/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { Breadcrumb, BreadcrumbItem } from "@/components/ui/breadcrumb";<Breadcrumb> <BreadcrumbItem href="/" home /> <BreadcrumbItem href="/accounts">Accounts</BreadcrumbItem> <BreadcrumbItem current>Q1 2026 statement</BreadcrumbItem></Breadcrumb>أمثلة
شعار المنتج
Type = Logo: مرّر شعارك بدل أيقونة الرئيسية، وأعطه اسمًا. الشعار لا ينعكس.
مستوى طويل
يُقص المستوى الطويل عند 160 بكسل، ويظهر اسمه كاملًا في تلميح عند المرور أو التركيز، فقط حين يُقص فعلًا.
مستويات مطوية
BreadcrumbCollapsed يجمع المستويات الوسطى خلف «…» في قائمة.
روابط الموجّه
مرّر <Link> من Next في render: يحتفظ بسلوكه ويأخذ مظهر المستوى.
مرجع الخصائص
Breadcrumb
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
children | ReactNode | لا يوجد | المستويات بالترتيب من الأعلى إلى الصفحة الحالية. |
BreadcrumbItem
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
children | ReactNode | لا يوجد | خاصية Label: عنوان الصفحة كما هو. |
href | string | لا يوجد | وجهة المستوى. |
render | ReactElement | لا يوجد | رابط موجّه (<Link>) بمظهر المستوى. |
current | boolean | false | خاصية Current: الصفحة الحالية، ليست رابطًا، مع aria-current="page". |
home | boolean | false | Type = Icon: أيقونة HouseLine باسم «الرئيسية». مرّر شعارك كأبناء لـType = Logo. |
BreadcrumbCollapsed
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
items | { label, href }[] | لا يوجد | المستويات الوسطى المطوية بالترتيب. |
إرشادات الاستخدام
مسار التنقل يُري الناس أين هم في بنية الموقع ويعيدهم إلى المستويات الأعلى. هنا: متى تستخدمه، وكيف تسمّي مستوياته، وما تفعله بالمسارات الطويلة، وكيف يبدأ من اليمين في العربية، وما تتحقق منه قبل التسليم.
1. متى تستخدمه
استخدم مسار التنقل في الصفحات التي تقع على عمق مستويين أو أكثر تحت أعلى القسم: «الإعدادات»، ثم «الأمان»، ثم «الأجهزة». وهو ثانوي: التنقل الرئيسي يبقى صاحب العمل الأكبر، وعلى الهواتف يؤدي زر الرجوع في رأس التطبيق المهمة نفسها في مساحة أقل.
| الحالة | الاستخدام |
|---|---|
| عادية | مسارات قصيرة حتى أربعة مستويات. |
| مقصوصة مع تلميح | اسم مستوى طويل يُقص عند 160 بكسل، ويظهر الاسم كاملًا عند التمرير والتركيز. |
| مطوية | مسارات طويلة: تنتقل المستويات الوسطى خلف «…» الذي يفتح قائمة. |
افعل
- اعرض مسار التنقل في الصفحات التي على عمق مستويين أو أكثر.
- ضعه فوق عنوان الصفحة، عند بداية السطر.
- اعتمد على زر الرجوع في رأس التطبيق على الهواتف.
تجنّب
- استخدامه وسيلةَ التنقل الوحيدة.
- استخدامه لخطوات مسار؛ استخدم خطوات التقدم.
- عرض مسار من مستوى واحد في الصفحات العليا.
2. المستويات وأسماؤها
ابدأ من «الرئيسية» (الشعار أو أيقونة المنزل)، وسمِّ كل مستوى تمامًا كعنوان الصفحة التي يقود إليها. والمستوى الأخير هو الصفحة الحالية: ليس رابطًا، ومعلَّم بأنه الحالي.
افعل
- استخدم عناوين الصفحات أسماءً للمستويات.
- ابدأ من شعار الرئيسية أو أيقونتها.
- اعرض الصفحة الحالية أخيرًا، دون رابط.
تجنّب
- اختراع أسماء أقصر لا تطابق الصفحات.
- ربط الصفحة الحالية بنفسها.
- إدراج فئات ليست لها صفحة خاصة بها.
3. المسارات الطويلة
تُقص أسماء المستويات الطويلة عند 160 بكسل بعلامة حذف، وحينها فقط تحصل على تلميح بالاسم الكامل. وحين يتجاوز المسار أربعة مستويات تقريبًا، اطوِ المستويات الوسطى خلف «…»: تبقى «الرئيسية» والمستوى الأب والصفحة الحالية ظاهرة.
افعل
- أبقِ «الرئيسية» والمستوى الأب والصفحة الحالية ظاهرة.
- اطوِ المستويات الوسطى خلف «…» بعد أربعة مستويات تقريبًا.
- دع المستوى المقصوص يُظهر اسمه كاملًا عند التمرير والتركيز.
تجنّب
- التفاف المسار إلى سطرين.
- قص اسم الصفحة الحالية حين تتسع المساحة.
4. العربية والاتجاه من اليمين إلى اليسار
تبدأ النسخة العربية المسار من اليمين، عند «الرئيسية»، وتشير الفواصل إلى اليسار نحو المستويات الأعمق. وفي الكود يقع الفاصل في قائمة معكوسة فينعكس وحده. وأسماء المستويات التي تمزج العربية واللاتينية، مثل اسم منتج، تبقى مقروءة لأن كل مستوى معزول.
المسار يسير من اليمين
مسار تنقل فوق كشف حساب عربي.
قبل التسليم
- في الصفحات التي على عمق مستويين أو أكثر فقط.
- أسماء المستويات تطابق عناوين الصفحات؛ والصفحة الحالية أخيرة ودون رابط.
- القص والطي معروضان للمسارات الطويلة.
- الصفحات العربية تستخدم النسخة العربية، بدءًا من اليمين.
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| Tab | ينتقل بين الروابط؛ الصفحة الحالية ليست ضمنها. |
| Enter | يفتح المستوى، أو قائمة المستويات المطوية. |
| ArrowDownArrowUp | داخل القائمة: بين المستويات المطوية. |
ARIA
- عنصر
navباسم «مسار التنقل» بلغة الصفحة، وقائمة مرتبةol. - آخر مستوى
aria-current="page"، والفواصل مخفية عن قارئ الشاشة. - زر «…» باسم «إظهار المستويات المخفية» ويفتح قائمة روابط.
افعل
- علّم الصفحة الحالية بـ
aria-current="page". - اجعل الفواصل زخرفية ومخفية عن قارئات الشاشة.
- سمِّ أيقونة الرئيسية أو الشعار: «الرئيسية».
- مساحة لمس 48 بكسل لكل مستوى.
تجنّب
- قراءة الفواصل بصوت عالٍ «شرطة» أو «أكبر من».
- مسار تنقل بلا اسم للمعلم.
ملاحظات العربية والاتجاه
ينعكس
- المسار يبدأ من اليمين، والفواصل تتجه لليسار.
- قائمة المستويات المطوية تنفتح تحت «…» عند حافة البداية.
لا ينعكس
- الشعار وأيقونة الرئيسية.
- الأرقام
- الأرقام في العناوين كما كُتبت؛ استخدم
formatNumberلما تولّده. - الخط العربي
-
body-14بوزن Medium للمستويات وSemibold للصفحة الحالية. - النص ثنائي الاتجاه
- لا تثبّت فاصلًا يتجه لليمين: الفاصل يتبع الاتجاه وحده. ضع الأسماء الإنجليزية داخل عنوان عربي في
<bdi>.
افعل
- النسخة العربية، بدءًا من «الرئيسية» على اليمين.
- الفواصل تشير إلى اليسار، نحو الصفحة الحالية.
- أسماء المنتجات والعلامات تبقى بخطها.
تجنّب
- تثبيت فواصل تشير إلى اليمين في الصفحات العربية.
- عكس ترتيب المستويات يدويًا في النسخة الإنجليزية.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.
- نصوص سمات غير مترجمة (placeholder وalt وtitle وaria-label وقيمة الزر)
- نص مقصوص: محتوى أعرض من صندوقه مع overflow مخفي وبلا علامة حذف
- حاوية بعرض ثابت بالبكسل يتجاوز نصها العربي المساحة
- نص عربي يسقط إلى خط غير الخط المعلن (مقيسًا، أو وفق الإعلان، أو لأن خط الويب فشل في التحميل)
- تباعد حروف مطبَّق على نص عربي (يكسر الخط المتصل)
- flex بقيمة row-reverse تصطنع الاتجاه من اليمين بدل dir (ترتيب التنقل بالمفتاح Tab يعاكس الترتيب المرئي)