قائمة التنقل
تنقّل الموقع بلوحات منسدلة: كل لوحة فيها وجهات قليلة بأيقونة وسطر قصير، وبطاقة مميزة واحدة على الأكثر.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add navigation-menuويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/navigation-menuالاعتماديات التي يضيفها
@base-ui/react@phosphor-icons/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
import { NavigationMenu, NavigationMenuContent, NavigationMenuItem, NavigationMenuLink, NavigationMenuLinks, NavigationMenuList, NavigationMenuPanelLink, NavigationMenuTrigger,} from "@/components/ui/navigation-menu";<NavigationMenu aria-label="Main"> <NavigationMenuList> <NavigationMenuItem> <NavigationMenuTrigger>Products</NavigationMenuTrigger> <NavigationMenuContent> <NavigationMenuLinks> <NavigationMenuPanelLink href="/payments" icon={CreditCardIcon} title="Payments" description="Accept cards, Apple Pay and CliQ." /> </NavigationMenuLinks> </NavigationMenuContent> </NavigationMenuItem> <NavigationMenuItem> <NavigationMenuLink href="/pricing">Pricing</NavigationMenuLink> </NavigationMenuItem> </NavigationMenuList></NavigationMenu>أمثلة
عمود واحد، والصفحة الحالية
columns={1} للوحات القصيرة وبلا بطاقة مميزة. الرابط البسيط للصفحة الحالية يأخذ active (aria-current="page").
على خلفية داكنة
tone="inverse" على الجذر: تسميات بيضاء وتعبئة بيضاء شفافة عند المرور، لصف على شريط داكن أو صورة أو لون العلامة. اللوحة تبقى فاتحة. وفي اللوحة NavigationMenuFooter مع رابطه، واحد لكل لوحة.
مرجع الخصائص
NavigationMenu
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
aria-label | string | لا يوجد | اسم التنقل، إن كان في الصفحة أكثر من nav. |
delay / closeDelay | number | 50 / 50 | المهلة قبل الفتح والإغلاق بالمؤشر (ملّي ثانية). |
value / onValueChange | string | null | لا يوجد | اللوحة المفتوحة، للتحكم من الكود. |
tone | "default" | "inverse" | "default" | خاصية Tone في _Nav link، للصف كله. |
NavigationMenuTrigger
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
children | ReactNode | لا يوجد | خاصية Label. السهم يُضاف تلقائيًا. |
NavigationMenuLink
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
href | string | لا يوجد | رابط بسيط في الصف، بلا لوحة. |
active | boolean | لا يوجد | الصفحة الحالية. |
render | ReactElement | لا يوجد | رابط إطار العمل، مثل <Link /> من Next. |
NavigationMenuLinks
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
columns | 1 | 2 | 2 | أعمدة الروابط، بعرض 220px. |
NavigationMenuPanelLink
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
icon | IconComponent | لا يوجد | أيقونة في مربع brand/faint. |
title | ReactNode | لا يوجد | خاصية Title: الوجهة. |
description | ReactNode | لا يوجد | خاصية Description: سطر قصير. |
href / render | string / ReactElement | لا يوجد | الرابط. |
NavigationMenuFeatured
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
tag | ReactNode | لا يوجد | الوسم الصغير في الأعلى («جديد»). |
title / description | ReactNode | لا يوجد | العنوان والوصف. |
linkLabel | ReactNode | لا يوجد | الدعوة في الأسفل؛ البطاقة كلها رابط. |
NavigationMenuFooter, NavigationMenuFooterLink
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
link | ReactNode | لا يوجد | NavigationMenuFooterLink في بداية التذييل («كل المنتجات»)، بسهم ينعكس في العربية. |
children | ReactNode | لا يوجد | سطر المساعدة في نهاية التذييل؛ قد يحمل رابطًا. |
href | string | لا يوجد | NavigationMenuFooterLink: الوجهة. |
إرشادات الاستخدام
قائمة التنقل شريط روابط في ترويسة الموقع، بعضها يفتح لوحات. هنا: الفرق بين الروابط والمحفّزات، واللوحات، وكيف تنعكس في العربية، وما تتحقق منه قبل التسليم.
1. الروابط والمحفّزات
الرابط العادي يذهب إلى صفحة، والمحفّز يفتح لوحة. والجمع بينهما في شريط واحد لا بأس به؛ فالسهم يميّز بينهما.
افعل
- اعرض السهم على المحفّزات فقط.
- أبقِ القسم الحالي معلَّمًا بالحالة النشطة.
تجنّب
- جعل المحفّز ينتقل إلى صفحة أيضًا عند النقر.
- أكثر من ستة عناصر.
2. اللوحات
تحاذي اللوحات حافة بداية محفّزها ولا تتجاوز عرض الترويسة أبدًا. وعلى الهواتف تنتقل المجموعات نفسها إلى الدرج الجانبي خلف زر قائمة.
افعل
- استخدم نسخ
Header baseللحاسوب والجوال. - جمّع روابط اللوحة في أعمدة من خمسة روابط أو أقل.
تجنّب
- ترك لوحة تغطي القسم الافتتاحي.
- تحريك اللوحات لأكثر من 150 ملّي ثانية.
3. العربية والاتجاه من اليمين إلى اليسار
ينعكس ترتيب الروابط، وتحاذي اللوحات بداية محفّزها. ويبقى الشعار عند بداية السطر.
قبل التسليم
Header baseللحاسوب والجوال في الاتجاهين.- حالة لوحة مفتوحة واحدة معروضة.
- الرابط النشط معلَّم في الصفحة الحالية.
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| Tab | بين عناصر الصف؛ من زر مفتوح إلى روابط لوحته ثم إلى العنصر التالي. |
| EnterSpace | على زر: يفتح لوحته أو يغلقها. |
| ArrowRightArrowLeft | بين عناصر الصف؛ بالعربية السهم الأيسر إلى التالي. |
| Esc | يغلق اللوحة ويعيد التركيز إلى زرها. |
ARIA
-
<nav>فيه قائمة (ul) من العناصر؛ لكل زرaria-expandedوaria-controls. - روابط اللوحة روابط حقيقية، والبطاقة المميزة رابط واحد.
- الأزرار ارتفاعها 32px ومنطقة لمسها 48px عموديًا فقط.
- على الجوال: زر قائمة يفتح درجًا فيه المجموعات نفسها في أكورديون.
ملاحظات العربية والاتجاه
ينعكس
- أول عنصر على اليمين، واللوحة تبدأ من الحافة اليمنى للصف.
- روابط اللوحة تُقرأ من اليمين، والبطاقة المميزة على اليسار.
- في التذييل الرابط على اليمين وسهمه يشير إلى اليسار، وسطر المساعدة على اليسار.
لا ينعكس
- سهم الزر يشير إلى الأسفل ويدور عند الفتح، ولا ينعكس.
- أيقونات الروابط لا تنعكس.
- الأرقام
- الأرقام في الأوصاف تتبع إعداد الأرقام (
toNumeralsللنصوص الثابتة). - الخط العربي
- الأزرار
label-16Medium (وSemibold حين تكون لوحتها مفتوحة)، وعناوين الروابطlabel-14Semibold، والأوصافlabel-12، وعنوان البطاقةlabel-16Semibold. - النص ثنائي الاتجاه
- أسماء المنتجات اللاتينية (Apple Pay وiOS) داخل الوصف العربي تبقى بترتيبها. اللوحة تحمل اتجاه الصفحة ولغتها إلى خارجها.
افعل
- اضبط
Nav positionعلى Start أو Center كما في الإنجليزية؛ ينعكس وحده. - جرّب التسميات العربية الطويلة بعرض الجهاز اللوحي.
تجنّب
- توسيط الروابط تهرّبًا من الاتجاه من اليمين إلى اليسار.
- عكس الأسهم التي تشير إلى الأسفل.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.
- نص مقصوص: محتوى أعرض من صندوقه مع overflow مخفي وبلا علامة حذف
- حاوية بعرض ثابت بالبكسل يتجاوز نصها العربي المساحة
- نص عربي يسقط إلى خط غير الخط المعلن (مقيسًا، أو وفق الإعلان، أو لأن خط الويب فشل في التحميل)
- تباعد حروف مطبَّق على نص عربي (يكسر الخط المتصل)
- flex بقيمة row-reverse تصطنع الاتجاه من اليمين بدل dir (ترتيب التنقل بالمفتاح Tab يعاكس الترتيب المرئي)