عنصر درج التنقل هو قائمة انزلاق تتيح للمستخدمين التنقّل إلى أقسام مختلفة من تطبيقك. ويمكن للمستخدمين تفعيله من خلال التمرير سريعًا من الجانب أو النقر على رمز قائمة.
راجِع حالات الاستخدام الثلاث التالية لتنفيذ درج التنقّل:
- تنظيم المحتوى: يمكنك السماح للمستخدمين بالتبديل بين فئات مختلفة، مثل التطبيقات الإخبارية أو تطبيقات التدوين.
- إدارة الحساب: يجب توفير روابط سريعة إلى إعدادات الحساب وأقسام الملف الشخصي في التطبيقات التي تتضمّن حسابات مستخدمين.
- اكتشاف الميزات: يمكنك تنظيم الميزات والإعدادات المتعددة في ملف شخصي واحد للتسهيل اكتشاف المستخدمين للميزات والوصول إليها في التطبيقات المعقدة.
في أسلوب Material Design، هناك نوعان من أدراج التنقّل:
- عادي: مشاركة مساحة داخل الشاشة مع محتوى آخر
- وضع النافذة المنبثقة: يظهر فوق المحتوى الآخر ضمن الشاشة.
توافق الإصدار
يتطلّب هذا التنفيذ ضبط الحد الأدنى من إصدار حزمة تطوير البرامج (SDK) لمشروعك على المستوى 21 من واجهة برمجة التطبيقات أو مستوى أعلى.
التبعيات
استخدام لائحة تنقّل
يمكنك استخدام العنصر القابل للتجميع ModalNavigationDrawer لتنفيذ
لائحة تنقّل:
النقاط الرئيسية
استخدِم خانة
drawerContentلتقديمModalDrawerSheetو تقديم محتوى الدرج.تقبل
ModalNavigationDrawerعددًا من مَعلمات الأدراج الإضافية. على سبيل المثال، يمكنك تفعيل أو إيقاف استجابة الدرج للسحب باستخدام المَعلمةgesturesEnabledكما هو موضّح في المثال التالي:
التحكّم في سلوك لائحة التنقّل
للتحكّم في كيفية فتح الدرج وإغلاقه، استخدِم DrawerState:
النقاط الرئيسية
- نقْل
DrawerStateإلىModalNavigationDrawerباستخدام المَعلمةdrawerState. - يوفر
DrawerStateإمكانية الوصول إلى وظيفتَيopenوclose، بالإضافة إلى السمات ذات الصلة بحالة الدرج الحالية. تتطلّب دوال التعليق هذهCoroutineScope، ويمكنك إنشاء مثيل لها باستخدامrememberCoroutineScope. يمكنك أيضًا استدعاء دوال التعليق في استجابة لأحداث واجهة المستخدم.
النتائج
المجموعات التي تتضمّن هذا الدليل
هذا الدليل هو جزء من مجموعات الأدلة السريعة المنظَّمة التي تتناول أهداف تطوير Android الأوسع نطاقًا: