تنفيذ Pagination في Firestore مع Flutter باستخدام limit وstartAfterDocument بدل تحميل المجموعة كاملة، مع ترتيب ثابت ومنع الطلبات المتكررة.
عرض جزء من قائمة ليس تقسيمًا للقراءة
جلب جميع المستندات ثم عرض ستة منها لا يقلل البيانات المحملة أو عدد القراءات. في مثال قائمة المنتجات اجعل الخادم يعيد دفعة محدودة، واحتفظ بآخر DocumentSnapshot كنقطة بدء للدفعة التالية. لا تستخدم offset ذهنيًا عبر زيادة عدد العناصر المرئية فقط. إذا أعدت طلب أول القائمة بحد أكبر كل مرة فإنك تعيد تنزيل مستندات سبق الحصول عليها بدل متابعة المؤشر.
الترتيب وعقد البيانات
يستخدم المثال createdAt مع معرف المستند لتحديد ترتيب واضح عند تساوي الوقت. يجب أن تتضمن المستندات المرتبة هذا الحقل بنوع متسق، وقد تحتاج فهرسًا يطلبه Firestore للاستعلام الفعلي. لا تبن وقت الإنشاء على ساعة جهاز غير موثوقة عند الحاجة لترتيب مشترك؛ احفظ serverTimestamp أثناء الكتابة وتعامل مع حالة القيمة المعلقة داخل الواجهة. تغيير الفلتر يعني بدء قائمة جديدة ومؤشر جديد.
حالة الطلب ونهاية النتائج
احتفظ بعلم loading لمنع طلبين متزامنين، وبحالة hasMore لإيقاف التحميل بعد نهاية النتائج. قلة نتائج الدفعة عن حجمها علامة مناسبة للنهاية؛ أما امتلاء آخر دفعة تمامًا فقد يحتاج طلبًا إضافيًا خاليًا. عند فشل الجلب لا تحرك المؤشر ولا تمسح القائمة الناجحة. استخدم معرفات المستندات لكشف التكرار إذا تغيرت البيانات أثناء التصفح، وأتح تحديث القائمة من بدايتها بشكل واضح.
اختبار التقسيم والحدود
اختبر قائمة فارغة ودفعة واحدة وحدودًا تساوي حجم الدفعة وزيادة مستند واحد. جرّب تمريرًا سريعًا وشبكة بطيئة وتغيير القسم قبل انتهاء الطلب؛ لا تدمج استجابة الفلتر القديم في الجديد. المقطع التالي ينفذ طلب دفعة فقط، ولا يدير حالة الشاشة أو الاستماع اللحظي. عند جمع cursor pagination مع بيانات تتغير باستمرار حدد هل تريد لقطة مستقرة أم آخر الأخبار، لأن كل اختيار له سياسة تحديث مختلفة.
المثال التطبيقي وحدوده
أضف الحزم المستوردة بإصدارات متوافقة، وهيئ Firebase قبل استخدام خدماته. المقطع يوضح الجزء المذكور في الشرح؛ إعدادات المنصة والقواعد وواجهة الحالات تظل مسؤولية المشروع المستضيف.
import 'package:cloud_firestore/cloud_firestore.dart';
Future<QuerySnapshot<Map<String, dynamic>>> fetchProductPage({
DocumentSnapshot<Map<String, dynamic>>? after,
int size = 12,
}) {
if (size < 1 || size > 50) throw ArgumentError.value(size, 'size');
Query<Map<String, dynamic>> query = FirebaseFirestore.instance
.collection('products')
.orderBy('createdAt', descending: true)
.orderBy(FieldPath.documentId)
.limit(size);
if (after != null) query = query.startAfterDocument(after);
return query.get();
}الصور والفيديو من الشرح
المواد المرئية الأصلية محفوظة للرجوع إليها. قد تعرض إصدارًا قديمًا؛ عند الاختلاف اتبع النص والأمثلة المصححة أعلاه، خاصة في خدمات الإشعارات والروابط التي تغيرت.








