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

شريط القوائم

احصل على Ritla UI

صف القوائم أعلى أداة مكتبية أو تطبيق ويب، مثل «ملف» و«تحرير». كل زر يفتح قائمة من صفوف القائمة.

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add menubar

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

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

    @base-ui/react

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

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

الاستخدام

menubar.tsx
import { MenuItem, MenuSeparator } from "@/components/ui/menu";import { Menubar, MenubarContent, MenubarMenu, MenubarTrigger } from "@/components/ui/menubar";<Menubar>  <MenubarMenu>    <MenubarTrigger>File</MenubarTrigger>    <MenubarContent>      <MenuItem shortcut="⌘N" aria-keyshortcuts="Meta+N">New transfer</MenuItem>      <MenuSeparator />      <MenuItem shortcut="⌘P" aria-keyshortcuts="Meta+P">Print</MenuItem>    </MenubarContent>  </MenubarMenu></Menubar>

أمثلة

صفوف القائمة

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

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

مرجع الخصائص

Menubar

الخاصيةالنوعالافتراضيالوصف
loopFocusbooleantrueالأسهم تعود من آخر قائمة إلى أولها.
modalbooleantrueالصفحة خلف القائمة المفتوحة لا تستجيب للمؤشر.
disabledbooleanfalseيعطّل الشريط كله.

MenubarTrigger

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

MenubarContent

الخاصيةالنوعالافتراضيالوصف
childrenReactNodeلا يوجدصفوف القائمة: MenuItem وMenuSeparator وMenuGroup والقوائم الفرعية.
align"start" | "center" | "end""start"تبدأ من بداية الزر (يمينه بالعربية).
sideOffset / alignOffsetnumber9 / -5‏4px تحت الشريط، وأول قائمة على حافته.

MenuItem

الخاصيةالنوعالافتراضيالوصف
shortcutReactNodeلا يوجدالاختصار كما يُطبع (⌘N)، للعرض فقط.
aria-keyshortcutsstringلا يوجدالاختصار لقارئ الشاشة (Meta+N). التطبيق يتولى المفاتيح.

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

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

1. متى تستخدمه

شريط القوائم مكانه أدوات الحاسوب كثيرة الأوامر. والتطبيقات الأبسط تستخدم الأزرار وقائمة واحدة.

افعل

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

تجنّب

  • إضافته إلى موقع تسويقي.
  • الجمع بينه وبين قائمة التنقل في الترويسة نفسها.

2. القوائم والعناصر

كل محفّز يفتح قائمة: عناصر وفواصل وقوائم فرعية واختصارات. والعناصر الهدّامة في الأخير بلون الخطر.

افعل

  • جمّع العناصر بالفواصل حسب المهمة.
  • عطّل العناصر غير المتاحة الآن، ولا تُخفها.

تجنّب

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

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

تسير المحفّزات من اليمين إلى اليسار، وتُفتح القوائم تحت محفّزها محاذيةً لحافة بدايته. وتبقى الاختصارات بحروف لاتينية.

قبل التسليم

  • الحالتان المغلقة والمفتوحة في الاتجاهين.
  • سلوك لوحة المفاتيح مدوّن للمطوّر.
  • البديل على الهاتف محسوم.

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

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

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

المفتاحما يفعله
ArrowRightArrowLeftبين القوائم، ومع قائمة مفتوحة تفتح التالية.
ArrowDownEnterSpaceيفتح القائمة وينقل التركيز إلى أول عنصر.
ArrowUpArrowDownبين عناصر القائمة المفتوحة.
Escيغلق القائمة ويعيد التركيز إلى زرها.

ARIA

  • الشريط role="menubar" وكل زر menuitem له aria-haspopup وaria-expanded.
  • زر واحد فقط في ترتيب Tab، والأسهم تتنقل بين الباقي.
  • رموز الاختصار مخفية عن قارئ الشاشة، وaria-keyshortcuts تقولها بكلمات.
  • الأزرار ارتفاعها 28px ومنطقة لمسها 48px عموديًا فقط، كي لا يأخذ زر نقرات جاره.

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

ينعكس

  • أول قائمة على اليمين، والقوائم تبدأ من الحافة اليمنى لزرها.
  • السهم الأيسر ينتقل إلى القائمة التالية بالعربية.
  • الاختصارات في نهاية الصف: على اليسار. والقوائم الفرعية تنفتح إلى اليسار.

لا ينعكس

  • الاختصارات تُقرأ من اليسار إلى اليمين (⇧⌘E).
  • الأيقونات غير الاتجاهية (الملفات والقفل) لا تنعكس.
الأرقام
الأرقام في العناصر تتبع إعداد الأرقام؛ مفاتيح الاختصار تبقى كما على لوحة المفاتيح.
الخط العربي
الأزرار label-14 Medium، والعناصر كصفوف القائمة، والاختصار label-12 Medium.
النص ثنائي الاتجاه
الاختصار <kbd dir="ltr"> فلا يتبدّل ترتيب ⇧⌘E داخل صف عربي. الشاشات الصغيرة: انقل الأوامر إلى قائمة «المزيد» أو درج.

افعل

  • النسخة العربية، والقوائم الفرعية تُفتح نحو نهاية السطر.
  • اكتب الاختصار كما هو في اللغتين: Ctrl+S.

تجنّب

  • عكس رموز الاختصارات.
  • ترجمة أسماء القوائم التي هي أسماء منتجات.

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

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

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