شارك المقالة
تأكيد الرجوع في Flutter باستخدام PopScope بدل WillPopScope

تأكيد الرجوع في Flutter باستخدام PopScope بدل WillPopScope

شرح PopScope في Flutter لحماية التغييرات قبل الرجوع، مع منع تكرار الحوار وفهم didPop وحدود إيماءات الرجوع بين Android وiOS.

شرح PopScope في Flutter لحماية التغييرات قبل الرجوع، مع منع تكرار الحوار وفهم didPop وحدود إيماءات الرجوع بين Android وiOS.

الرجوع قرار قبل المحاولة

في واجهة الرجوع الحديثة تحتاج المنظومة معرفة السماح بالرجوع مسبقًا عبر canPop، بدل انتظار قرار غير متزامن بعد بدء الإيماءة في كل الحالات. PopScope يتيح وصف ذلك ومتابعة نتيجة محاولة الرجوع. راجع توافق إصدار Flutter، لأن onPopInvokedWithResult هي الواجهة المستخدمة هنا وقد تختلف عن أمثلة قديمة تستخدم callback سابقًا. WillPopScope القديم لا يحقق تكامل Android predictive back بالطريقة نفسها، لذلك لا تنسخ وصفة قديمة دون مراجعة دليل الهجرة.

معنى didPop

عندما يكون didPop صحيحًا فقد حدث الرجوع بالفعل، فلا تحاول فتح حوار تأكيد لإلغائه بعد وقوعه أو تنفيذ pop ثانية. عند منع الرجوع يمكن أن تصلك محاولة فاشلة تستدعي قرارًا مثل سؤال حفظ التغييرات. لا تساو بين callback والقدرة على إلغاء رجوع تم فعليًا. كذلك لا تفترض أن كل إيماءة iOS ستولد callback مع canPop=false؛ سلوك التعرف على الإيماءة يختلف، ولذلك اجعل زر الرجوع المرئي يملك مسار تأكيد واضحًا.

تجنب الحوارات المتكررة

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

تأكيد مغادرة صفحة لا قتل التطبيق

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

الملاحة المتداخلة وRouter

إذا احتوى التطبيق Navigator متداخلًا أو Router مركزيًا، راجع أي stack يملك الصفحة وأي قرار يتوقعه نظام التنقل المستخدم. pop على Navigator غير المقصود قد يغلق صفحة أو حوارًا مختلفًا. بعض التدفقات تستفيد من Form.canPop وما يرتبط بها بدل إعادة كتابة السياسة في عدة مواقع. اجعل قرار وجود تغييرات غير محفوظة مصدرًا واحدًا، ولا تربط المنع بمجرد وجود أي نص إذا كان النص قد حُفظ بالفعل أو يساوي القيمة الأصلية.

ماذا تختبر قبل الاعتماد؟

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

المثال التطبيقي

المثال مستقل للتعلم. شغّله داخل مشروع تجريبي، ثم بدّل مصدر البيانات المحلي بخدمة مشروعك بعد اختبار حالات النجاح والفشل. لا تنسخ أكثر من دالة main إلى الملف نفسه.

import 'package:flutter/material.dart';
void main() => runApp(MaterialApp(home: Builder(builder: (context) => Scaffold(
  body: Center(child: ElevatedButton(
    onPressed: () => Navigator.of(context).push(MaterialPageRoute<void>(builder: (_) => const DemoPage())),
    child: const Text('Open form'),
  )),
))));
class DemoPage extends StatefulWidget {
  const DemoPage({super.key});
  @override
  State<DemoPage> createState() => _DemoPageState();
}
class _DemoPageState extends State<DemoPage> {
  bool _allowPop = false;
  bool _asking = false;
  Future<void> _confirm() async {
    if (_asking) return;
    _asking = true;
    final leave = await showDialog<bool>(context: context, builder: (dialogContext) => AlertDialog(
      title: const Text('Leave this form?'),
      content: const Text('Unsaved changes will be lost.'),
      actions: [
        TextButton(onPressed: () => Navigator.of(dialogContext).pop(false), child: const Text('Stay')),
        TextButton(onPressed: () => Navigator.of(dialogContext).pop(true), child: const Text('Leave')),
      ],
    ));
    _asking = false;
    if (!mounted || leave != true) return;
    setState(() { _allowPop = true; });
    WidgetsBinding.instance.addPostFrameCallback((_) {
      if (mounted) Navigator.of(context).pop();
    });
  }
  @override
  Widget build(BuildContext context) => PopScope<void>(
    canPop: _allowPop,
    onPopInvokedWithResult: (didPop, result) { if (!didPop) _confirm(); },
    child: Scaffold(
      appBar: AppBar(leading: IconButton(onPressed: _confirm, icon: const Icon(Icons.arrow_back))),
      body: const Padding(padding: EdgeInsets.all(16), child: TextField(decoration: InputDecoration(labelText: 'Draft'))),
    ),
  );
}

التوثيق والتجربة

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

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

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

اظهار dialog عند الرغبه في الخروج من التطبيق
شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

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