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);
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),
),
);
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,
),
),
);
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'),
),
);
}
}
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(),
);
}
},
)
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(),
);
}
},
)
Otras extensionesPara 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.