AlertDialog

نافذة تنبيه منبثقة AlertDialog

AlertDialog نافذة منبثقة تحجب باقي الشاشة، تُستخدم لتأكيد فعل حسّاس (حذف، خروج بلا حفظ) أو عرض رسالة مهمة.

تُعرَض عبر showDialog، وتُغلَق عادة باستدعاء Navigator.pop(context) من أحد أزرارها.

الصياغة

showDialog(
  context: context,
  builder: (context) => AlertDialog(
    title: Text('العنوان'),
    content: Text('النص'),
    actions: [Widget, ...],
  ),
);

📄 مثال

showDialog(
  context: context,
  builder: (context) => AlertDialog(
    title: Text('حذف المهمة؟'),
    content: Text('لا يمكن التراجع عن هذا الإجراء.'),
    actions: [
      TextButton(onPressed: () => Navigator.pop(context), child: Text('إلغاء')),
      TextButton(onPressed: () => Navigator.pop(context, true), child: Text('حذف')),
    ],
  ),
);

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

المعامل	الوظيفة
title / content	عنوان النافذة ونصّها
actions	أزرار أسفل النافذة، غالبًا TextButton

💡 نصائح عملية

استخدم await showDialog(...) لانتظار قرار المستخدم (مثل true/false من زر التأكيد) قبل المتابعة

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

نسيان Navigator.pop(context) بأحد الأزرار — النافذة تبقى مفتوحة بلا طريقة لإغلاقها

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