الدرج السفلي
لوحة تنزلق من أسفل شاشة الجوال لمهمة قصيرة أو قائمة إجراءات، في متناول الإبهام، والصفحة ظاهرة خلفها. تُعرف أيضًا باللوحة السفلية (Bottom sheet).
فحص ريتلا لهذه المعاينة: الفحوص الناجحة: 41 من 41مقاسات العرض: 3تاريخ الفحص:
المعاينة
«معكوس» هو المحتوى الإنجليزي نفسه من اليمين إلى اليسار، ليفصل خطأ الاتجاه عن خطأ الترجمة.
التثبيت
أضف المكوّن
npx ritla add drawerويعمل أيضًا مع shadcn:
npx shadcn@latest add @ritla/drawerالاعتماديات التي يضيفها
@base-ui/react@phosphor-icons/reactأو انسخه يدويًا
التثبيت اليدوي ينسخ مصدر المكوّن إلى مشروعك. المصدر يأتي مع ترخيص Ritla UI، وأداة سطر الأوامر هي الطريق الأقصر إلى الملفات نفسها.
الاستخدام
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).
قائمة طويلة
تتوقف اللوحة عند 90% من الشاشة ويُمرَّر المحتوى، ويبقى العنوان في مكانه. والعنوان الفرعي بجانب العنوان.
أزرار متراصة
stacking="vertical" للعناوين الطويلة، والأساسي في الأعلى. الأزرار تبقى بترتيب القراءة: الثانوي ثم الأساسي.
مرجع الخصائص
Drawer
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
open / defaultOpen / onOpenChange | boolean | لا يوجد | للتحكم في الفتح. |
disablePointerDismissal | boolean | false | لا تُغلق بلمس الخلفية (للوحات التي تحمل مدخلات). |
DrawerContent
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
handle | boolean | true | مقبض السحب، للإشارة فقط. |
initialFocus | RefObject<HTMLElement> | لا يوجد | أين يبدأ التركيز. |
DrawerHeader
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
title | ReactNode | لا يوجد | خاصية Title: الغرض من اللوحة، وهو اسمها. |
subtitle | ReactNode | لا يوجد | خاصية Subtitle بجانب العنوان. |
description | ReactNode | لا يوجد | خاصية Description: سطر قصير للسياق. |
badge | ReactNode | لا يوجد | خاصية Show badge: عدد أو نص قصير. |
closeButton / closeLabel | boolean / string | true / "Close" | زر الإغلاق واسمه. أبقه دائمًا. |
DrawerMenuItem
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
children | ReactNode | لا يوجد | نص الصف. |
leadingIcon / description / trailing | IconComponent / ReactNode / ReactNode | لا يوجد | أيقونة وسطر ثانٍ وعدد في النهاية. |
onSelect / disabled | () => void / boolean | لا يوجد | يعمل عند اللمس ثم تُغلق اللوحة. |
DrawerActions / DrawerBody / DrawerMenuLabel / DrawerClose
| الخاصية | النوع | الافتراضي | الوصف |
|---|---|---|---|
stacking | "horizontal" | "vertical" | "horizontal" | خاصية Stacking للأزرار. |
DrawerBody | div | لا يوجد | المحتوى، ويُمرَّر عند الحاجة. |
DrawerMenuLabel | h3 | لا يوجد | عنوان مجموعة صفوف. |
DrawerClose render | ReactElement | لا يوجد | زر يغلق اللوحة. |
إمكانية الوصول
لوحة المفاتيح
المفاتيح مكتوبة للاتجاه من اليسار إلى اليمين. في الاتجاه من اليمين يتبادل السهمان دورهما: السهم المتجه مع اتجاه القراءة ينقلك إلى الأمام.
| المفتاح | ما يفعله |
|---|---|
| TabShift+Tab | بين عناصر اللوحة فقط. |
| Esc | يغلقها ويعيد التركيز إلى الزر الذي فتحها. |
ARIA
- اللوحة
dialogمعaria-modal، والعنوان اسمها. - السحب للأسفل ليس الطريق الوحيد للإغلاق: زر الإغلاق («إغلاق») وEsc ولمس الخلفية.
- مقبض السحب زخرفي، والصفوف والأزرار 48 بكسل على الأقل.
ملاحظات العربية والاتجاه
ينعكس
- العنوان وأيقونات القائمة على اليمين، وزر الإغلاق على اليسار.
- الزر الأساسي على اليسار في نهاية السطر، والثانوي على اليمين.
لا ينعكس
- الحركة عمودية: تنزلق للأعلى وتُسحب للأسفل في اللغتين.
- الأرقام
- الأعداد في الصفوف تتبع إعداد الأرقام؛ نسّقها بـ
formatNumber. - الخط العربي
- العنوان
label-14Medium، والفرعي والوصفlabel-12، والصفوف كصفوف القائمة. - النص ثنائي الاتجاه
- أسماء بلغة أخرى داخل الصفوف تأخذ
dir="auto".
الفحوص التي يجتازها
فحوص ريتلا التي يجتازها هذا المكوّن بطريقة بنائه. إن استُخدم كما هو موثّق، لا يحمل هذه الأخطاء إلى صفحتك.