ارسال و دریافت داده بین صفحات در Navigation

Send data to a new screen & Return data

آموزش کامل ارسال پارامتر به صفحه مقصد و دریافت نتیجه بازگشتی از صفحه دوم با await Navigator.push و Navigator.pop

فهرست مطالب این صفحه

در برنامه‌های واقعی، جابه‌جایی بین صفحات معمولاً همراه با انتقال اطلاعات است؛ مثلاً ارسال اطلاعات یک محصول به صفحه جزئیات، یا بازگرداندن گزینه انتخاب‌شده از صفحه انتخاب به صفحه قبلی.

۱. ارسال داده به صفحه جدید (از طریق سازنده ویجت)

ساده‌ترین و ایمن‌ترین روش ارسال داده به صفحه مقصد در Flutter، تعریف فیلدهای final در کلاس ویجت مقصد و ارسال آن‌ها از طریق سازنده (Constructor) است:

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

class Product {
  const Product({required this.title, required this.price});
  final String title;
  final int price;
}

class ProductDetailScreen extends StatelessWidget {
  const ProductDetailScreen({super.key, required this.product});

  final Product product;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text(product.title)),
      body: Padding(
        padding: const EdgeInsets.all(20),
        child: Text('قیمت محصول: ${product.price} تومان'),
      ),
    );
  }
}

هنگام باز کردن صفحه جزئیات، شیء Product را مستقیماً به سازنده پاس می‌دهیم:

Dart
Navigator.push(
  context,
  MaterialPageRoute(
    builder: (context) => ProductDetailScreen(
      product: const Product(title: 'کتاب آموزش Flutter', price: 350000),
    ),
  ),
);

۲. دریافت داده بازگشتی از صفحه دوم (await Navigator.push)

متد Navigator.push() یک Future برمی‌گرداند که هنگام بسته شدن صفحه مقصد با Navigator.pop(context, result) تکمیل می‌شود. با استفاده از async و await می‌توانید نتیجه انتخاب کاربر را دریافت کنید:

Dart
class SelectionParentScreen extends StatefulWidget {
  const SelectionParentScreen({super.key});

  @override
  State<SelectionParentScreen> createState() => _SelectionParentScreenState();
}

class _SelectionParentScreenState extends State<SelectionParentScreen> {
  String _selectedOption = 'هنوز گزینه‌ای انتخاب نشده است';

  Future<void> _navigateAndSelect() async {
    final result = await Navigator.push<String>(
      context,
      MaterialPageRoute(builder: (context) => const OptionsScreen()),
    );

    if (!mounted || result == null) return;

    setState(() {
      _selectedOption = result;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('صفحه اصلی')),
      body: Center(
        child: Column(
          mainAxisSize: MainAxisSize.min,
          children: [
            Text(_selectedOption),
            const SizedBox(height: 16),
            ElevatedButton(
              onPressed: _navigateAndSelect,
              child: const Text('انتخاب گزینه از صفحه بعد'),
            ),
          ],
        ),
      ),
    );
  }
}

class OptionsScreen extends StatelessWidget {
  const OptionsScreen({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('یک گزینه انتخاب کنید')),
      body: Center(
        child: Column(
          mainAxisSize: MainAxisSize.min,
          children: [
            ElevatedButton(
              onPressed: () => Navigator.pop(context, 'گزینه اول: ارسال پیشتاز'),
              child: const Text('ارسال پیشتاز'),
            ),
            const SizedBox(height: 12),
            ElevatedButton(
              onPressed: () => Navigator.pop(context, 'گزینه دوم: تحویل حضوری'),
              child: const Text('تحویل حضوری'),
            ),
          ],
        ),
      ),
    );
  }
}