شرح Drawer في Flutter مع Scaffold وListTile، وفتح القائمة بسياق صحيح وإغلاقها عند الاختيار وإظهار الوجهة المحددة ومراجعة اتجاه العربية.
القائمة الجانبية وسياق استخدامها
Drawer يتيح عرض وجهات أو إجراءات في لوحة جانبية مرتبطة بـ Scaffold. قبل كتابة الكود حدد إن كانت الوجهات أساسية أم فرعية وهل يحتاج المستخدم الوصول المتكرر إليها، ثم اختر الهيكل الذي يخدمه. القائمة ليست مكانًا لإخفاء كل زر لا تعرف أين تضعه؛ كثرة العناصر غير المنظمة تجعل الوصول أصعب. المثال يستخدم وجهتين فقط لشرح حالة الاختيار والإغلاق، ويمكنك بعد فهم التدفق بناء قائمة مناسبة لبيانات مشروعك.
فتح القائمة من المكان الصحيح
Scaffold يستطيع عرض زر قائمة في AppBar عندما يتوفر drawer. إذا أردت زرًا آخر داخل المحتوى فاستعمل context واقعًا تحت Scaffold، مثل Builder، ثم Scaffold.of(context).openDrawer. السياق الذي يبني Scaffold نفسه قد يكون أعلى منه ولا يعثر عليه. GlobalKey
الإغلاق لا يعني اختيار صفحة
Navigator.pop داخل القائمة يغلقها عادة في هذا السياق، لكنه لا يغير محتوى الجسم تلقائيًا. احفظ الفهرس أو نفذ التنقل المناسب ثم أغلق القائمة. المثال يغير محتوى shell محليًا ويغلق Drawer، لذلك لا يضيف وجهة جديدة إلى سجل الرجوع. إذا أردت صفحات فعلية فحدد هل تدفع مسارًا أو تستبدله، ولا تنسخ pop مرتين كي لا تغلق القائمة ثم الصفحة بلا قصد. تعامل مع اختيار الوجهة الحالية دون تكرار طلب أو route غير ضروري.
ListTile بدل مناطق ضغط متعارضة
ListTile يوفر onTap وselected وleading وtitle، ولذلك لا تحتاج عادة تغليفه بـ GestureDetector آخر يقوم بالفعل نفسه. المستمعان المتداخلان قد يجعلان منطق الضغط مربكًا ويزيدان صعوبة الصيانة. استخدم تسميات واضحة وأيقونات مفهومة وحدود تركيز ظاهرة، ولا تعتمد لون الأيقونة فقط لتوضيح الاختيار. إذا كانت هناك إجراءات مثل تسجيل الخروج فافصلها عن تبديل الوجهات وطبق منطقها الحقيقي؛ لا تجعل طباعة clicked تنفيذًا مزعومًا للعملية.
مساحة القائمة والاتجاه
ضع العناصر داخل ListView حتى تظل قابلة للوصول مع شاشة قصيرة أو نص كبير، وراعِ SafeArea حول مناطق النظام. drawer يتبع جهة البداية بحسب Directionality، بينما endDrawer يناسب الجهة المقابلة؛ لا تفرض اليمين أو اليسار دون مراجعة لغة الواجهة. الصورة في الرأس اختيارية وتحتاج asset معلنًا إذا استعملتها، لذلك يعتمد المثال على نص وأيقونة محلية. في Material 3 يمكن تقييم NavigationDrawer، لكنه صنف بعقد مختلف وليس اسمًا بديلًا تلصقه دون اختبار.
فحص تجربة التنقل
افتح القائمة من AppBar ومن زر المحتوى، واختر الوجهة الثانية ثم افتحها مجددًا لتتحقق من ظهور selected. جرّب النقر خارجها والسحب ورجوع النظام، وتأكد أن إغلاق القائمة لا يغلق صفحة التطبيق. اختبر العربية والنص الطويل وتكبير الخط والعرض الأفقي. إذا كانت الوجهات ترتبط بصلاحيات فلا يكفي إخفاء عنصر من القائمة لحماية البيانات؛ طبقة الخدمة يجب أن تتحقق من الإذن. المثال محلي يوضح العرض والتنقل فقط، ولا يقدم آلية حسابات أو صلاحيات أو مزامنة عنوان الويب.
مثال مستقل للتجربة
شغّل المثال داخل مشروع Flutter تجريبي. يعتمد على Material فقط ولا يحتاج assets أو أصنافًا من مشروع خاص. غيّر مساحة النافذة وجرّب تكبير النص أثناء الفحص، ثم انقل المكوّن إلى مشروعك بعد تحديد سياق قيوده الفعلي.
import 'package:flutter/material.dart';
void main() => runApp(const MaterialApp(home: DemoPage()));
class DemoPage extends StatefulWidget {
const DemoPage({super.key});
@override
State<DemoPage> createState() => _DemoPageState();
}
class _DemoPageState extends State<DemoPage> {
int _index = 0;
static const _titles = ['Lessons', 'Saved'];
@override
Widget build(BuildContext context) => Scaffold(
appBar: AppBar(title: Text(_titles[_index])),
drawer: Drawer(child: SafeArea(child: ListView(padding: EdgeInsets.zero, children: [
const Padding(padding: EdgeInsets.all(24), child: Text('Geecoders lessons')),
for (var i = 0; i < _titles.length; i++)
ListTile(
leading: Icon(i == 0 ? Icons.menu_book : Icons.bookmark),
title: Text(_titles[i]),
selected: _index == i,
onTap: () {
setState(() { _index = i; });
Navigator.of(context).pop();
},
),
]))),
body: Builder(builder: (scaffoldContext) => ListView(
padding: const EdgeInsets.all(16),
children: [
Text('${_titles[_index]} content'),
ElevatedButton(onPressed: () => Scaffold.of(scaffoldContext).openDrawer(), child: const Text('Open menu')),
],
)),
);
}مرجع الواجهة البرمجية
راجع التوثيق الرسمي لمطابقة السلوك مع إصدار Flutter المستخدم. نجاح المثال في مساحة واحدة لا يثبت توافق التصميم مع جميع الشاشات؛ اختبر حدود الانتقال والاتجاه واللغة والنص الطويل.
الصور والفيديو من الشرح السابق
الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.






