استخدام FittedBox في Flutter مع BoxFit.scaleDown وقيود واضحة، وفهم الفرق بين تحجيم الرسم وحجم الخط وتجنب تصغير النصوص الطويلة وإضعاف قابلية القراءة.
تحجيم الطفل لا اختيار خط سحري
FittedBox يقيس طفله ثم يحجمه ويضعه داخل المساحة المتاحة وفق fit. عندما يكون الطفل Text بحجم 64 لا يعني ذلك أن fontSize نفسه تغير إلى قيمة محسوبة داخل Theme. النتيجة المرئية قد تبدو أصغر بسبب التحويل، وهذا يختلف عن إعادة تنسيق فقرة بأسطر جديدة. لا تصفه بأنه يضمن أكبر حجم خط صالح لكل تصميم أو يمنع كل overflow في التطبيق؛ بقية التخطيط والقيود ومحتوى الطفل ما زالت تؤثر في النتيجة.
scaleDown وcontain
BoxFit.scaleDown يصغر المحتوى عندما يلزم ولا يكبره فقط لملء المساحة، بينما contain قد يغير المقياس في الاتجاهين ليحتوي الطفل مع الحفاظ على نسبه. اختيار fit ينبغي أن يتبع المحتوى: رقم لوحة نتيجة أو شعار قصير قد يناسبه التحجيم، وفقرة تعليمية تحتاج قراءة أسطرها لا ضغطها إلى سطر صغير. المثال يضع عنوانًا قصيرًا داخل صندوق محدود ويعرض أسفله فقرة عادية قابلة للالتفاف للمقارنة بين مسؤولية التحجيم ومسؤولية النص.
الأب يحدد المساحة
إذا أردت احتواء نص داخل بطاقة فحدد عرض البطاقة وقيودها أولًا. داخل Row قد تحتاج Expanded أو Flexible لتوفر مساحة محدودة، وداخل تمرير أفقي قد يكون العرض مفتوحًا فلا تحصل على التصغير المتوقع. لا تجمع width: double.infinity مع أب غير محدود ثم تتوقع أن FittedBox يعرف عرض الجهاز. المثال يقيد المحتوى بعرض أقصى ويستخدم عرضًا متاحًا من ListView، لذلك يمكن تجربة نافذة ضيقة وأخرى واسعة دون الاستناد إلى رقم جهاز معين.
النص الكبير وإمكانية الوصول
تصغير النص تلقائيًا يمكن أن يعاكس الغرض من تكبير النص في إعدادات المستخدم إذا ظل الصندوق ثابتًا، فيبدو التصميم خاليًا من أخطاء الرسم بينما تصبح القراءة صعبة. أعطِ النص المهم مساحة للنمو أو الالتفاف أو غير التخطيط عندما يحتاج ذلك. لا تستخدم FittedBox كحل عام لكل عنوان أو زر أو رسالة خطأ. إذا كان المحتوى طويلًا فقرر هل تحتاج عدة أسطر أو ملخصًا أو صفحة تفاصيل، وراجع التصميم مع حجم خط كبير وقارئ الشاشة والتركيز.
المحاذاة والقص
alignment يحدد موضع المحتوى بعد التحجيم ويمكن استخدام AlignmentDirectional ليوافق بداية القراءة. fit لا يغني عن فهم clipBehavior في الأب أو عن حجز مساحة للعناصر الأخرى. قد يكون الطفل نفسه ذا قيود أو مكونات لا تصلح في سياق مفتوح، لذلك جرّب أصغر مثال بدل إحاطة شجرة معقدة كاملة بـ FittedBox. لا تضف Center داخليًا بلا غرض ثم تربط السلوك به؛ وضوح حدود الصندوق والطفل يجعل إصلاح المشكلات أسهل من تكديس أغلفة متشابهة.
فحص المثال وحدوده
قارن العنوان القصير في عرض 320 ونافذة أكبر، ثم استبدله مؤقتًا بعنوان طويل لتلاحظ لماذا لا يصلح التحجيم وحده لمقال. تحقق أن مقياس النص الصغير لا يُكبر تحت scaleDown وأن اللون والتباين واضحان. الاختبار الآلي يمكنه فحص حدود الرسم وعدم وجود استثناء، لكنه لا يقيس راحة القراءة البشرية وحده. المثال لا يجلب صورًا أو مكتبات إضافية، ويمكن إعادة استخدام الصندوق القصير بعد تحديد الحد الأدنى المقبول لقراءته في منتجك، مع إبقاء النصوص الأساسية خارج هذا القيد عندما تتطلب الوصول الكامل.
مثال مستقل للتجربة
شغّل المثال داخل مشروع 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('FittedBox demo')),
body: Center(child: ConstrainedBox(constraints: const BoxConstraints(maxWidth: 640),
child: ListView(padding: const EdgeInsets.all(16), children: const [
SizedBox(height: 96, child: ColoredBox(color: Color(0xFFE0F2F1), child: Padding(
padding: EdgeInsets.all(12), child: FittedBox(
key: ValueKey('fitted-title'), fit: BoxFit.scaleDown,
alignment: AlignmentDirectional.centerStart,
child: Text('Geecoders', style: TextStyle(fontSize: 64, color: Colors.black)),
),
))),
SizedBox(height: 24),
Text('A paragraph should usually wrap instead of being shrunk into one tiny line. Test long content and larger text sizes.',
style: TextStyle(fontSize: 20)),
SizedBox(height: 16),
Text('Use a bounded parent and choose the fit behavior deliberately.'),
]),
)),
);
}مرجع الواجهة البرمجية
راجع التوثيق الرسمي لمطابقة السلوك مع إصدار Flutter المستخدم. نجاح المثال في مساحة واحدة لا يثبت توافق التصميم مع جميع الشاشات؛ اختبر حدود الانتقال والاتجاه واللغة والنص الطويل.
الصور والفيديو من الشرح السابق
الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.







