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

قائمة التنقل

احصل على Ritla UI

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

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add navigation-menu

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

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

    @base-ui/react@phosphor-icons/react

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

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

الاستخدام

navigation-menu.tsx
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").

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

على خلفية داكنة

‏tone="inverse" على الجذر: تسميات بيضاء وتعبئة بيضاء شفافة عند المرور، لصف على شريط داكن أو صورة أو لون العلامة. اللوحة تبقى فاتحة. وفي اللوحة NavigationMenuFooter مع رابطه، واحد لكل لوحة.

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

مرجع الخصائص

NavigationMenu

الخاصيةالنوعالافتراضيالوصف
aria-labelstringلا يوجداسم التنقل، إن كان في الصفحة أكثر من nav.
delay / closeDelaynumber50 / 50المهلة قبل الفتح والإغلاق بالمؤشر (ملّي ثانية).
value / onValueChangestring | nullلا يوجداللوحة المفتوحة، للتحكم من الكود.
tone"default" | "inverse""default"خاصية Tone في _Nav link، للصف كله.

NavigationMenuTrigger

الخاصيةالنوعالافتراضيالوصف
childrenReactNodeلا يوجدخاصية Label. السهم يُضاف تلقائيًا.

NavigationMenuLink

الخاصيةالنوعالافتراضيالوصف
hrefstringلا يوجدرابط بسيط في الصف، بلا لوحة.
activebooleanلا يوجدالصفحة الحالية.
renderReactElementلا يوجدرابط إطار العمل، مثل <Link /> من Next.

NavigationMenuLinks

الخاصيةالنوعالافتراضيالوصف
columns1 | 22أعمدة الروابط، بعرض 220px.

NavigationMenuPanelLink

الخاصيةالنوعالافتراضيالوصف
iconIconComponentلا يوجدأيقونة في مربع brand/faint.
titleReactNodeلا يوجدخاصية Title: الوجهة.
descriptionReactNodeلا يوجدخاصية Description: سطر قصير.
href / renderstring / ReactElementلا يوجدالرابط.

NavigationMenuFeatured

الخاصيةالنوعالافتراضيالوصف
tagReactNodeلا يوجدالوسم الصغير في الأعلى («جديد»).
title / descriptionReactNodeلا يوجدالعنوان والوصف.
linkLabelReactNodeلا يوجدالدعوة في الأسفل؛ البطاقة كلها رابط.

NavigationMenuFooter, NavigationMenuFooterLink

الخاصيةالنوعالافتراضيالوصف
linkReactNodeلا يوجدNavigationMenuFooterLink في بداية التذييل («كل المنتجات»)، بسهم ينعكس في العربية.
childrenReactNodeلا يوجدسطر المساعدة في نهاية التذييل؛ قد يحمل رابطًا.
hrefstringلا يوجدNavigationMenuFooterLink: الوجهة.

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

قائمة التنقل شريط روابط في ترويسة الموقع، بعضها يفتح لوحات. هنا: الفرق بين الروابط والمحفّزات، واللوحات، وكيف تنعكس في العربية، وما تتحقق منه قبل التسليم.

2. اللوحات

تحاذي اللوحات حافة بداية محفّزها ولا تتجاوز عرض الترويسة أبدًا. وعلى الهواتف تنتقل المجموعات نفسها إلى الدرج الجانبي خلف زر قائمة.

افعل

  • استخدم نسخ Header base للحاسوب والجوال.
  • جمّع روابط اللوحة في أعمدة من خمسة روابط أو أقل.

تجنّب

  • ترك لوحة تغطي القسم الافتتاحي.
  • تحريك اللوحات لأكثر من 150 ملّي ثانية.

3. العربية والاتجاه من اليمين إلى اليسار

ينعكس ترتيب الروابط، وتحاذي اللوحات بداية محفّزها. ويبقى الشعار عند بداية السطر.

قبل التسليم

  • Header base للحاسوب والجوال في الاتجاهين.
  • حالة لوحة مفتوحة واحدة معروضة.
  • الرابط النشط معلَّم في الصفحة الحالية.

إمكانية الوصول

لوحة المفاتيح

المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.

المفتاحما يفعله
Tabبين عناصر الصف؛ من زر مفتوح إلى روابط لوحته ثم إلى العنصر التالي.
EnterSpaceعلى زر: يفتح لوحته أو يغلقها.
ArrowRightArrowLeftبين عناصر الصف؛ بالعربية السهم الأيسر إلى التالي.
Escيغلق اللوحة ويعيد التركيز إلى زرها.

ARIA

  • ‏<nav> فيه قائمة (ul) من العناصر؛ لكل زر aria-expanded وaria-controls.
  • روابط اللوحة روابط حقيقية، والبطاقة المميزة رابط واحد.
  • الأزرار ارتفاعها 32px ومنطقة لمسها 48px عموديًا فقط.
  • على الجوال: زر قائمة يفتح درجًا فيه المجموعات نفسها في أكورديون.

ملاحظات العربية والاتجاه

ينعكس

  • أول عنصر على اليمين، واللوحة تبدأ من الحافة اليمنى للصف.
  • روابط اللوحة تُقرأ من اليمين، والبطاقة المميزة على اليسار.
  • في التذييل الرابط على اليمين وسهمه يشير إلى اليسار، وسطر المساعدة على اليسار.

لا ينعكس

  • سهم الزر يشير إلى الأسفل ويدور عند الفتح، ولا ينعكس.
  • أيقونات الروابط لا تنعكس.
الأرقام
الأرقام في الأوصاف تتبع إعداد الأرقام (toNumerals للنصوص الثابتة).
الخط العربي
الأزرار label-16 Medium (وSemibold حين تكون لوحتها مفتوحة)، وعناوين الروابط label-14 Semibold، والأوصاف label-12، وعنوان البطاقة label-16 Semibold.
النص ثنائي الاتجاه
أسماء المنتجات اللاتينية (Apple Pay وiOS) داخل الوصف العربي تبقى بترتيبها. اللوحة تحمل اتجاه الصفحة ولغتها إلى خارجها.

افعل

  • اضبط Nav position على Start أو Center كما في الإنجليزية؛ ينعكس وحده.
  • جرّب التسميات العربية الطويلة بعرض الجهاز اللوحي.

تجنّب

  • توسيط الروابط تهرّبًا من الاتجاه من اليمين إلى اليسار.
  • عكس الأسهم التي تشير إلى الأسفل.

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

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

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