شارك المقالة
التنقل بين الصفحات في Flutter باستخدام GetX وإرجاع النتائج

التنقل بين الصفحات في Flutter باستخدام GetX وإرجاع النتائج

شرح التنقل بين الصفحات باستخدام GetX في Flutter: Get.toNamed وGet.back وGet.offNamed وGet.offAllNamed، مع فهم مكدس الصفحات وإرجاع نتيجة.

شرح التنقل بين الصفحات باستخدام GetX في Flutter: Get.toNamed وGet.back وGet.offNamed وGet.offAllNamed، مع فهم مكدس الصفحات وإرجاع نتيجة.

اختر أثر التنقل قبل اختيار الدالة

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

تهيئة GetMaterialApp والمسارات

يعرف RoutesDemo ثلاثة مسارات تبدأ بشرطة مائلة: / و/details و/done. تتطابق الأسماء المستعملة في toNamed وoffNamed مع getPages. الأخطاء الإملائية أو حذف الشرطة قد تجعل المثال لا يفتح الوجهة المقصودة. لا تضف GetMaterialApp داخل كل صفحة؛ احتفظ بجذر واحد لتجربة التنقل المعتادة، ثم عرّف الصفحات والاعتماديات الخاصة بها في مكان واضح.

إضافة صفحة ثم العودة بنتيجة

يفتح Get.toNamed صفحة التفاصيل ويعيد Future للنتيجة عند إغلاقها. تستدعي صفحة التفاصيل Get.back(result:…) لإرجاع قيمة إلى المستدعي. بعد await نفحص context.mounted قبل استعمال سياق العرض. قد يعود المستخدم دون نتيجة، لذلك يعالج المثال null بدل فرض وجود نص دائمًا. بيانات النتيجة هنا String للتوضيح، ويمكن استخدام نموذج typed عندما تكون النتيجة أكثر تعقيدًا.

استبدال الصفحة الحالية

ينقل Get.offNamed إلى /done مع استبدال الصفحة الحالية بدل إضافة واحدة فوقها. هذا مناسب لبعض خطوات التدفق التي لا ينبغي العودة إلى نسختها السابقة، لكنه لا يعني مسح كل الصفحات الأخرى. اختبر الرجوع من الوجهة الجديدة وافهم أي صفحات تبقى أسفلها. لا تستبدل صفحة نموذج غير محفوظ دون سياسة واضحة لحفظ التغييرات أو تحذير المستخدم عند الحاجة.

مسح المكدس عند انتهاء التدفق

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

المتحكمات والبيانات المشتركة

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

التنقل المباشر مقابل الأسماء

يمكن استخدام Get.to(() => const DetailsRoute()) لتمرير منشئ Widget مباشرة. انتبه إلى استدعاء المنشئ؛ تمرير اسم الكلاس وحده مثل ScreenTwo دون أقواس ليس Widget جاهزًا. الأسماء تفيد عند وجود خريطة مسارات مركزية، لكن الروابط العميقة والويب تحتاج إعدادًا واختبارًا إضافيين ولا تتحقق تلقائيًا بمجرد تسمية route. راجع الخيارات التي يناسبها مشروعك بدل خلط نمطين عشوائيًا.

اختبارات الرجوع والنتائج

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

الإعداد أو عقد التكامل المطلوب

طبّق الجزء المناسب على مشروعك بعد مراجعة إصدار الحزمة والمنصة؛ قيم الإعداد هنا توضيحية وليست مفاتيح صالحة أو خدمة خلفية منشورة.

flutter pub add get

المثال التطبيقي المراجع

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

import 'package:flutter/material.dart';
import 'package:get/get.dart';

class RoutesDemo extends StatelessWidget {
  const RoutesDemo({super.key});
  @override
  Widget build(BuildContext context)=>GetMaterialApp(
    initialRoute:'/',getPages:[
      GetPage(name:'/',page:()=>const HomeRoute()),
      GetPage(name:'/details',page:()=>const DetailsRoute()),
      GetPage(name:'/done',page:()=>Scaffold(body:TextButton(
        onPressed:()=>Get.offAllNamed('/'),child:const Text('Back to home')))),
    ],
  );
}
class HomeRoute extends StatelessWidget {
  const HomeRoute({super.key});
  @override
  Widget build(BuildContext context)=>Scaffold(body:Center(child:ElevatedButton(
    onPressed:() async {
      final result=await Get.toNamed('/details');
      if (!context.mounted || result is! String)return;
      ScaffoldMessenger.of(context).showSnackBar(SnackBar(content:Text(result)));
    },child:const Text('Details'))));
}
class DetailsRoute extends StatelessWidget {
  const DetailsRoute({super.key});
  @override
  Widget build(BuildContext context)=>Scaffold(appBar:AppBar(title:const Text('Details')),
    body:Column(children:[
      TextButton(onPressed:()=>Get.back(result:'Saved'),child:const Text('Save and return')),
      TextButton(onPressed:()=>Get.offNamed('/done'),child:const Text('Replace this page')),
    ]));
}

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

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

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