شارك المقالة
OrientationBuilder في Flutter: اتجاه المساحة المحلية

OrientationBuilder في Flutter: اتجاه المساحة المحلية

شرح OrientationBuilder في Flutter لتكييف مكوّن حسب نسبة قيوده المحلية، مع توضيح الفرق بين اتجاه المساحة واتجاه نافذة التطبيق.

شرح OrientationBuilder في Flutter لتكييف مكوّن حسب نسبة قيوده المحلية، مع توضيح الفرق بين اتجاه المساحة واتجاه نافذة التطبيق.

النسبة تخص المكان الذي تبني فيه

OrientationBuilder يقرر الاتجاه اعتمادًا على عرض المساحة وارتفاعها في سياق القيود، لا على حساس دوران الهاتف وحده. لذلك يمكن أن يكون المكوّن أفقيًا داخل بطاقة عريضة رغم أن النافذة العامة رأسية. هذه خاصية مفيدة عندما يحتاج المحتوى ترتيبًا يناسب المساحة المحلية، لكنها قد تكون مربكة إذا سمّيت القيمة اتجاه الجهاز. لا تستخدمها لاكتشاف Android أو iOS، ولا تفترض أن landscape يعني سطح مكتب أو توفر فأرة.

متى يكون الاختيار مناسبًا؟

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

الحدود القصوى والمحتوى الكبير

حتى بعد معرفة الاتجاه يجب أن يحترم الطفل القيود التي أعطاها الأب. لا تجمع ارتفاعات ثابتة تتجاوز مساحة البطاقة، ولا تجعل نسبة childAspectRatio كبيرة دون فحص النص. إذا كان المحتوى قد يطول فقدم تمريرًا أو تخطيطًا يسمح بالالتفاف. المثال يضع مكوّنًا داخل مساحة محددة ويبدل ترتيب رمزين وعنوان، ويُبقي النص داخل مساحة يمكنها التعامل مع الزيادة بدل افتراض حجم خط صغير لا يتغير.

تغير الاتجاه ليس حدث أعمال

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

الفرق عن MediaQuery وLayoutBuilder

MediaQuery يتيح معلومات البيئة الأقرب مثل حجم view، وLayoutBuilder يكشف قيود الأب مباشرة، وOrientationBuilder يختصر قرار نسبة المساحة إلى Orientation. لا يوجد بديل واحد أفضل في جميع الحالات؛ السؤال الذي تريد الإجابة عنه هو الفاصل. إذا احتجت width عند حد 700 فاستعمل قيود العرض، وإذا احتجت عرض معلومات view فاقرأها من MediaQuery. تجنب تعشيش الأدوات الثلاث دون حاجة لأن ذلك يصعب معرفة المصدر الذي اتخذ القرار.

كيف تختبر الفكرة؟

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

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

شغّل المثال داخل مشروع 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 orientation')),
    body: Center(child: Padding(
      padding: const EdgeInsets.all(16),
      child: ConstrainedBox(
        constraints: const BoxConstraints(maxWidth: 700, maxHeight: 360),
        child: SizedBox.expand(child: Card(child: OrientationBuilder(
          builder: (context, orientation) {
            final illustration = const Center(child: Icon(Icons.photo, size: 72));
            final details = Padding(padding: const EdgeInsets.all(16), child: SingleChildScrollView(
              child: Text('Local orientation: ${orientation.name}. This follows the space around this component.'),
            ));
            return orientation == Orientation.landscape
              ? Row(children: [Expanded(child: illustration), Expanded(child: details)])
              : Column(children: [Expanded(child: illustration), Expanded(child: details)]);
          },
        ))),
      ),
    )),
  );
}

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

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

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

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

التعامل مع OrientationBuilder في فلاتر
شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

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