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

الدرج السفلي

احصل على Ritla UI

لوحة تنزلق من أسفل شاشة الجوال لمهمة قصيرة أو قائمة إجراءات، في متناول الإبهام، والصفحة ظاهرة خلفها. تُعرف أيضًا باللوحة السفلية (Bottom sheet).

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

افتح في Figma

المعاينة

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

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

التثبيت

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

    npx ritla add drawer

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

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

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

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

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

الاستخدام

drawer.tsx
import { Drawer, DrawerBody, DrawerContent, DrawerHeader, DrawerMenu, DrawerMenuItem, DrawerTrigger } from "@/components/ui/drawer";<Drawer>  <DrawerTrigger render={<Button />}>Move email</DrawerTrigger>  <DrawerContent>    <DrawerHeader title="Move to" />    <DrawerBody>      <DrawerMenu>        <DrawerMenuItem leadingIcon={TrayIcon} onSelect={moveToInbox}>Inbox</DrawerMenuItem>      </DrawerMenu>    </DrawerBody>  </DrawerContent></Drawer>

أمثلة

مهمة قصيرة

المحتوى مهمة واحدة (تصفية) تنتهي بزر ثانوي ثم أساسي، والأساسي في نهاية السطر. ولأنها تحمل اختيارات، لا تُغلق بلمس الخلفية (disablePointerDismissal).

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

قائمة طويلة

تتوقف اللوحة عند 90% من الشاشة ويُمرَّر المحتوى، ويبقى العنوان في مكانه. والعنوان الفرعي بجانب العنوان.

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

أزرار متراصة

‏stacking="vertical" للعناوين الطويلة، والأساسي في الأعلى. الأزرار تبقى بترتيب القراءة: الثانوي ثم الأساسي.

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

مرجع الخصائص

Drawer

الخاصيةالنوعالافتراضيالوصف
open / defaultOpen / onOpenChangebooleanلا يوجدللتحكم في الفتح.
disablePointerDismissalbooleanfalseلا تُغلق بلمس الخلفية (للوحات التي تحمل مدخلات).

DrawerContent

الخاصيةالنوعالافتراضيالوصف
handlebooleantrueمقبض السحب، للإشارة فقط.
initialFocusRefObject<HTMLElement>لا يوجدأين يبدأ التركيز.

DrawerHeader

الخاصيةالنوعالافتراضيالوصف
titleReactNodeلا يوجدخاصية Title: الغرض من اللوحة، وهو اسمها.
subtitleReactNodeلا يوجدخاصية Subtitle بجانب العنوان.
descriptionReactNodeلا يوجدخاصية Description: سطر قصير للسياق.
badgeReactNodeلا يوجدخاصية Show badge: عدد أو نص قصير.
closeButton / closeLabelboolean / stringtrue / "Close"زر الإغلاق واسمه. أبقه دائمًا.

DrawerMenuItem

الخاصيةالنوعالافتراضيالوصف
childrenReactNodeلا يوجدنص الصف.
leadingIcon / description / trailingIconComponent / ReactNode / ReactNodeلا يوجدأيقونة وسطر ثانٍ وعدد في النهاية.
onSelect / disabled() => void / booleanلا يوجديعمل عند اللمس ثم تُغلق اللوحة.

DrawerActions / DrawerBody / DrawerMenuLabel / DrawerClose

الخاصيةالنوعالافتراضيالوصف
stacking"horizontal" | "vertical""horizontal"خاصية Stacking للأزرار.
DrawerBodydivلا يوجدالمحتوى، ويُمرَّر عند الحاجة.
DrawerMenuLabelh3لا يوجدعنوان مجموعة صفوف.
DrawerClose renderReactElementلا يوجدزر يغلق اللوحة.

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

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

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

المفتاحما يفعله
TabShift+Tabبين عناصر اللوحة فقط.
Escيغلقها ويعيد التركيز إلى الزر الذي فتحها.

ARIA

  • اللوحة dialog مع aria-modal، والعنوان اسمها.
  • السحب للأسفل ليس الطريق الوحيد للإغلاق: زر الإغلاق («إغلاق») وEsc ولمس الخلفية.
  • مقبض السحب زخرفي، والصفوف والأزرار 48 بكسل على الأقل.

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

ينعكس

  • العنوان وأيقونات القائمة على اليمين، وزر الإغلاق على اليسار.
  • الزر الأساسي على اليسار في نهاية السطر، والثانوي على اليمين.

لا ينعكس

  • الحركة عمودية: تنزلق للأعلى وتُسحب للأسفل في اللغتين.
الأرقام
الأعداد في الصفوف تتبع إعداد الأرقام؛ نسّقها بـ formatNumber.
الخط العربي
العنوان label-14 Medium، والفرعي والوصف label-12، والصفوف كصفوف القائمة.
النص ثنائي الاتجاه
أسماء بلغة أخرى داخل الصفوف تأخذ dir="auto".

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

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

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