مسیریابی و جابه‌جایی بین صفحات (Navigation)

Navigate to a new screen and back

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

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

بیشتر اپلیکیشن‌ها شامل چندین صفحه (Screen یا Route) برای نمایش اطلاعات مختلف هستند. در Flutter، صفحات مختلف Route نامیده می‌شوند و توسط ویجت Navigator مدیریت می‌شوند.

ویجت Navigator پشته (Stack) از اشیای Route را مدیریت می‌کند و متدهایی مانند Navigator.push() و Navigator.pop() را برای مدیریت این پشته در اختیار شما قرار می‌دهد.

۱. ایجاد دو صفحه (Route)

ابتدا دو ویجت ساده برای صفحه اول و صفحه دوم ایجاد می‌کنیم:

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

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

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('صفحه اول')),
      body: Center(
        child: ElevatedButton(
          child: const Text('باز کردن صفحه دوم'),
          onPressed: () {
            Navigator.push(
              context,
              MaterialPageRoute(builder: (context) => const SecondRoute()),
            );
          },
        ),
      ),
    );
  }
}

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

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('صفحه دوم')),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            Navigator.pop(context);
          },
          child: const Text('بازگشت به صفحه اول'),
        ),
      ),
    );
  }
}

۲. حرکت به صفحه جدید با Navigator.push()

برای رفتن به یک مسیر جدید از متد Navigator.push() استفاده کنید. این متد یک Route را به بالای پشته مسیرهای تحت مدیریت Navigator اضافه می‌کند. کلاس MaterialPageRoute مسیر جدید را با انیمیشن استاندارد پلتفرم (اندروید یا iOS) جابه‌جا می‌کند.

۳. بازگشت به صفحه قبلی با Navigator.pop()

برای بستن صفحه فعلی و بازگشت به صفحه قبلی، متد Navigator.pop() را فراخوانی کنید. این متد مسیر فعلی را از بالای پشته Navigator خارج می‌کند.

نکته: هنگامی که از Scaffold همراه با AppBar استفاده می‌کنید، فلاتر به‌صورت خودکار دکمه بازگشت (Back Button) را در نوار بالایی صفحه دوم قرار می‌دهد که با لمس آن Navigator.pop(context) اجرا می‌شود.