تخطَّ إلى المحتوى

SafeArea

تفادي تداخل عناصر النظام SafeArea

SafeArea يضيف حشوًا تلقائيًا يمنع محتوى الشاشة من التداخل مع عناصر نظام التشغيل — شريط الحالة، النوتش، شريط التنقّل السفلي.

يفيد خصوصًا بالشاشات التي لا تستخدم Scaffold/AppBar (اللذان يتعاملان مع هذا تلقائيًا)، أو عند وضع محتوى يمتد لحافة الشاشة (خلفية كاملة، صورة).

الصياغة

SafeArea(
  top: bool,
  bottom: bool,
  child: Widget,
)

📄 مثال

SafeArea(
  child: Column(
    children: [
      Text('محتوى لا يتداخل مع شريط الحالة أو النوتش'),
    ],
  ),
)

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

المعاملالوظيفة
top / bottom / left / rightأي الجهات تُطبَّق عليها الحماية — الأربعة true افتراضيًا
minimumأدنى حشو يُطبَّق حتى لو كانت مساحة النظام أصغر منه

💡 نصائح عملية

  • لفّ الجسم كاملًا بـ SafeArea إذا كانت الشاشة تحتوي خلفية أو صورة تمتد لكامل الشاشة بلا Scaffold عادي

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

  • الاعتماد عليه ظنًا أنه يمنع overflow المحتوى العادي — SafeArea يتعامل فقط مع تداخل عناصر النظام، لا مع فيض المحتوى داخل الشاشة

خصائص ذات صلة

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