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

زر القائمة

احصل على Ritla UI

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

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add menu

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

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

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

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

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

الاستخدام

menu.tsx
import { DotsThreeVerticalIcon, PencilSimpleIcon } from "@phosphor-icons/react/ssr";import { IconButton } from "@/components/ui/icon-button";import { Menu, MenuContent, MenuItem, MenuTrigger } from "@/components/ui/menu";<Menu>  <MenuTrigger render={<IconButton variant="outline" icon={DotsThreeVerticalIcon} label="Invoice actions" />} />  <MenuContent>    <MenuItem leadingIcon={PencilSimpleIcon} onClick={edit}>Edit</MenuItem>    <MenuItem onClick={duplicate}>Duplicate</MenuItem>  </MenuContent></Menu>

أمثلة

زر منقسم

نوع Button في Figma: نصف القائمة في الزر المنقسم يفتح القائمة نفسها، وتصطف القائمة مع الزر كله.

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

قائمة الصورة الشخصية

نوع Avatar menu في Figma: صورة الحساب تفتح قائمة الحساب. الزر دائري ويُسمّى بما يفتحه («قائمة الحساب»)، والصورة داخله زخرفية فلا يُقرأ الاسم مرتين.

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

الأقسام والفواصل

MenuGroup مع MenuLabel يسمّي كل قسم، وMenuSeparator بين الأقسام. description يضيف سطرًا ثانيًا، وMenuLinkItem للتنقل، والعنصر المعطّل يبقى ظاهرًا مع سببه.

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

قائمة فرعية

نوع Multi level: «نقل إلى» يفتح قائمة فرعية عند نهاية السطر. في العربية تفتح إلى اليسار، والسهم الأيسر يفتحها والأيمن يغلقها.

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

اختيارات

حالة Selected: MenuRadioGroup وMenuRadioItem لاختيار واحد، وMenuCheckboxItem لعدة اختيارات. الصف المختار بلون brand/faint مع علامة صح في نهاية السطر (اليسار في العربية) لا تنعكس، والقائمة تبقى مفتوحة. subtitle ملاحظة قصيرة بجانب العنوان، وbadge عدد في النهاية.

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

إجراء خطِر

حالة Danger: ‏danger يلوّن العنوان والوصف والأيقونة بالأحمر. ضعه أخيرًا في مجموعته، واجعل العنوان يقول ما يفعله. trailingIcon أيقونة في النهاية، هنا لما يفتح موقعًا آخر.

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

مرجع الخصائص

Menu

الجذر: يحمل الحالة (open، onOpenChange، disabled، modal).

الخاصيةالنوعالافتراضيالوصف
open / defaultOpenbooleanلا يوجدفتح القائمة (متحكَّم به أو لا).
onOpenChange(open: boolean) => voidلا يوجديُستدعى عند الفتح والإغلاق.
disabledbooleanfalseيعطّل الزر والقائمة.

MenuTrigger

الخاصيةالنوعالافتراضيالوصف
renderReactElementلا يوجدالزر الظاهر: <IconButton … /> أو <Button … />. يأخذ aria-haspopup وaria-expanded.

MenuContent

الخاصيةالنوعالافتراضيالوصف
align"start" | "center" | "end""start"المحاذاة مع الزر؛ في Figma عند بداية السطر.
sideOffsetnumber12المسافة تحت الزر بالبكسل.
anchor"trigger" | "parent""trigger"ما تصطف معه القائمة؛ parent للزر المنقسم كله.

MenuItem, MenuLinkItem, MenuSubmenuTrigger

الخاصيةالنوعالافتراضيالوصف
childrenReactNodeلا يوجدالعنوان (Title).
leadingIconIconComponentلا يوجدShow leading: أيقونة 24 بكسل في بداية السطر.
descriptionReactNodeلا يوجدShow description: سطر ثانٍ تحت العنوان.
subtitleReactNodeلا يوجدShow subtitle: ملاحظة قصيرة بجانب العنوان.
badgeReactNodeلا يوجدShow badge: عدد أو كلمة في نهاية السطر، لا يخفت مع التعطيل. نسّق الأرقام بـ formatNumber.
trailingIconIconComponentلا يوجدShow trailing: أيقونة في نهاية السطر (MenuItem وMenuLinkItem).
dangerbooleanfalseState = Danger في MenuItem: إجراء يحذف أو يزيل.
onClick(event) => voidلا يوجدMenuItem: يُستدعى عند الاختيار ثم تُغلق القائمة.
hrefstringلا يوجدMenuLinkItem: وجهة الرابط.
disabledbooleanfalseState = Disabled؛ يبقى ظاهرًا ويتلقى التركيز ولا يُنفَّذ. اكتب السبب في description.

MenuRadioGroup, MenuRadioItem, MenuCheckboxItem

الخاصيةالنوعالافتراضيالوصف
value / defaultValue / onValueChangestringلا يوجدMenuRadioGroup: الاختيار الحالي.
valuestringلا يوجدMenuRadioItem: قيمة هذا الاختيار.
checked / defaultChecked / onCheckedChangebooleanلا يوجدMenuCheckboxItem: مفعّل أم لا.
leadingIcon / subtitle / description / badge…لا يوجدكما في MenuItem.

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

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

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

المفتاحما يفعله
EnterSpaceArrowDownعلى الزر: يفتح القائمة ويركّز العنصر الأول.
ArrowDownArrowUpينتقل بين العناصر ويلتف عند الطرفين. العنصر المعطّل يتلقى التركيز ليُقرأ سببه، لكنه لا يُنفَّذ.
ArrowRightArrowLeftيفتح القائمة الفرعية ويغلقها. في العربية ينعكس: السهم الأيسر يفتح.
Enterينفّذ العنصر المركّز ويغلق القائمة.
SpaceEnterعلى اختيار: يختاره أو يبدّله، وتبقى القائمة مفتوحة.
Escapeيغلق القائمة ويعيد التركيز إلى الزر.

ARIA

  • الزر يحمل aria-haspopup="menu" وaria-expanded، والقائمة role="menu" وعناصرها menuitem.
  • زر الأيقونة يحتاج label يصف ما تحويه القائمة («إجراءات الفاتورة»)، لا «المزيد».
  • MenuLabel يسمّي مجموعته، فتعلن قارئات الشاشة اسم القسم.
  • الاختيارات menuitemradio وmenuitemcheckbox مع aria-checked، فلا يعتمد الاختيار على اللون والعلامة وحدهما. العلامة مخفية عن قارئ الشاشة.

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

ينعكس

  • القائمة تفتح عند بداية الزر (اليمين في العربية)، والقوائم الفرعية نحو نهاية السطر (اليسار).
  • سهم القائمة الفرعية CaretRight ينعكس، والأسهم على لوحة المفاتيح تتبع اتجاه القراءة.
  • القائمة تأخذ اتجاه الزر ولغته، حتى داخل جزيرة عربية في صفحة إنجليزية.

لا ينعكس

  • DotsThreeVertical والأيقونات غير الاتجاهية لا تنعكس.
  • علامة الصح في الصف المختار لا تنعكس، وإن كانت في نهاية السطر.
  • سهم الزر المنقسم يشير إلى الأسفل ويستدير إلى الأعلى ما دامت القائمة مفتوحة، ولا ينعكس.
الأرقام
الأعداد في الأسطر الثانية («8 أعضاء») تُنسّق بـformatNumber؛ المعرّفات («INV-1042») في <bdi dir="ltr"> ولا تتغير.
الخط العربي
العنوان label-14 بوزن Medium، والسطر الثاني label-12، وعنوان القسم body-14 Semibold. الصفوف 48 بكسل وتتسع للعربية.
النص ثنائي الاتجاه
اسم لاتيني في نهاية عنصر عربي («تنزيل PDF») يُعرض صحيحًا؛ في وسطه ضعه في <bdi>.

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

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

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