شارك المقالة
عرض حالة القائمة الفارغة في Flutter وفصلها عن التحميل والخطأ

عرض حالة القائمة الفارغة في Flutter وفصلها عن التحميل والخطأ

صمّم حالة القائمة الفارغة في Flutter بصورة ونص وإجراء واضح، وافصلها عن التحميل والخطأ دون فرض قيمة null أو عرض…

عرض حالة القائمة الفارغة في Flutter يحتاج التمييز بين التحميل والفشل وعدم وجود عناصر. لا تجعل شرط length == 0 يعرض CircularProgressIndicator دائمًا، ولا تستخدم tasks! إذا كان غياب البيانات جزءًا طبيعيًا من البداية. مكوّن بسيط يكفي لهذه المهمة دون إلزام التطبيق بحزمة شرطية إضافية.

مكوّن للحالات الأربع

يمثل loading انتظار الطلب، وerror فشلًا يمكن إعادة محاولته، وitems نتيجة ناجحة قد تكون فارغة. المقطع التالي مستقل، ويمكن تخصيص الرسالة بصورة أو زر إنشاء أول مهمة وفق المنتج. ليست هناك حاجة إلى empty_widget لتحقيق التصميم البسيط، ولذلك يطابق عنوان المقال ما يقدمه المثال فعليًا.

import 'package:flutter/material.dart';

class DataList extends StatelessWidget {
  const DataList({super.key, required this.loading, required this.items,
    required this.onRetry, this.error});
  final bool loading;
  final List<String> items;
  final String? error;
  final VoidCallback onRetry;
  @override
  Widget build(BuildContext context) {
    if (loading) return const Center(child: CircularProgressIndicator());
    if (error != null) {
      return Center(child: TextButton(onPressed: onRetry, child: const Text('إعادة المحاولة')));
    }
    if (items.isEmpty) return const Center(child: Text('لا توجد عناصر حتى الآن'));
    return ListView.builder(itemCount: items.length,
        itemBuilder: (context, index) => ListTile(title: Text(items[index])));
  }
}

القائمة الفارغة ليست خطأ

بعد اكتمال SQLite دون صفوف، اعرض نصًا واضحًا يدعو المستخدم لإنشاء مهمة. بعد البحث دون نتائج، اجعل النص مناسبًا للكلمة بدل رسالة «أضف مهمة». إذا كان هناك فلتر يخفي النتائج، وضح إمكانية مسحه، ولا تدّعِ أن قاعدة البيانات خالية بالكامل.

المحافظة على البيانات عند التحديث

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

ما الذي تختبره؟

اختبر الحقول الأربعة: تحميل، وخطأ مع زر إعادة محاولة، ونجاح فارغ، وقائمة غير فارغة. اختبر حذف آخر مهمة والعودة من شاشة الإضافة، وتأكد من إعادة القراءة لا من الاكتفاء بتغيير أيقونة. جرّب تكبير الخط وواجهة RTL، واجعل الرسالة تشرح الإجراء الممكن بدل مساحة بيضاء يظن المستخدم أنها عطل.

مراجع التنفيذ

لإكمال هذا الجزء، انتقل إلى جلب البيانات من SQLite وعرض قائمة المهام في Flutter، ثم طبّق الربط الذي يناسب بنية مشروعك.

صور الشرح السابق

اضافة مكتبة conditional مع null safety عرض نص وصوره في حالة عدم وجود بيانات في الlist داخل NoteApp في Flutter اضافة التصميم الجديد لل Note
شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

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