إنشاء TabBar في Flutter باستخدام DefaultTabController وربطه بـ TabBarView، مع مطابقة عدد التبويبات وإدارة القيود وحالة الصفحات.
تبويبات ضمن سياق واحد
TabBar مناسب لتقسيم محتوى مترابط مثل أحدث الدروس والمحفوظات داخل صفحة واحدة. لا يحتاج كل تبويب route جديدًا ولا خدمة مستقلة، لكنه يحتاج تعريفًا واضحًا للعناوين والمحتوى. اختر بينه وبين الشريط السفلي وفق بنية التنقل التي يفهمها المستخدم، ولا تكرر مجموعتي تنقل متطابقتين بلا وظيفة. المثال يعرض قسمين محليين ويتيح النقر أو السحب بينهما، دون شبكة أو صورة خارجية قد تفشل وتخفي الفكرة الأساسية.
controller يربط الاختيار والمحتوى
DefaultTabController يوفر TabController للأبناء؛ يقرأه TabBar وTabBarView ما داما ضمن نطاقه نفسه. length وعدد tabs وعدد children يجب أن تتطابق. إذا كان هناك controller صريح فلا تخلطه بآخر ضمني ثم تنتظر أن يتحركا معًا. عند تغير عدد الأقسام ديناميكيًا تحتاج خطة لإعادة إنشاء controller أو تحديث بنية النطاق مع المحافظة على اختيار صالح. اختفاء قسم أثناء تحميل بيانات ليس مجرد تغيير عنوان، وقد يترك الفهرس خارج حدود القائمة.
متى تستخدم TabController صريحًا؟
إذا احتجت animateTo من إجراء آخر أو مراقبة الحركة بدقة، يمكن امتلاك TabController داخل State مع TickerProvider وإغلاقه في dispose. لا تنشئه داخل build؛ ذلك يكرر الموارد وقد يعيد الاختيار. في المثال لا نحتاج تلك الإدارة، لذلك يتولى DefaultTabController عمر controller. واجهة قصيرة أو Tabs ثابتة لا تبرر إضافة حزمة إدارة حالة كبيرة لمجرد استدعاء setState، بينما حالة البيانات المشتركة بين الأقسام تحتاج تحديد مالكها بعيدًا عن الأنيميشن.
قيود الارتفاع والتمرير
TabBarView يحتاج مساحة ارتفاع محدودة ليعرض صفحات قابلة للتمرير. وضعه مباشرة في Column مفتوحة داخل SingleChildScrollView قد يسبب خطأ unbounded، ولا يعالج ذلك تخمين ارتفاع الشاشة كله. هنا body يحصل على مساحة Scaffold، ولكل تبويب ListView خاص به. إذا كان لديك رأس يتمرر مع المحتوى فادرس NestedScrollView أو Slivers ضمن تصميم مقصود. لا تجعل كل قائمة shrinkWrap طويلة فقط لإخفاء رسالة الخطأ؛ راجع أثر ذلك على البناء والتمرير.
حالة كل تبويب
لا تعتمد على أن وجود TabBarView يضمن حفظ كل شكل من الحالة في كل بنية. في المثال PageStorageKey مختلف لكل قائمة يساعد في استعادة موضع التمرير ضمن التخزين المحلي للشجرة. هذا لا يحفظ مسودة نموذج أو جلسة بين تشغيلين تلقائيًا. قد تحتاج AutomaticKeepAliveClientMixin لحالة widget محددة أو نقل البيانات إلى مالك أعلى، لكن الاحتفاظ بصفحات ثقيلة له تكلفة. اجعل هوية كل تبويب مستقرة وتجنب إعادة ترتيب المفاتيح بصورة تجعل موضع قائمة ينتقل إلى أخرى.
النص والاتجاه والاختبار
التسميات الطويلة تحتاج مراجعة؛ isScrollable قد يناسب عددًا كبيرًا بدل ضغطها إلى أحرف غير مقروءة، لكنه ليس بديلًا عن تنظيم الأقسام. راجع تباين المؤشر والثيم الفاتح والداكن وتكبير الخط واتجاه العربية، ولا تجعل السحب الطريقة الوحيدة للوصول إلى المحتوى. جرّب النقر والسحب والعودة إلى قائمة بعد تمريرها، ثم حالة قائمة فارغة وعنوان طويل. إذا كان التطبيق يستخدم روابط عميقة فحدد كيف يرتبط التبويب بعنوان الصفحة بدل افتراض أن DefaultTabController يغيّر رابط المتصفح تلقائيًا.
مثال مستقل للتجربة
شغّل المثال داخل مشروع Flutter تجريبي. يعتمد على Material فقط ولا يحتاج assets أو أصنافًا من مشروع خاص. غيّر مساحة النافذة وجرّب تكبير النص أثناء الفحص، ثم انقل المكوّن إلى مشروعك بعد تحديد سياق قيوده الفعلي.
import 'package:flutter/material.dart';
void main() => runApp(const MaterialApp(home: DemoPage()));
class DemoPage extends StatelessWidget {
const DemoPage({super.key});
@override
Widget build(BuildContext context) => DefaultTabController(
length: 2,
child: Scaffold(
appBar: AppBar(
title: const Text('Lesson tabs'),
bottom: const TabBar(tabs: [Tab(text: 'Recent'), Tab(text: 'Saved')]),
),
body: const TabBarView(children: [
LessonList(label: 'Recent', storageId: 'recent-list'),
LessonList(label: 'Saved', storageId: 'saved-list'),
]),
),
);
}
class LessonList extends StatelessWidget {
const LessonList({super.key, required this.label, required this.storageId});
final String label;
final String storageId;
@override
Widget build(BuildContext context) => ListView.builder(
key: PageStorageKey<String>(storageId),
padding: const EdgeInsets.all(16),
itemCount: 30,
itemBuilder: (_, index) => ListTile(title: Text('$label lesson ${index + 1}')),
);
}مرجع الواجهة البرمجية
راجع التوثيق الرسمي لمطابقة السلوك مع إصدار Flutter المستخدم. نجاح المثال في مساحة واحدة لا يثبت توافق التصميم مع جميع الشاشات؛ اختبر حدود الانتقال والاتجاه واللغة والنص الطويل.
الصور والفيديو من الشرح السابق
الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.






