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

تمرير البيانات بين صفحات Flutter وإرجاع نتيجة مكتوبة النوع

تمرير البيانات بين صفحات Flutter عبر constructor ونموذج واضح، ثم انتظار نتيجة Navigator.push والتعامل مع الإلغاء وفحص mounted بعد الرجوع.

تمرير البيانات بين صفحات Flutter عبر constructor ونموذج واضح، ثم انتظار نتيجة Navigator.push والتعامل مع الإلغاء وفحص mounted بعد الرجوع.

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

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

constructor يوضح العقد

استقبال قيمة required في constructor يجعل احتياجات الشاشة ظاهرة للمحلل والقارئ. إذا أرسلت Lesson فلن تضطر لاستخراج Map ديناميكية ثم فرض أنواعها باستخدام as دون تحقق. final يمنع إعادة إسناد الحقل، لكنه لا يجعل أي كائن داخله غير قابل للتعديل تلقائيًا؛ إذا أرسلت قائمة قابلة للتعديل فقرر من يملك تغييرها. في البيانات المهمة فضّل نموذجًا واضحًا ونسخة مناسبة أو إدارة حالة مشتركة بعقد معروف بدل مشاركة مراجع عشوائية.

النتيجة لها نوع وقد تكون غائبة

يمكن انتظار Future الناتجة عن push ثم استقبال قيمة أعادها pop. المثال يطلب bool، فيرجع true عند اختيار الدرس، بينما الرجوع دون اختيار قد يرجع null. لا تعامل null على أنه خطأ شبكة أو موافقة ضمنية، ولا تستخدم result! قبل معرفة الحالة. إذا احتجت أكثر من اختيارين فاستعمل enum أو نموذج نتيجة محددًا بدل نصوص سحرية يصعب تتبعها. اسم المتغير والرسالة يجب أن يشرحا ما حدث للمستخدم.

ما بعد await يحتاج فحص العمر

قد يختفي صاحب الطلب قبل اكتمال التنقل أو يعود المستخدم إلى مكان آخر. افحص mounted قبل setState أو استخدام سياق الصفحة بعد await. لا تحفظ BuildContext داخل خدمة طويلة العمر لتعرض الرسالة لاحقًا من أي مكان. احتفظ بنتيجة التنقل في طبقة الواجهة، ثم مرر العملية الفعلية إلى خدمة مناسبة إذا كانت تحتاج حفظًا أو طلبًا. نجاح رجوع القيمة لا يعني تنفيذ حفظ دائم أو إرسال اشتراك للخادم.

المعرّف أم الكائن الكامل؟

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

فحص التدفق كاملًا

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

مثال مستقل للتجربة

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

import 'package:flutter/material.dart';
void main() => runApp(const MaterialApp(home: DemoPage()));
class Lesson {
  const Lesson({required this.id, required this.title});
  final int id;
  final String title;
}
class DemoPage extends StatefulWidget {
  const DemoPage({super.key});
  @override
  State<DemoPage> createState() => _DemoPageState();
}
class _DemoPageState extends State<DemoPage> {
  String _status = 'No selection yet';
  bool _opening = false;
  Future<void> _open(Lesson lesson) async {
    if (_opening) return;
    setState(() { _opening = true; });
    try {
      final selected = await Navigator.of(context).push<bool>(
        MaterialPageRoute<bool>(builder: (_) => LessonDetails(lesson: lesson)),
      );
      if (!mounted) return;
      setState(() { _status = selected == true ? 'Selected: ${lesson.title}' : 'Selection cancelled'; });
    } finally {
      if (mounted) setState(() { _opening = false; });
    }
  }
  @override
  Widget build(BuildContext context) => Scaffold(
    appBar: AppBar(title: const Text('Pass data')),
    body: ListView(padding: const EdgeInsets.all(16), children: [
      Text(_status),
      for (final lesson in const [Lesson(id: 1, title: 'Dart basics'), Lesson(id: 2, title: 'Flutter layouts')])
        ListTile(title: Text(lesson.title), onTap: _opening ? null : () => _open(lesson)),
    ]),
  );
}
class LessonDetails extends StatelessWidget {
  const LessonDetails({super.key, required this.lesson});
  final Lesson lesson;
  @override
  Widget build(BuildContext context) => Scaffold(
    appBar: AppBar(title: Text(lesson.title)),
    body: ListView(padding: const EdgeInsets.all(16), children: [
      Text('Lesson ID: ${lesson.id}'),
      ElevatedButton(onPressed: () => Navigator.of(context).pop<bool>(true), child: const Text('Select lesson')),
    ]),
  );
}

مرجع الواجهة البرمجية

راجع التوثيق الرسمي لمطابقة السلوك مع إصدار Flutter المستخدم. نجاح المثال في مساحة واحدة لا يثبت توافق التصميم مع جميع الشاشات؛ اختبر حدود الانتقال والاتجاه واللغة والنص الطويل.

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

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

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

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