شارك المقالة
شرح LayoutBuilder وBoxConstraints في Flutter

شرح LayoutBuilder وBoxConstraints في Flutter

شرح LayoutBuilder في Flutter لقراءة قيود الأب وفهم العرض والارتفاع المحدودين، ومعالجة القيود غير المحدودة بدل اعتبارها أبعاد الشاشة دائمًا.

شرح LayoutBuilder في Flutter لقراءة قيود الأب وفهم العرض والارتفاع المحدودين، ومعالجة القيود غير المحدودة بدل اعتبارها أبعاد الشاشة دائمًا.

ابدأ بعقد القيود

الأب يرسل حدودًا للحجم، والطفل يختار حجمًا داخلها وفق قواعد التخطيط، ثم يضع الأب الطفل. LayoutBuilder يتيح بناء Widget اعتمادًا على BoxConstraints التي تصل إليه. هذه القيم ليست بالضرورة أبعاد الشاشة: قد يكون العنصر داخل بطاقة أو جزء من Row أو نافذة جانبية. إذا أردت نسبة من المساحة المحلية، فقياس الأب أكثر صلة من ضرب عرض النافذة كله في نسبة ثابتة ثم وضع العنصر داخل مساحة أصغر.

الحد الأدنى والأقصى

تحتوي القيود minWidth وmaxWidth وminHeight وmaxHeight، وقد يكون بعض الحدود متساويًا أو مفتوحًا. maxHeight لا يعني ارتفاعًا صالحًا للضرب دائمًا؛ قد تكون قيمته infinity في محور تمرير أو سياق غير محدود. افحص hasBoundedHeight أو hasBoundedWidth عند اعتماد التصميم على حد نهائي. لا تبنِ Container بارتفاع infinity لمجرد أن القراءة لم ترم خطأ، ولا تعتبر كل overflow مشكلة تحتاج تصغير الخطوط دون فهم القيود.

Expanded يحتاج سياقًا مناسبًا

داخل Column محدودة الارتفاع يمكن لـ Expanded توزيع المساحة المتبقية بين الأطفال دون حساب نصف الشاشة يدويًا. لكن Column داخل تمرير رأسي قد تتلقى ارتفاعًا مفتوحًا، وعندها لا توجد مساحة متبقية نهائية يمكن توزيعها بالطريقة نفسها. اختر مصدر تمرير واحدًا أو بنية Slivers أو ارتفاعًا مقصودًا حسب المتطلبات. إضافة shrinkWrap أو تعطيل التمرير دون فهم الشجرة قد تخفي رسالة واحدة وتخلق تكلفة بناء أو سلوك تمرير مختلفًا.

لا تحسب ما حسبه Scaffold بالفعل

قد يحصل body على مساحة تراعي AppBar وأجزاء تخطيط أخرى وفق إعدادات Scaffold. طرح ارتفاع AppBar وشريط النظام من قياس محلي قد يكرر الخصم. وفي المقابل يصف MediaQuery مساحة view ومعلومات بيئتها، وليس مستطيل كل مكوّن داخل الصفحة. حدّد أي قياس تقرأ ولماذا، ثم راقب القيود في موضع المشكلة. عند وجود لوحة مفاتيح أو SafeArea أو extendBody قد يختلف المسار الذي يعطيك الارتفاع الفعلي.

اجعل builder يصف الواجهة

لا ترسل طلبات شبكة أو تحفظ بيانات أو تغيّر الحالة داخل builder استجابة لكل قياس. تغير القيود وإعادة بناء الأب أسباب طبيعية لاستدعائه، وليست حدثًا يجب أن يعيد تشغيل العمل. احسب قرارات عرض صغيرة من القيود، ثم مرر البيانات الموجودة إلى مكوّنات مستقلة. نقل كل منطق الصفحة إلى LayoutBuilder لا يحسن الأداء تلقائيًا، كما أن استخدامه على مستوى المكوّن الذي يحتاج القياس أوضح من وضعه حول التطبيق كله.

قراءة المثال وتشخيص المشكلة

المثال يعرض القيود المحلية ثم يقسم المساحة الرأسية المحدودة باستخدام Expanded. عند ارتفاع صغير ينتقل إلى قائمة قابلة للتمرير بدل محاولة وضع جزأين ثابتين مع عنوان لا يجد مكانًا. جرّب نقل المكوّن إلى Card ضيقة ولاحظ أن العرض تغير رغم ثبات النافذة. افحص حالة text scaling والنص الطويل، وابدأ من أول عنصر يتلقى قيدًا غير مناسب في الشجرة. تغيير جميع الارتفاعات إلى نسب من الشاشة يزيد الارتباط ولا يعالج أصل العقد غالبًا.

مثال مستقل للتجربة

شغّل المثال داخل مشروع Flutter تجريبي. يعتمد على Material فقط ولا يحتاج assets أو أصنافًا من مشروع خاص. غيّر مساحة النافذة وجرّب تكبير النص أثناء الفحص، ثم انقل المكوّن إلى مشروعك بعد تحديد سياق قيوده الفعلي.

import 'package:flutter/material.dart';
void main() => runApp(const MaterialApp(home: DemoPage()));
class DemoPage extends StatelessWidget {
  const DemoPage({super.key});
  @override
  Widget build(BuildContext context) => Scaffold(
    appBar: AppBar(title: const Text('Local constraints')),
    body: SafeArea(child: LayoutBuilder(builder: (context, constraints) {
      final label = 'Width: ${constraints.maxWidth.toStringAsFixed(0)}, bounded height: ${constraints.hasBoundedHeight}';
      if (!constraints.hasBoundedHeight || constraints.maxHeight < 320) {
        return ListView(padding: const EdgeInsets.all(16), children: [
          Text(label),
          const SizedBox(height: 16),
          const SizedBox(height: 120, child: ColoredBox(color: Colors.indigo)),
          const SizedBox(height: 16),
          const SizedBox(height: 120, child: ColoredBox(color: Colors.teal)),
        ]);
      }
      return Column(children: [
        Padding(padding: const EdgeInsets.all(16), child: Text(label)),
        const Expanded(child: SizedBox.expand(child: ColoredBox(color: Colors.indigo))),
        const Expanded(child: SizedBox.expand(child: ColoredBox(color: Colors.teal))),
      ]);
    })),
  );
}

مرجع الواجهة البرمجية

راجع التوثيق الرسمي لمطابقة السلوك مع إصدار Flutter المستخدم. نجاح المثال في مساحة واحدة لا يثبت توافق التصميم مع جميع الشاشات؛ اختبر حدود الانتقال والاتجاه واللغة والنص الطويل.

الصور والفيديو من الشرح السابق

الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.

ضبط اعدادات العرض باستخدام LayoutBuilder
شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع