شريط القوائم
صف القوائم أعلى أداة مكتبية أو تطبيق ويب، مثل «ملف» و«تحرير». كل زر يفتح قائمة من صفوف القائمة.
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add menubarويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/menubarالاعتماديات التي يضيفها
@base-ui/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
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>أمثلة
صفوف القائمة
كل صفوف القائمة متاحة: أيقونات وأوصاف وعناوين أقسام وعناصر معطلة. العنصر المعطل يبقى ويقول السبب، ليعرف الناس مكان الأمر.
مرجع الخصائص
Menubar
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
loopFocus | boolean | true | الأسهم تعود من آخر قائمة إلى أولها. |
modal | boolean | true | الصفحة خلف القائمة المفتوحة لا تستجيب للمؤشر. |
disabled | boolean | false | يعطّل الشريط كله. |
MenubarTrigger
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
children | ReactNode | لا يوجد | خاصية Label: اسم القائمة. |
MenubarContent
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
children | ReactNode | لا يوجد | صفوف القائمة: MenuItem وMenuSeparator وMenuGroup والقوائم الفرعية. |
align | "start" | "center" | "end" | "start" | تبدأ من بداية الزر (يمينه بالعربية). |
sideOffset / alignOffset | number | 9 / -5 | 4px تحت الشريط، وأول قائمة على حافته. |
MenuItem
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
shortcut | ReactNode | لا يوجد | الاختصار كما يُطبع (⌘N)، للعرض فقط. |
aria-keyshortcuts | string | لا يوجد | الاختصار لقارئ الشاشة (Meta+N). التطبيق يتولى المفاتيح. |
إرشادات الاستخدام
شريط القوائم يجمع أوامر أداة حاسوبية في قوائم مسمّاة أعلى الشاشة. هنا: متى تستخدمه، وكيف ترتّب قوائمه وعناصرها، وكيف يسير في العربية، وما تتحقق منه قبل التسليم.
1. متى تستخدمه
شريط القوائم مكانه أدوات الحاسوب كثيرة الأوامر. والتطبيقات الأبسط تستخدم الأزرار وقائمة واحدة.
افعل
- استخدمه حين تزيد الأوامر على عشرة في ثلاث مجموعات أو أكثر.
- أبقِ أسماء القوائم العليا كلمة واحدة.
تجنّب
- إضافته إلى موقع تسويقي.
- الجمع بينه وبين قائمة التنقل في الترويسة نفسها.
2. القوائم والعناصر
كل محفّز يفتح قائمة: عناصر وفواصل وقوائم فرعية واختصارات. والعناصر الهدّامة في الأخير بلون الخطر.
افعل
- جمّع العناصر بالفواصل حسب المهمة.
- عطّل العناصر غير المتاحة الآن، ولا تُخفها.
تجنّب
- التداخل لأكثر من مستوى واحد من القوائم الفرعية.
- وضع مربعات الاختيار والإجراءات في المجموعة نفسها.
3. العربية والاتجاه من اليمين إلى اليسار
تسير المحفّزات من اليمين إلى اليسار، وتُفتح القوائم تحت محفّزها محاذيةً لحافة بدايته. وتبقى الاختصارات بحروف لاتينية.
قبل التسليم
- الحالتان المغلقة والمفتوحة في الاتجاهين.
- سلوك لوحة المفاتيح مدوّن للمطوّر.
- البديل على الهاتف محسوم.
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| ArrowRightArrowLeft | بين القوائم، ومع قائمة مفتوحة تفتح التالية. |
| ArrowDownEnterSpace | يفتح القائمة وينقل التركيز إلى أول عنصر. |
| ArrowUpArrowDown | بين عناصر القائمة المفتوحة. |
| Esc | يغلق القائمة ويعيد التركيز إلى زرها. |
ARIA
- الشريط
role="menubar"وكل زرmenuitemلهaria-haspopupوaria-expanded. - زر واحد فقط في ترتيب Tab، والأسهم تتنقل بين الباقي.
- رموز الاختصار مخفية عن قارئ الشاشة، و
aria-keyshortcutsتقولها بكلمات. - الأزرار ارتفاعها 28px ومنطقة لمسها 48px عموديًا فقط، كي لا يأخذ زر نقرات جاره.
ملاحظات العربية والاتجاه
ينعكس
- أول قائمة على اليمين، والقوائم تبدأ من الحافة اليمنى لزرها.
- السهم الأيسر ينتقل إلى القائمة التالية بالعربية.
- الاختصارات في نهاية الصف: على اليسار. والقوائم الفرعية تنفتح إلى اليسار.
لا ينعكس
- الاختصارات تُقرأ من اليسار إلى اليمين (
⇧⌘E). - الأيقونات غير الاتجاهية (الملفات والقفل) لا تنعكس.
- الأرقام
- الأرقام في العناصر تتبع إعداد الأرقام؛ مفاتيح الاختصار تبقى كما على لوحة المفاتيح.
- الخط العربي
- الأزرار
label-14Medium، والعناصر كصفوف القائمة، والاختصارlabel-12Medium. - النص ثنائي الاتجاه
- الاختصار
<kbd dir="ltr">فلا يتبدّل ترتيب ⇧⌘E داخل صف عربي. الشاشات الصغيرة: انقل الأوامر إلى قائمة «المزيد» أو درج.
افعل
- النسخة العربية، والقوائم الفرعية تُفتح نحو نهاية السطر.
- اكتب الاختصار كما هو في اللغتين: Ctrl+S.
تجنّب
- عكس رموز الاختصارات.
- ترجمة أسماء القوائم التي هي أسماء منتجات.
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.