إنشاء ListView في Flutter باستخدام builder وseparated، مع قيود ارتفاع صحيحة وصف قابل لإعادة الاستخدام والتمييز بين القوائم القصيرة والطويلة.
ابدأ من مصدر العناصر
ListView يعرض عناصر قابلة للتمرير، لكن اختيار constructor يتبع حجم البيانات وشكلها. قائمة صغيرة من Widgets ثابتة قد تناسب children مباشرة، بينما builder يبني الصفوف عند الحاجة، وseparated يضيف فاصلًا بين العناصر. لا تنسخ تصميم محادثة خمس عشرة مرة لكي تنتج قائمة، ولا تمرر رقمًا ثابتًا إلى itemCount بينما تقرأ من بيانات عددها مختلف. المثال يستخدم عشرين عنوان درس محليًا وصفًا واحدًا قابلًا لإعادة الاستخدام، دون دوال ناقصة أو صور شبكة.
مساحة محدودة للقائمة الرأسية
Scaffold يعطي الجسم مساحة محدودة، وColumn داخله يمكن أن يحتوي رأسًا ثم Expanded للقائمة. وضع ListView مباشرة داخل Column دون Expanded أو قيد ارتفاع مناسب قد يسبب خطأ ارتفاع غير محدود. لا تحيط كل قائمة بـ SingleChildScrollView ثم تضيف shrinkWrap عشوائيًا حتى يختفي الخطأ؛ قد تحول قائمة طويلة إلى عمل تخطيط أكبر أو تمرير مزدوج مربك. اختر من البداية هل تريد صفحة بتمرير واحد عبر Slivers أم رأسًا ثابتًا وقائمة تتمرر تحته.
القائمة الأفقية لها قيد مختلف
ListView أفقي داخل Column يحتاج ارتفاعًا محدودًا لأنه يتمرر أفقيًا ويحتاج مساحة واضحة في المحور الآخر. المثال يضعه داخل SizedBox بارتفاع 72 لشرائح قصيرة، وتملك كل شريحة عرضًا مناسبًا. هذا الرقم يخص هذا المحتوى التجريبي وليس معيارًا لكل بطاقة. إذا أضفت صورة وعنوانًا متعدد الأسطر فراجع الارتفاع مع النص الكبير بدل افتراض أن 140 يحل كل حالة. اتجاه التمرير لا يحدد اتجاه اللغة؛ RTL مسألة Directionality مستقلة.
صف واحد بعقد واضح
LessonRow يستقبل عنوانًا ورقمًا تجريبيًا ويستخدم Card وPadding بدل دالة buildChat تعتمد متغيرات غير معروفة. يمكن استعمال المكوّن في نتائج بحث أو مفضلة مع البيانات نفسها، لكن توحيد التصميم لا يقتضي وضع التحميل والتنقل والخدمات كلها داخله. مرر callback عندما تحتاج تفاعلًا، وأبقِ مالك الحالة والبيانات واضحًا. لا تضف أزرارًا فارغة توحي بوظائف موجودة للمستخدم؛ المثال يعرض المحتوى فقط، وأي فتح تفاصيل يحتاج ربطًا صريحًا.
الأداء والهوية
builder يساعد على بناء الصفوف عند الحاجة لكنه لا يعالج صورة عملاقة أو حسابًا ثقيلًا داخل كل صف. تجنب جلب API من itemBuilder بلا إدارة، وحدد حجم الصور والفشل عند إضافتها. الهوية المستقرة مفيدة للعناصر ذات الحالة، ومع إعادة ترتيب بيانات builder قد تحتاج callback لمطابقة الفهرس الجديد. لا تضع UniqueKey جديدًا في كل build ثم تتوقع حفظ حالة الصف. إذا كانت كل الصفوف بارتفاع متساو يمكن تقييم itemExtent، أما نص متغير وتكبير خط فلا يناسبهما ارتفاع صارم دون اختبار.
الفحص النهائي
مرر إلى آخر عنصر وتأكد أنه يعرض بياناته الصحيحة ولا يعيد عنوان العنصر الأول، وراجع عدد الفواصل وحالة قائمة فارغة وعنصر واحد. جرّب السحب الأفقي في الشريط والسحب الرأسي في القائمة وتكبير النص والاتجاه العربي. عند إضافة بحث أو pagination حدد ما يحدث لموضع التمرير والاختيار بعد تحديث البيانات. المثال لا يحفظ الحالة بين تشغيلين ولا يقيس سرعة جهازك؛ اختبر الأداء بوضع profile وعلى بيانات تمثل المنتج قبل نسب أي تحسن إلى تغيير constructor وحده.
مثال مستقل للتجربة
شغّل المثال داخل مشروع Flutter تجريبي. يعتمد على Material فقط ولا يحتاج assets أو أصنافًا من مشروع خاص. غيّر مساحة النافذة وجرّب تكبير النص أثناء الفحص، ثم انقل المكوّن إلى مشروعك بعد تحديد سياق قيوده الفعلي.
import 'package:flutter/material.dart';
void main() => runApp(const MaterialApp(home: DemoPage()));
class DemoPage extends StatelessWidget {
const DemoPage({super.key});
static final _lessons = List.generate(20, (index) => 'Flutter lesson ${index + 1}');
@override
Widget build(BuildContext context) => Scaffold(
appBar: AppBar(title: const Text('Reusable list rows')),
body: Column(children: [
SizedBox(height: 72, child: ListView.separated(
padding: const EdgeInsets.all(12), scrollDirection: Axis.horizontal,
itemCount: 5,
separatorBuilder: (_, _) => const SizedBox(width: 8),
itemBuilder: (_, index) => SizedBox(width: 112, child: Center(child: Text('Topic ${index + 1}'))),
)),
Expanded(child: ListView.separated(
key: const PageStorageKey('lesson-list'), padding: const EdgeInsets.all(16),
itemCount: _lessons.length,
separatorBuilder: (_, _) => const SizedBox(height: 8),
itemBuilder: (_, index) => LessonRow(title: _lessons[index], number: index + 1),
)),
]),
);
}
class LessonRow extends StatelessWidget {
const LessonRow({super.key, required this.title, required this.number});
final String title;
final int number;
@override
Widget build(BuildContext context) => Card(child: Padding(
padding: const EdgeInsets.all(16), child: Column(crossAxisAlignment: CrossAxisAlignment.start, children: [
Text(title, style: Theme.of(context).textTheme.titleLarge),
const SizedBox(height: 8),
Text('Example item $number. This description can wrap at larger text sizes.'),
]),
));
}مرجع الواجهة البرمجية
راجع التوثيق الرسمي لمطابقة السلوك مع إصدار Flutter المستخدم. نجاح المثال في مساحة واحدة لا يثبت توافق التصميم مع جميع الشاشات؛ اختبر حدود الانتقال والاتجاه واللغة والنص الطويل.
الصور والفيديو من الشرح السابق
الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.






