شارك المقالة
Stack وPositioned في Flutter لتراكب العناصر دون قص أو مشاكل ضغط

Stack وPositioned في Flutter لتراكب العناصر دون قص أو مشاكل ضغط

استخدام Stack وPositioned في Flutter مع clipBehavior وقيود واضحة ومساحة للتراكب، مع مراجعة ترتيب الرسم واتجاه العناصر ومناطق الضغط.

استخدام Stack وPositioned في Flutter مع clipBehavior وقيود واضحة ومساحة للتراكب، مع مراجعة ترتيب الرسم واتجاه العناصر ومناطق الضغط.

التراكب داخل حدود معروفة

Stack يسمح برسم عناصر فوق بعضها، مثل بطاقة مع شارة أو صورة في زاوية. ترتيب children يؤثر في الرسم؛ ما يأتي لاحقًا يظهر فوق السابق عندما تتداخل المساحات. هذا يختلف عن Row وColumn التي ترتب العناصر تباعًا. المثال يعرض بطاقة نص مع شارة في الأعلى، ويخصص لها مساحة ضمن حجم Stack نفسه حتى تظل الشارة مرئية وقابلة للتفاعل، بدل دفع زر إلى خارج الحدود ثم الاعتماد على أنه ما زال يستقبل الضغط.

Positioned يحتاج سياق Stack

Positioned يمرر بيانات موضع إلى Stack؛ ضعه ضمن بنية تسمح بوصولها إلى RenderStack دون RenderObject وسيط غير مناسب. مثلًا وضع Padding بين Positioned وStack بالطريقة الخاطئة قد يسبب خطأ ParentDataWidget، بينما يمكن وضع Padding داخل child الخاص بـ Positioned. لا تستخدم top وleft وحدهما لوضع عنصر بالنسبة إلى شاشة التطبيق كلها إذا كان Stack داخل بطاقة صغيرة؛ المرجع هو صندوق Stack. فهم مرجع الإحداثيات أهم من تعديل قيم سالبة حتى تبدو لقطة واحدة صحيحة.

الحجم يأتي من التخطيط

الأطفال غير الموضوعة بـ Positioned تساهم في تحديد حجم Stack وفق قيوده، أما العناصر الموضوعة فلا تجعل حجمه يكبر تلقائيًا ليستوعب كل امتداد خارجها. إذا كان كل الأطفال positioned فوفّر حجمًا أو قيودًا مقصودة من الأب. في المثال جزء البطاقة غير positioned، ومعه padding علوي يحجز مكان الشارة. لا تخلط نقل الرسم بواسطة Transform مع حجز مساحة في التخطيط؛ قد يبدو العنصر في موضع جديد بينما تبقى المساحة المحجوزة ومناطق التداخل على منطق آخر.

استبدال overflow القديم

الخاصية القديمة overflow وOverflow.visible ليست الصيغة التي ينبغي نسخها إلى مثال حديث. استخدم clipBehavior بحسب الحاجة، مثل Clip.none للسماح بالرسم خارج حدود Stack حين يكون ذلك مقصودًا، لكن هذا لا يوسع مناطق hit testing للأب تلقائيًا. إذا كان العنصر زرًا مهمًا فاحجز له مساحة داخل حدود مناسبة بدل افتراض أن ظهوره يكفي. في المثال نحافظ على العناصر التفاعلية داخل صندوق Stack؛ عدم القص لا يبرر وضع رابط قابل للنقر فوق منطقة لا يملكها التخطيط.

الاتجاه والمسؤولية

PositionedDirectional مع start وend يتبع بداية اللغة ونهايتها، بينما right وleft يبقيان ثابتين. اختر بحسب معنى العنصر؛ شارة بداية بطاقة قد تتبع RTL، لكن مخططًا تقنيًا قد يحتاج موضعًا ثابتًا. لا تجعل طبقة زخرفية شفافة تحجب زرًا تحتها دون قصد، وراجع IgnorePointer فقط عندما تكون الطبقة زخرفية فعلًا. إخفاء التفاعل ليس إصلاحًا إذا كانت الطبقة نفسها تحتاج نقرًا. افصل معنى الشارة والتسمية ولا تعتمد لونها فقط لإبلاغ المستخدم بحالة مهمة.

الاختبار مع المحتوى الحقيقي

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

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

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

import 'package:flutter/material.dart';
void main() => runApp(const MaterialApp(home: DemoPage()));
class DemoPage extends StatefulWidget {
  const DemoPage({super.key});
  @override
  State<DemoPage> createState() => _DemoPageState();
}
class _DemoPageState extends State<DemoPage> {
  int _taps = 0;
  @override
  Widget build(BuildContext context) => Scaffold(
    appBar: AppBar(title: const Text('Overlapping card')),
    body: Center(child: ConstrainedBox(constraints: const BoxConstraints(maxWidth: 600),
      child: ListView(padding: const EdgeInsets.all(16), children: [
        Stack(key: const ValueKey('card-stack'), clipBehavior: Clip.none, children: [
          Padding(padding: const EdgeInsets.only(top: 24), child: Card(child: Padding(
            padding: const EdgeInsetsDirectional.fromSTEB(16, 48, 16, 20),
            child: Column(crossAxisAlignment: CrossAxisAlignment.start, children: [
              Text('A lesson card with an overlapping badge', style: Theme.of(context).textTheme.titleLarge),
              const SizedBox(height: 12),
              const Text('The top padding reserves space so the badge does not cover the title.'),
              const SizedBox(height: 16),
              ElevatedButton(onPressed: () => setState(() { _taps++; }), child: const Text('Try action')),
              Text('Actions: $_taps'),
            ]),
          ))),
          const PositionedDirectional(top: 0, start: 20, child: CircleAvatar(
            key: ValueKey('lesson-badge'), radius: 30, child: Icon(Icons.menu_book),
          )),
        ]),
      ]),
    )),
  );
}

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

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

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

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

كيفية استخدام Stack و Positioned في flutter
شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

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