شارك المقالة
NavigationBar مع Cubit في Flutter وتثبيت حالة التبويبات

NavigationBar مع Cubit في Flutter وتثبيت حالة التبويبات

أنشئ NavigationBar مع Cubit في Flutter، واضبط الفهرس المختار واستخدم IndexedStack للاحتفاظ بعناصر الصفحات دون خلط التنقل بتخزين البيانات.

أنشئ NavigationBar مع Cubit في Flutter، واضبط الفهرس المختار واستخدم IndexedStack للاحتفاظ بعناصر الصفحات دون خلط التنقل بتخزين البيانات.

تبويبات الصفحة أم مكدس المسارات؟

NavigationBar مع Cubit في Flutter يحدد أي صفحة تظهر ضمن حاوية واحدة، وليس بالضرورة انتقالًا إلى Route جديد لكل ضغطة. حالة التنقل هنا عدد صحيح يمثل الفهرس المختار. حافظ على الفرق بين تغيير التبويب وفتح تفاصيل مستقلة ثم الرجوع منها، لأن لكل منهما أثرًا مختلفًا على عمر الصفحة وحفظ مدخلات المستخدم ومكدس الرجوع.

Cubit صغير لمسؤولية واضحة

يحفظ NavCubit فهرسًا بين صفر واثنين، وتتحقق select من النطاق قبل emit. هذه البساطة تجعل تطابق عدد الوجهات والصفحات سهلًا للاختبار. لا تحمل الحالة أسماء الشاشات وعناصر Widget وسجلات قاعدة البيانات دون سبب واحد واضح. إذا تطورت الوجهات إلى قائمة ديناميكية، استخدم معرفات أو نموذجًا مناسبًا بدل الاعتماد على أرقام مبعثرة في ملفات كثيرة.

بناء الواجهة من الفهرس نفسه

تقرأ NavigationShell الحالة عبر BlocBuilder وتستخدم index نفسه في selectedIndex وIndexedStack. إذا اختلف مصدرا القيمتين، فقد يضيء تبويب بينما تعرض الشاشة صفحة أخرى. مرر onDestinationSelected إلى دالة Cubit المسؤولة عن التحقق. لا تنشئ NavCubit جديدًا داخل كل بناء للشريط، لأن ذلك قد يعيد المستخدم إلى التبويب الأول مع كل تحديث غير متعلق بالتنقل.

متى يفيد IndexedStack؟

يبقي IndexedStack عناصر الصفحات ضمن الشجرة ويعرض واحدة منها، فيفيد للاحتفاظ بحالة نموذج أو موضع تمرير وفق بنية الأطفال ومفاتيحهم. هذا يستهلك موارد الصفحات غير الظاهرة أيضًا، فلا تفترض أنه الخيار الأفضل لكل شاشة ثقيلة. الصفحات التي تحمل بثًا أو فيديو أو طلبات دورية تحتاج سياسة إيقاف عند إخفائها؛ عدم الظهور لا يساوي dispose تلقائيًا.

الاحتفاظ بحالة الواجهة ليس تخزينًا دائمًا

بقاء طفل داخل IndexedStack قد يحافظ على قيمه أثناء تبديل التبويبات، لكنه لا يحفظها بعد إنهاء عملية التطبيق. كما أن اختيار تبويب لا يغير حالة مهمة من active إلى done. افصل اختيار الصفحة عن بيانات المهام، وراجع إضافة المهام وتخزينها وتغيير حالة المهمة عندما تحتاج ربط التبويبات ببيانات فعلية بدل النصوص التجريبية في المثال.

حاوية مشتركة لبيانات التطبيق

إذا كانت الصفحات الثلاث تعرض تصنيفات من بيانات واحدة، ضع TodoCubit أو المستودع في نطاق مشترك أعلى منها. لا تنشئ قاعدة بيانات مستقلة في كل تبويب، ولا تنسخ قائمة ثم تعدلها من صفحة واحدة وتتوقع أن تتحدث الأخرى تلقائيًا. يمكن جمع أنواع الحالة المختلفة عبر MultiBlocProvider مع الحفاظ على فصل مسؤولية التنقل عن مسؤولية القراءة والكتابة.

الواجهة والأيقونات والوصول

اختر تسميات مفهومة وتأكد من توفر مساحة للأيقونة والنص على الهاتف. لا تعتمد على اللون وحده لبيان التبويب الحالي، واختبر النصوص بعد تغيير اللغة. إذا أردت فتح شاشة تفاصيل أو تسجيل دخول، استخدم آلية Routes مناسبة بدل إضافة تبويب مؤقت يكسر الفهارس. تجنب الاعتماد على أسماء أنواع قديمة في ThemeData عند تحديث مثال من إصدار Flutter سابق.

اختبارات التنقل وحدود المثال

اختبر الانتقال لكل وجهة والضغط المتكرر على الوجهة نفسها وفهرسًا غير صالح. إذا أضفت نماذج فعلية فاختبر بقاء المدخلات عند التبديل، ثم خروج الحاوية وإعادة إنشائها لتعرف متى تعاد الحالة الابتدائية. المثال يعرض بنية التنقل فقط ولا ينفذ تخزينًا أو نموذج مهمة كاملًا. ابدأ من مبادئ Cubit إذا كان سبب إعادة البناء أو نطاق المزود غير واضح.

الإعداد أو عقد التكامل المطلوب

طبّق الجزء المناسب على مشروعك بعد مراجعة إصدار الحزمة والمنصة؛ قيم الإعداد هنا توضيحية وليست مفاتيح صالحة أو خدمة خلفية منشورة.

flutter pub add flutter_bloc

المثال التطبيقي المراجع

احفظ المثال في ملف مستقل داخل مشروع تجريبي مع الحزم المذكورة. يوضح الكود نطاق الدرس؛ أضف إعدادات مشروعك واختبر المنصة المستهدفة قبل الاعتماد عليه في تطبيق قائم.

import 'package:flutter/material.dart';
import 'package:flutter_bloc/flutter_bloc.dart';

class NavCubit extends Cubit<int> {
  NavCubit():super(0);
  void select(int index){
    if(index<0 || index>2)throw RangeError.range(index,0,2);
    emit(index);
  }
}
class NavigationDemo extends StatelessWidget {
  const NavigationDemo({super.key});
  @override
  Widget build(BuildContext context)=>BlocProvider(create:(_)=>NavCubit(),
    child:const MaterialApp(home:NavigationShell()));
}
class NavigationShell extends StatelessWidget {
  const NavigationShell({super.key});
  @override
  Widget build(BuildContext context)=>BlocBuilder<NavCubit,int>(builder:(context,index)=>Scaffold(
    body:IndexedStack(index:index,children:const [
      Center(child:Text('Active tasks')),Center(child:Text('Completed tasks')),
      Center(child:Text('Archived tasks'))]),
    bottomNavigationBar:NavigationBar(selectedIndex:index,
      onDestinationSelected:context.read<NavCubit>().select,destinations:const [
        NavigationDestination(icon:Icon(Icons.list),label:'Active'),
        NavigationDestination(icon:Icon(Icons.done),label:'Done'),
        NavigationDestination(icon:Icon(Icons.archive),label:'Archive'),
      ]),
  ));
}

مراجع التنفيذ الرسمية

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع