💙 مرجع ويدجتس Flutter بالعربي

Container

الحاوية الأساسية

Container ويدجت متعدّد الأغراض: يضبط الحجم واللون والحواف والحشو والزخرفة لأي عنصر يحتويه.

Row

ترتيب أفقي

Row يرتّب مجموعة ويدجتس بجانب بعضها أفقيًا، مع تحكّم كامل بالمحاذاة والمسافات.

Column

ترتيب عمودي

Column يرتّب مجموعة ويدجتس فوق بعضها عموديًا — نفس مبدأ Row لكن بالاتجاه العمودي.

Stack

التراكب (وضع فوق بعض)

Stack يضع ويدجتس فوق بعضها البعض (تراكب طبقات) بدل ترتيبها بخط — مثالي للشارات فوق الصور أو التصاميم المتراكبة.

Padding

المسافة الداخلية

Padding يضيف مسافة فارغة حول ويدجت واحد — بديل مخصّص عن استخدام Container فقط من أجل الحشو.

Center

التوسيط

Center يوسّط ويدجتًا واحدًا داخل المساحة المتاحة له، أفقيًا وعموديًا معًا.

SizedBox

مساحة أو حجم ثابت

SizedBox يفرض حجمًا محددًا (عرض/ارتفاع) على ابنه، أو يُستخدم بلا ابن كمسافة فارغة بسيطة بين عناصر.

Expanded

توزيع المساحة المتبقية

Expanded يجعل ابنًا داخل Row أو Column يأخذ كل المساحة المتبقية المتاحة — الحل القياسي لمشكلة overflow.

Text

عرض النصوص

Text يعرض سطرًا أو فقرة نصية، مع تحكّم كامل بالخط والحجم واللون والمحاذاة عبر TextStyle.

ElevatedButton

زر بارز

ElevatedButton زر بخلفية معبّأة وظل بسيط — الخيار القياسي للأفعال الرئيسية بالشاشة.

TextButton

زر نصي بسيط

TextButton زر بلا خلفية أو ظل — للأفعال الثانوية (مثل "إلغاء" بجانب زر رئيسي).

IconButton

زر أيقونة

IconButton زر دائري يعرض أيقونة فقط بلا نص — شائع بأشرطة الأدوات (AppBar) وقوائم العناصر.

Icon

عرض أيقونة

Icon يعرض رمزًا بصريًا من مكتبة Material Icons المدمجة أو أيقونات مخصّصة.

TextField

حقل إدخال نصي

TextField يتيح للمستخدم كتابة نص — الأداة الأساسية لأي نموذج (تسجيل دخول، بحث، تعليق).

Checkbox

مربّع اختيار

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

Switch

مفتاح تبديل

Switch مفتاح تشغيل/إيقاف بصري (مثل مفاتيح الإعدادات) — نفس مبدأ Checkbox لكن بشكل مختلف.

ListView

قائمة قابلة للتمرير

ListView يعرض عناصر مرتّبة عموديًا (أو أفقيًا) مع تمرير تلقائي — الأداة الأساسية لأي قائمة طويلة.

GridView

شبكة عناصر

GridView يعرض عناصر بشبكة أعمدة وصفوف — مثالي لمعارض الصور أو قوائم المنتجات.

Card

بطاقة مرتفعة

Card صندوق بزوايا دائرية وظل خفيف افتراضيًا — تصميم Material القياسي لتجميع محتوى متعلّق ببعضه.

ListTile

سطر قائمة جاهز

ListTile تصميم سطر جاهز بأيقونة بادئة (leading) وعنوان وعنوان فرعي وأيقونة لاحقة (trailing) — النمط القياسي لعناصر القوائم.

Scaffold

هيكل الشاشة الأساسي

Scaffold يوفّر هيكل صفحة Material قياسي جاهز: شريط علوي، جسم، شريط سفلي، وزر عائم — كل شاشة تقريبًا تبدأ بـ Scaffold.

AppBar

الشريط العلوي

AppBar الشريط العلوي القياسي — يحتوي عنوان الشاشة، زر رجوع تلقائي، وأيقونات إجراءات (actions).

Image

عرض الصور

Image يعرض صورة من الشبكة أو الأصول المحلية أو الذاكرة، بثلاثة مُنشِئات مختلفة حسب المصدر.

CircularProgressIndicator

مؤشّر تحميل دائري

CircularProgressIndicator يعرض دائرة تحميل متحرّكة — الإشارة القياسية لعملية جارية (تحميل بيانات، رفع ملف).

SnackBar

رسالة سريعة أسفل الشاشة

SnackBar رسالة قصيرة تظهر أسفل الشاشة وتختفي تلقائيًا — لتأكيد فعل (تم الحفظ، تم الحذف) بلا مقاطعة المستخدم.

AlertDialog

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

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