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

FloatingActionButton

الزر العائم FloatingActionButton

FloatingActionButton زر دائري عائم فوق المحتوى، عادة بأسفل الشاشة، يبرز الفعل الرئيسي بالشاشة (إضافة عنصر جديد غالبًا).

يُمرَّر عادة عبر معامل floatingActionButton بـ Scaffold مباشرة، الذي يتولّى تموضعه تلقائيًا. استخدامه المتعارف عليه بتصميم Material لفعل واحد رئيسي فقط بكل شاشة.

الصياغة

FloatingActionButton(
  onPressed: () { },
  child: Icon(IconData),
)

📄 مثال

Scaffold(
  body: Center(child: Text('المحتوى')),
  floatingActionButton: FloatingActionButton(
    onPressed: () => print('إضافة عنصر'),
    tooltip: 'إضافة',
    child: Icon(Icons.add),
  ),
)

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

المعاملالوظيفة
onPressedالدالة المُنفَّذة عند الضغط
childعادة Icon واحد يعبّر عن الفعل (Icons.add شائع جدًا)
floatingActionButtonLocationمعامل بـ Scaffold يغيّر موضع الزر الافتراضي

💡 نصائح عملية

  • استخدم FloatingActionButton.extended إذا أردت نصًا بجانب الأيقونة بدل أيقونة فقط

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

  • وضع أكثر من فعل رئيسي بزر عائم واحد — الأفضل فعل واضح ووحيد بكل شاشة

خصائص ذات صلة

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