شرح MediaQuery في Flutter لقراءة حجم النافذة ومعلومات البيئة، والتمييز بين padding وviewInsets وقيود body دون طرح المساحات مرتين.
ما الذي تقيسه MediaQuery؟
تتيح قراءة معلومات عن بيئة العرض الأقرب في الشجرة، ومنها الحجم المنطقي والحواف ومقياس النص. الحجم المنطقي ليس عدد بكسلات الصورة الخام، لذلك لا تحول كل قياس إلى بكسل فعلي دون سبب. قد تكون view نافذة قابلة لإعادة التحجيم أو مساحة split screen، وليست كامل شاشة الجهاز كما تتخيلها من نوعه. داخل مكوّن صغير لا يكفي هذا القياس لمعرفة العرض الذي أعطاه الأب له؛ استخدم LayoutBuilder عند الحاجة إلى القيود المحلية.
اختر الاستعلام الأضيق
إذا احتجت الحجم فقط، فـ MediaQuery.sizeOf يوضح اعتماد المكوّن على هذه الخاصية. قراءة MediaQuery.of كاملة قد تجعل المكوّن يعتمد على تغييرات أوسع مما يحتاجه. لا تعني هذه الملاحظة أن of خطأ دائمًا أو أن استبداله وحده سيحل بطء التطبيق؛ اختر الواجهة التي تصف حاجتك ثم قِس الأداء عند وجود مشكلة. لا تخزن القياس في متغير static باعتباره ثابتًا، لأن حجم النافذة والبيئة قد يتغيران أثناء حياة التطبيق.
الحواف ليست شيئًا واحدًا
padding وviewPadding وviewInsets تصف جوانب مختلفة من المساحات المحجوبة أو الآمنة. لوحة المفاتيح قد تزيد viewInsets.bottom، بينما SafeArea يساعد على تجنب مناطق واجهة النظام وفق إعداداته. لا تضف padding بنفس القيمة في عدة مستويات ثم تتساءل عن فراغ كبير، ولا تلغِ كل الحواف لأن مثالًا واحدًا يبدو متلاصقًا. افهم كيف تعدّل المكوّنات الوسيطة MediaQuery الموروثة قبل الاعتماد على القيمة في سياقها.
الارتفاع المتاح للمحتوى
Scaffold قد يعيد تحجيم body عند ظهور لوحة المفاتيح وفق resizeToAvoidBottomInset، وقد تخصم AppBar وأجزاء أخرى من مساحة التخطيط. حساب screenHeight – appbar – statusBar كقاعدة عامة قد يكون خاطئًا، خصوصًا مع extendBody أو SafeArea أو تخطيط متداخل. إذا احتجت ملء body فقس قيوده أو استخدم Expanded في سياق محدود بدل إعادة بناء حساب النظام يدويًا. وقد يكون التمرير هو الحل الصحيح لنموذج أطول من المساحة المتاحة.
النص والوصول
لا تربط fontSize بنسبة من ارتفاع الشاشة لتجعل التطبيق متجاوبًا؛ النافذة القصيرة لا تعني أن المستخدم يحتاج نصًا أصغر. ابدأ من TextTheme واحترم إعدادات تكبير النص، واختبر الأزرار والحقول عند زيادة المقياس. TextScaler يعبر عن التحجيم في الواجهات الحديثة، ولا يجب تعطيله على مستوى التطبيق لمجرد إخفاء overflow. عالج بنية المحتوى والتمرير وتوزيع المساحة أولًا، وميّز بين نص يمكن اختصاره وآخر أساسي لا يجوز إخفاؤه.
فحص المثال
المثال يعرض قياس view الأقرب ومقدار الحجب السفلي، ويضع حقل إدخال داخل تمرير حتى يبقى قابلًا للوصول عند ظهور لوحة المفاتيح. جرّبه في نافذة ضيقة وواسعة وفي الاتجاهين، ثم اقرأ القيود المحلية في درس LayoutBuilder للمقارنة. لا تستخدم الأرقام المعروضة كمعرف لنوع الجهاز أو كسجل تحليلي حساس دون حاجة؛ هي قيم عرض متغيرة. تحقق من RTL وحجم الخط والأجهزة ذات الحواف المختلفة قبل اعتماد خصومات أو هوامش ثابتة.
عند مقارنة النتائج دوّن موضع BuildContext الذي تقرأ منه القيمة، فالسياق الموجود أعلى SafeArea قد يرى معلومات مختلفة عن سياق طفل داخلها. هذه المراجعة تمنع تكرار التعويض عن الحواف وتوضح مصدر المسافة الزائدة.
مثال مستقل للتجربة
شغّل المثال داخل مشروع 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) {
final size = MediaQuery.sizeOf(context);
final keyboardInset = MediaQuery.viewInsetsOf(context).bottom;
return Scaffold(
appBar: AppBar(title: const Text('MediaQuery information')),
body: SafeArea(child: SingleChildScrollView(
padding: const EdgeInsets.all(16),
child: Column(crossAxisAlignment: CrossAxisAlignment.start, children: [
Text('View: ${size.width.toStringAsFixed(0)} × ${size.height.toStringAsFixed(0)} logical pixels'),
const SizedBox(height: 12),
Text('Bottom view inset: ${keyboardInset.toStringAsFixed(0)}'),
const SizedBox(height: 24),
const TextField(decoration: InputDecoration(labelText: 'Show the keyboard')),
const SizedBox(height: 24),
Text('Use theme typography and allow content to wrap.', style: Theme.of(context).textTheme.bodyLarge),
]),
)),
);
}
}مرجع الواجهة البرمجية
راجع التوثيق الرسمي لمطابقة السلوك مع إصدار Flutter المستخدم. نجاح المثال في مساحة واحدة لا يثبت توافق التصميم مع جميع الشاشات؛ اختبر حدود الانتقال والاتجاه واللغة والنص الطويل.
الصور والفيديو من الشرح السابق
الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.






