Checkbox

مربّع اختيار Checkbox

Checkbox عنصر تفعيل/إلغاء بسيط (صح/خطأ) — يحتاج قيمة value وحالة تُدار عادة عبر StatefulWidget أو BLoC/Cubit.

Checkbox ويدجت "بلا حالة داخلية" — لا يتذكّر كونه محدَّدًا أم لا بنفسه، يعتمد كليًا على value الممرَّرة وonChanged لتحديث تلك القيمة بمكان آخر (setState عادة).

الصياغة

Checkbox(
  value: bool,
  onChanged: (bool? newValue) { },
)

📄 مثال

bool isChecked = false;

Checkbox(
  value: isChecked,
  onChanged: (value) => setState(() => isChecked = value!),
)

أهم المعاملات

المعامل	الوظيفة
value	الحالة الحالية — محدَّد أم لا
onChanged	يُستدعى بالقيمة الجديدة عند الضغط

💡 نصائح عملية

استخدم CheckboxListTile إذا أردت نصًا بجانب المربّع بسطر واحد جاهز

⚠️ أخطاء شائعة

نسيان setState داخل onChanged — القيمة تتغيّر منطقيًا لكن الواجهة لا تعيد الرسم

خصائص ذات صلة

TextField حقل إدخال نصي

🎓 تريد فهم الصورة الكاملة خطوة بخطوة؟ ابدأ من مسار FLUTTER الكامل بالعربي.