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

شريط التنقل

احصل على Ritla UI

وصول سريع إلى ثلاث إلى خمس وجهات رئيسية أسفل شاشة الهاتف (حتى ست على الجهاز اللوحي)، لكل وجهة أيقونة وتسمية قصيرة.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add navigation-bar

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

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

    @phosphor-icons/react

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

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

الاستخدام

navigation-bar.tsx
import { NavigationBar, NavigationBarItem } from "@/components/ui/navigation-bar";<NavigationBar className="fixed inset-x-space-0 bottom-space-0">  <NavigationBarItem href="/" icon={HouseIcon} selected>Home</NavigationBarItem>  <NavigationBarItem href="/alerts" icon={BellIcon} badge={3} badgeLabel="new alerts">Alerts</NavigationBarItem></NavigationBar>

أمثلة

الجهاز اللوحي

‏layout="tablet": حتى ست وجهات، والأيقونة بجانب التسمية، وشارة نقطة.

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

تلقائي وروابط الموجّه

الافتراضي layout="auto": شريط الهاتف تحت md وشريط الجهاز اللوحي من md. العناصر روابط <Link> عبر render، وshowLabels={false} يخفي التسميات في كل الشريط مع بقائها لقارئ الشاشة.

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

الشريط العائم

‏variant="floating" و"floating-inverse": شريط على شكل كبسولة، أيقونات بلا تسميات، والمحدّد وحده يُظهر تسميته. من ثلاث إلى خمس وجهات (الرسم في Figma بخمس). الصفحة تضعه بنفسها، مثلًا fixed inset-x-space-0 bottom-space-16 mx-auto.

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

مرجع الخصائص

NavigationBar

الخاصيةالنوعالافتراضيالوصف
layout"auto" | "phone" | "tablet""auto"شريط الهاتف أو الجهاز اللوحي، أو كلاهما حسب عرض الشاشة. للنمط العادي فقط.
variant"standard" | "floating" | "floating-inverse""standard"خاصية Style: الشريط بعرض الشاشة أو الكبسولة العائمة.
showLabelsbooleantrueخاصية Show label للشريط كله: كل التسميات أو لا شيء.
aria-labelstringلا يوجداسم عنصر التنقل. الافتراضي «الرئيسية» بلغة الصفحة.

NavigationBarItem

الخاصيةالنوعالافتراضيالوصف
childrenReactNodeلا يوجدخاصية Label: كلمة قصيرة واحدة.
iconIconComponentلا يوجد‏Outline icon؛ يُرسم بوزن Fill حين يكون محددًا.
selectedIconIconComponentلا يوجد‏Filled icon حين لا يكون الأيقونة نفسها بوزن Fill.
selectedbooleanfalseخاصية Selected: الصفحة الحالية.
href / renderstring / ReactElementلا يوجدالوجهة، أو رابط موجّه بمظهر العنصر.
badgenumber | trueلا يوجدخاصية Badge: عدد (Number) أو true لنقطة (Dot).
badgeLabelReactNodeلا يوجدمعنى الشارة لقارئ الشاشة («تنبيهات جديدة»).

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

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

1. متى يناسب

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

تحتاج إلىاستخدمالسبب
التنقل بين 3 إلى 5 أماكن رئيسية على الهاتفشريط التنقلظاهر دائمًا، في متناول الإبهام.
الشيء نفسه على جهاز لوحي، حتى 6 أماكنشريط التنقل، نسخة الجهاز اللوحيالأيقونة بجوار التسمية، في وسط الشريط.
التنقل في تطبيق على الحاسوبالتنقل الجانبي أو تنقل الترويسةمساحة أكبر، وعناصر أكثر، وأقسام متداخلة.
تبديل العروض داخل شاشة واحدةالتبويبات أو مجموعة أزرار التبديلتغيّر المحتوى هنا، لا المكان.
بدء إجراء: إنشاء، مسح، إرسالالزر العائم أو زرالإجراءات ليست أماكن يبقى فيها الناس.

2. العناصر والتسميات

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

كل عنصر مسمّى

التنقل الرئيسي في تطبيق مصرفي.

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

افعل

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

تجنّب

  • إخفاء التسميات على بعض العناصر وإظهارها على غيرها.
  • تسميات من سطرين أو طويلة.
  • تغيير العناصر حسب الشاشة.
  • استخدام الشريط لإجراءات مثل «إنشاء» أو «مشاركة».

3. الشارات

النقطة تقول إن هناك جديدًا، والرقم يقول كم. استخدمها فقط لما يحتاج إلى انتباه في تلك الوجهة، وامسحها حين يزورها الناس. وحدّد الأرقام كي تبقى قصيرة (99+).

افعل

  • استخدم النقطة لشيء جديد، والرقم لعدد مهم.
  • امسح الشارة حين يفتح الناس الوجهة.
  • أعطِ الشارات نصًا لقارئات الشاشة: «التحويلات، 3 معلّقة».

تجنّب

  • وضع شارة على كل عنصر في الوقت نفسه.
  • شارات تسويقية («جديد!») لا تُمسح أبدًا.
  • عرض أرقام طويلة مثل 1,284.

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

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

الشريط يبدأ من اليمين

التطبيق نفسه بالعربية.

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

5. السلوك بين الشاشات

يبقى الشريط في كل شاشة رئيسية، ويُخفى عادة في شاشات التفاصيل والمسارات التي تملأ الشاشة (الدفع، الكاميرا). وكل وجهة تتذكر أين كان الناس. والضغط على العنصر المختار مرة أخرى يعيد إلى أعلاه.

افعل

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

تجنّب

  • إعادة ضبط الوجهة كلما تنقّل الناس.
  • إخفاء الشريط مع التمرير في الشاشات الرئيسية.

قبل التسليم

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

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

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

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

المفتاحما يفعله
Tabبين الوجهات بترتيب القراءة.

ARIA

  • عنصر nav باسم «الرئيسية» بلغة الصفحة، وقائمة ul، والعنصر المحدد aria-current="page".
  • كل عنصر بارتفاع 64 بكسل، فوق مساحة اللمس 48.
  • الشارة تُقرأ بمعناها: «3 تنبيهات جديدة»، والنقطة بلا تسمية تُقرأ «جديد».

افعل

  • علّم الشريط تنقلًا، والعنصر المختار بـaria-current="page".
  • أهداف لمس بحجم 48 بكسل.
  • سمِّ العناصر بتسمياتها.

تجنّب

  • اللون وحده دليلًا على العنصر المختار؛ الأيقونة الممتلئة والحبة تحملانه أيضًا.
  • إعلان الشارات رقمًا بلا سياق.

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

ينعكس

  • أول وجهة على اليمين، وعلى الجهاز اللوحي تكون الأيقونة يمين التسمية.

لا ينعكس

  • الأيقونات إلا الاتجاهية منها (قائمة الانعكاس).
الأرقام
عدد الشارة يتبع إعداد الأرقام.
الخط العربي
‏label-12: عادي، وMedium للمحدد.
النص ثنائي الاتجاه
اجعل التسميات كلمة واحدة؛ الأطول تُقص في الهاتف.

افعل

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

تجنّب

  • الشريط الإنجليزي في شاشة عربية، و«الرئيسية» على اليسار.
  • عكس الترتيب يدويًا في النسخة الإنجليزية.
  • عكس الأيقونات غير الاتجاهية: المنزل، البطاقة.

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

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

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