Navegación y rutas en Flutter

Esta sección presentará los mecanismos de navegación y enrutamiento en Flutter, incluyendo la navegación entre páginas, el paso de parámetros y las rutas con nombre.


Conceptos básicos de Navigator

Flutter utiliza Navigator para la gestión de páginas, implementando la navegación entre páginas basada en una estructura de pila (stack).

Ejemplo: Navegación básica entre páginas

// Navegar a una nueva página
Navigator.of(context).push(
  MaterialPageRoute(
    builder: (context) => const DetailPage(),
  ),
);

// Volver a la página anterior
Navigator.of(context).pop();

// Volver con un resultado
Navigator.of(context).pop('Datos devueltos');

// Reemplazar la página actual (sin retorno)
Navigator.of(context).pushReplacement(
  MaterialPageRoute(
    builder: (context) => const HomePage(),
  ),
);

// Volver a la página raíz
Navigator.of(context).popUntil((route) => route.isFirst);

MaterialPageRoute vs CupertinoPageRoute

Ejemplo: Animaciones de transición de páginas en diferentes plataformas

// Estilo Android - se eleva desde abajo
Navigator.of(context).push(
  MaterialPageRoute(
    builder: (context) => const DetailPage(),
  ),
);

// Estilo iOS - se desliza desde la derecha
Navigator.of(context).push(
  CupertinoPageRoute(
    builder: (context) => const DetailPage(),
  ),
);

// Efecto de transición personalizado
Navigator.of(context).push(
  PageRouteBuilder(
    pageBuilder: (context, animation, secondaryAnimation) {
      return const DetailPage();
    },
    transitionsBuilder: (context, animation, secondaryAnimation, child) {
      // Efecto de desvanecimiento (fade)
      return FadeTransition(
        opacity: animation,
        child: child,
      );
    },
    transitionDuration: const Duration(milliseconds: 300),
  ),
);

Paso de parámetros entre páginas

< h2 class="example">Ejemplo: Pasar parámetros a una nueva página
// Navegar a la página de detalles y pasar parámetros
Navigator.of(context).push(
  MaterialPageRoute(
    builder: (context) => ProductDetailPage(productId: 123),
  ),
);

// La página de detalles recibe los parámetros
class ProductDetailPage extends StatelessWidget {
  final int productId;

  const ProductDetailPage({
    super.key,
    required this.productId,
  });

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Producto $productId')),
      body: Center(child: Text('ID del producto: $productId')),
    );
  }
}

// Pasar múltiples parámetros
class UserProfilePage extends StatelessWidget {
  final String name;
  final int age;

  const UserProfilePage({
    super.key,
    required this.name,
    required this.age,
  });

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Página principal de $name')),
      body: Center(child: Text('Edad: $age')),
    );
  }
}

// Navegar
Navigator.of(context).push(
  MaterialPageRoute(
    builder: (context) => const UserProfilePage(
      name: 'Zhang San',
      age: 25,
    ),
  ),
);

Rutas con nombre

El uso de rutas con nombre puede simplificar la configuración de la navegación entre páginas.

Ejemplo: Configuración de rutas con nombre

void main() {
  runApp(
    MaterialApp(
      // Definir la tabla de rutas
      initialRoute: '/',
      routes: {
        '/': (context) => const HomePage(),
        '/detail': (context) => const DetailPage(),
        '/user': (context) => const UserPage(),
        '/settings': (context) => const SettingsPage(),
      },
    ),
  );
}

// Navegar
Navigator.pushNamed(context, '/detail');

// Navegar con parámetros
Navigator.pushNamed(context, '/user', arguments: {'name': 'Zhang San', 'age': 25});

// Obtener los parámetros en la página de destino
class DetailPage extends StatelessWidget {
  const DetailPage({super.key});

  @override
  Widget build(BuildContext context) {
    // Obtener los parámetros pasados
    final args = ModalRoute.of(context)?.settings.arguments as Map?;

    return Scaffold(
      appBar: AppBar(title: const Text('Página de detalles')),
      body: Center(
        child: Text('Parámetros: $args'),
      ),
    );
  }
}

Otra forma de pasar valores en rutas

Ejemplo: onGenerateRoute

MaterialApp(
  onGenerateRoute: (settings) {
    // Retornar diferentes páginas según el nombre de la ruta
    switch (settings.name) {
      case '/':
        return MaterialPageRoute(
          builder: (_) => const HomePage(),
        );
      case '/detail':
        // Obtener los parámetros desde arguments
        final args = settings.arguments as Map<String, dynamic>?;
        return MaterialPageRoute(
          builder: (_) => DetailPage(
            id: args?['id'] ?? 0,
            title: args?['title'] ?? '',
          ),
        );
      case '/product':
        final productId = settings.name?.split('/').last;
        return MaterialPageRoute(
          builder: (_) => ProductPage(id: productId ?? ''),
        );
      default:
        return MaterialPageRoute(
          builder: (_) => const NotFoundPage(),
        );
    }
  },
)

Para aplicaciones simples, el Navigator.push básico es suficiente; para aplicaciones medianas y grandes, se recomienda usar rutas con nombre o bibliotecas de gestión de rutas para administrar las páginas de manera unificada.

Otras extensiones