تعلّم DropdownButton مع Cubit في Flutter لقراءة الفهرس والنص المختار، ومعالجة null والقائمة الفارغة والأسماء المتكررة دون أخطاء value.
حدد نوع القيمة المختارة
DropdownButton مع Cubit في Flutter يحتاج اتفاقًا واضحًا بين value وDropdownMenuItem.value والحالة داخل Cubit. في المثال القيمة عدد يمثل الفهرس، بينما يظهر للمستخدم نص من قائمة الخيارات. لا ترسل النص ثم تتعامل معه كفهرس دون تحويل مدروس. وإذا كانت العناصر كيانات دائمة من قاعدة بيانات، فعادة يكون معرف العنصر أنسب من ترتيبه في قائمة قابلة للتغيير.
حالة غير مختارة بدل افتراض العنصر الأول
يمتد ChoiceCubit من Cubit<int?> وتبدأ الحالة null، لتدل على أن المستخدم لم يختر بعد. يعرض DropdownButton hint بدل فرض قيمة صفر قد لا توجد في قائمة فارغة. هذا يفرق بين اختيار حقيقي وبين قيمة ابتدائية وضعها المطور. عندما يكون الاختيار مطلوبًا قبل الحفظ، تحقق منه في منطق النموذج ولا تعتبر ظهور النص الافتراضي موافقة من المستخدم.
بناء العناصر باستخدام asMap
تسمح asMap().entries بالحصول على الفهرس والنص معًا. يعطي كل DropdownMenuItem<int> قيمة الفهرس بينما يعرض Text الاسم. يمكن تكرار الاسم في هذا التصميم لأن القيم العددية مختلفة، لكن تكرار قيمة العنصر نفسها قد يخالف توقع DropdownButton بأن تكون القيمة المختارة مطابقة لعنصر واحد. لا تستنتج الفهرس باستعمال indexOf على أسماء متكررة فتختار أول تطابق دائمًا.
التحقق من الفهرس قبل emit
تفحص select أن القيمة إما null أو فهرس صالح داخل حدود choices. لا تستخدم newValue! دون سبب في واجهة قد تعيد null، ولا تقرأ choices[index] قبل التحقق من النطاق. تعيد selectedLabel النص اعتمادًا على الحالة الموثوقة نفسها، فلا تحتاج إلى متغير اسم آخر قد يتأخر في التحديث ويختلف عن القيمة. القائمة غير قابلة للتعديل الخارجي بعد إنشاء Cubit.
تحديث الواجهة من الحالة
يقرأ BlocBuilder الفهرس الحالي ويعيد بناء DropdownButton، بينما يحصل onChanged على دالة select من النسخة الموجودة في السياق. وفر ChoiceCubit فوق ChoicePicker بواسطة BlocProvider، ولا تنشئ Cubit جديدًا داخل كل تغيير اختيار. إذا لم تكن معتادًا على هذا النطاق، ابدأ من مقدمة Cubit ثم عد إلى هذا المثال بعد فهم العلاقة بين المزود والمستهلك.
تغير الخيارات وحالة القوائم الفارغة
المثال يجعل choices ثابتة خلال عمر الكائن. إذا تغيرت الخيارات من الشبكة، صمم حالة تحتوي القائمة والاختيار معًا، ثم أعد التحقق من العنصر المختار عند التحديث. قد يصبح الفهرس صالحًا عدديًا لكنه يشير إلى اسم آخر بعد إعادة ترتيب القائمة. استخدم معرفًا ثابتًا في هذا النوع من البيانات، وأظهر حالة لا توجد خيارات بدل قائمة منسدلة بلا تفسير.
الربط بنماذج وتبويبات التطبيق
يمكن حفظ الاختيار المؤقت في Cubit النموذج الذي يشترك فيه المستخدم مع حقول أخرى. إذا انتقلت بين تبويبات، حدد هل يجب الاحتفاظ بالاختيار أم إعادة ضبطه، وراجع إدارة NavigationBar مع Cubit. وفي نموذج مهمة، لا تحفظ فهرس واجهة داخل قاعدة البيانات كأنه معرف تصنيف دائم؛ يوضح فصل النموذج عن مستودع المهام كيف تبقى طبقات التطبيق واضحة.
اختبارات تمنع أخطاء القيمة
اختبر القائمة الفارغة وقيمة null وأول عنصر وآخر عنصر وفهرسًا خارج الحدود. أضف اسمين متطابقين وتأكد أن اختيار الفهرس الثاني يعطي الخيار المقصود. اختبر أن الواجهة تعرض الحالة الجديدة بعد onChanged، وليس فقط أن الدالة كتبت رقمًا في السجل. لا تصف Bloc بأنه أقوى أو أصعب بإطلاق؛ هذا النمط إحدى الطرق لتنظيم الحالة ويُختار حسب احتياج التطبيق وخبرة الفريق.
الإعداد أو عقد التكامل المطلوب
طبّق الجزء المناسب على مشروعك بعد مراجعة إصدار الحزمة والمنصة؛ قيم الإعداد هنا توضيحية وليست مفاتيح صالحة أو خدمة خلفية منشورة.
flutter pub add flutter_blocالمثال التطبيقي المراجع
احفظ المثال في ملف مستقل داخل مشروع تجريبي مع الحزم المذكورة. يوضح الكود نطاق الدرس؛ أضف إعدادات مشروعك واختبر المنصة المستهدفة قبل الاعتماد عليه في تطبيق قائم.
import 'package:flutter/material.dart';
import 'package:flutter_bloc/flutter_bloc.dart';
class ChoiceCubit extends Cubit<int?> {
ChoiceCubit(Iterable<String> values):choices=List.unmodifiable(values),super(null);
final List<String> choices;
String? get selectedLabel=>state==null?null:choices[state!];
void select(int? index){
if(index!=null && (index<0 || index>=choices.length))throw RangeError.index(index,choices);
emit(index);
}
}
class ChoicePicker extends StatelessWidget {
const ChoicePicker({super.key});
@override
Widget build(BuildContext context)=>BlocBuilder<ChoiceCubit,int?>(builder:(context,index){
final cubit=context.read<ChoiceCubit>();
return DropdownButton<int>(value:index,hint:const Text('اختر عنصرًا'),
items:cubit.choices.asMap().entries.map((e)=>DropdownMenuItem<int>(
value:e.key,child:Text(e.value))).toList(),onChanged:cubit.select);
});
}






