شارك المقالة
سحب Card في Flutter: flutter_swipable والبديل Dismissible

سحب Card في Flutter: flutter_swipable والبديل Dismissible

سحب Card في Flutter: flutter_swipable معلّمة discontinued وقيدها لا يدعم Dart 3.

سحب Card في Flutter يمكن تنفيذه باستخدام Dismissible المضمن عندما يكون المطلوب إزالة عنصر من قائمة. حزمة flutter_swipable المستخدمة في المثال القديم معلّمة discontinued وقيد SDK المنشور لها لا يقبل Dart 3. يوضح هذا المثال بديلًا للمهمة الأساسية دون الادعاء بأنه يطابق كل تأثيرات الحزمة القديمة.

اختر السلوك أولًا

Dismissible مناسب لسحب عنصر وإزالته. إذا كنت تريد كشف أزرار اتصال وحذف مع بقاء العنصر في مكانه، فهذه مهمة قائمة إجراءات مثل flutter_slidable. أما التنقل بين بطاقات قرار متعددة فيحتاج نموذجًا مختلفًا؛ لا تختَر الحزمة قبل تحديد ما سيحدث بعد السحب.

مفتاح ثابت لكل عنصر

يربط ValueKey هوية البطاقة بمعرف المهمة، وليس بموقعها في القائمة. عند onDismissed تزال المهمة المطابقة فورًا من الحالة حتى لا يبقى العنصر المحذوف داخل الشجرة. استخدام فهرس متغير قد يحذف بطاقة أخرى عندما تصل بيانات جديدة أو يعاد ترتيب العناصر.

الحذف الحقيقي والتراجع

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

الوصول والاتجاه

endToStart يتبع اتجاه الواجهة، لذلك اختبر RTL وLTR. ضع زر حذف بديلًا أو إجراءً في قائمة لمن لا يستخدم السحب، واجعل لون الخلفية مصحوبًا بأيقونة ومعنى واضح. اختبر القائمة الفارغة وسحب آخر عنصر؛ اختبار الواجهة هنا يتحقق من حذف الهوية الصحيحة.

مثال تطبيقي

المقطع التالي مستقل في ملف Dart. اختُبر منطق Dart والواجهات المشار إليها، وتبقى إعدادات المنصة والتجربة على جهاز فعلي مطلوبة قبل النشر.

import 'package:flutter/material.dart';

class SwipeItems extends StatefulWidget {
  const SwipeItems({super.key});
  @override
  State<SwipeItems> createState() => _SwipeItemsState();
}
class _SwipeItemsState extends State<SwipeItems> {
  final items = <String>['task-1', 'task-2'];
  @override
  Widget build(BuildContext context) => ListView(
    children: [for (final id in items) Dismissible(
      key: ValueKey(id),
      direction: DismissDirection.endToStart,
      background: Container(color: Colors.red, alignment: AlignmentDirectional.centerEnd,
        padding: const EdgeInsets.all(16), child: const Icon(Icons.delete, color: Colors.white)),
      onDismissed: (_) => setState(() => items.remove(id)),
      child: ListTile(title: Text(id)),
    )],
  );
}

تطبيق سحب Card في Flutter في مشروعك

flutter_swipable معلّمة discontinued وقيدها لا يدعم Dart 3. يمكن استخدام Dismissible المضمن لحذف عنصر مع مفتاح ثابت وتأكيد مناسب.

مراجع الموضوع: api.flutter.dev — Dismissible-class.html

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

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