Navigation et routage Flutter
Cette section présentera les mécanismes de navigation et de routage dans Flutter, y compris les transitions de page, le passage de paramètres et les routes nommées.
Notions de base de Navigator
Flutter utilise Navigator pour la gestion des pages, en implémentant les transitions de page sur la base d'une structure de pile.
Exemple : navigation de base entre pages
// Naviguer vers une nouvelle page
Navigator.of(context).push(
MaterialPageRoute(
builder: (context) => const DetailPage(),
),
);
// Revenir à la page précédente
Navigator.of(context).pop();
// Revenir avec un résultat
Navigator.of(context).pop('Returned data');
// Remplacer la page actuelle (impossible de revenir en arrière)
Navigator.of(context).pushReplacement(
MaterialPageRoute(
builder: (context) => const HomePage(),
),
);
// Revenir à la page racine
Navigator.of(context).popUntil((route) => route.isFirst);
Navigator.of(context).push(
MaterialPageRoute(
builder: (context) => const DetailPage(),
),
);
// Revenir à la page précédente
Navigator.of(context).pop();
// Revenir avec un résultat
Navigator.of(context).pop('Returned data');
// Remplacer la page actuelle (impossible de revenir en arrière)
Navigator.of(context).pushReplacement(
MaterialPageRoute(
builder: (context) => const HomePage(),
),
);
// Revenir à la page racine
Navigator.of(context).popUntil((route) => route.isFirst);
MaterialPageRoute vs CupertinoPageRoute
Exemple : Animations de transition de page sur différentes plateformes
// Style Android - monte depuis le bas
Navigator.of(context).push(
MaterialPageRoute(
builder: (context) => const DetailPage(),
),
);
// Style iOS - glisse depuis la droite
Navigator.of(context).push(
CupertinoPageRoute(
builder: (context) => const DetailPage(),
),
);
// Effet de transition personnalisé
Navigator.of(context).push(
PageRouteBuilder(
pageBuilder: (context, animation, secondaryAnimation) {
return const DetailPage();
},
transitionsBuilder: (context, animation, secondaryAnimation, child) {
// Effet de fondu d'entrée/sortie
return FadeTransition(
opacity: animation,
child: child,
);
},
transitionDuration: const Duration(milliseconds: 300),
),
);
Navigator.of(context).push(
MaterialPageRoute(
builder: (context) => const DetailPage(),
),
);
// Style iOS - glisse depuis la droite
Navigator.of(context).push(
CupertinoPageRoute(
builder: (context) => const DetailPage(),
),
);
// Effet de transition personnalisé
Navigator.of(context).push(
PageRouteBuilder(
pageBuilder: (context, animation, secondaryAnimation) {
return const DetailPage();
},
transitionsBuilder: (context, animation, secondaryAnimation, child) {
// Effet de fondu d'entrée/sortie
return FadeTransition(
opacity: animation,
child: child,
);
},
transitionDuration: const Duration(milliseconds: 300),
),
);
Transmission de paramètres de page
< h2 class="example">Exemple : transmission de paramètres à une nouvelle page
// Accéder à la page de détail et transmettre les paramètres
Navigator.of(context).push(
MaterialPageRoute(
builder: (context) => ProductDetailPage(productId: 123),
),
);
// La page de détail reçoit les paramètres
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('Produit $productId')),
body: Center(child: Text('ID du produit: $productId')),
);
}
}
// Passer plusieurs paramètres
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(Page d'accueil de $name)),
body: Center(child: Text('Âge: $age')),
);
}
}
// Sauter
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 page de détail reçoit les paramètres
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('Produit $productId')),
body: Center(child: Text('ID du produit: $productId')),
);
}
}
// Passer plusieurs paramètres
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(Page d'accueil de $name)),
body: Center(child: Text('Âge: $age')),
);
}
}
// Sauter
Navigator.of(context).push(
MaterialPageRoute(
builder: (context) => const UserProfilePage(
name: 'Zhang San',
age: 25,
),
),
);
Route nommée
L'utilisation de routes nommées peut simplifier la configuration des transitions de page.
Exemple : Configuration de routes nommées
void main() {
runApp(
MaterialApp(
// Définir la table de routage
initialRoute: '/',
routes: {
'/': (context) => const HomePage(),
'/detail': (context) => const DetailPage(),
'/user': (context) => const UserPage(),
'/settings': (context) => const SettingsPage(),
},
),
);
}
// Sauter
Navigator.pushNamed(context, '/detail');
// Naviguer avec des paramètres
Navigator.pushNamed(context, '/user', arguments: {'name': 'Zhang San', 'age': 25});
// Obtenir les paramètres sur la page cible
class DetailPage extends StatelessWidget {
const DetailPage({super.key});
@override
Widget build(BuildContext context) {
// Récupérer les paramètres transmis
final args = ModalRoute.of(context)?.settings.arguments as Map?;
return Scaffold(
appBar: AppBar(title: const Text('Page de détail')),
body: Center(
child: Text(Arguments : $args),
),
);
}
}
runApp(
MaterialApp(
// Définir la table de routage
initialRoute: '/',
routes: {
'/': (context) => const HomePage(),
'/detail': (context) => const DetailPage(),
'/user': (context) => const UserPage(),
'/settings': (context) => const SettingsPage(),
},
),
);
}
// Sauter
Navigator.pushNamed(context, '/detail');
// Naviguer avec des paramètres
Navigator.pushNamed(context, '/user', arguments: {'name': 'Zhang San', 'age': 25});
// Obtenir les paramètres sur la page cible
class DetailPage extends StatelessWidget {
const DetailPage({super.key});
@override
Widget build(BuildContext context) {
// Récupérer les paramètres transmis
final args = ModalRoute.of(context)?.settings.arguments as Map?;
return Scaffold(
appBar: AppBar(title: const Text('Page de détail')),
body: Center(
child: Text(Arguments : $args),
),
);
}
}
Une autre façon de transmettre des valeurs lors du routage
Exemple : onGenerateRoute
MaterialApp(
onGenerateRoute: (settings) {
// Retourner différentes pages en fonction du nom de la route
switch (settings.name) {
case '/':
return MaterialPageRoute(
builder: (_) => const HomePage(),
);
case '/detail':
// Récupérer les paramètres à partir des 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) {
// Retourner différentes pages en fonction du nom de la route
switch (settings.name) {
case '/':
return MaterialPageRoute(
builder: (_) => const HomePage(),
);
case '/detail':
// Récupérer les paramètres à partir des 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(),
);
}
},
)
autres extensionsPour les applications simples, Navigator.push de base suffit ; pour les applications de taille moyenne à grande, il est recommandé d'utiliser des routes nommées ou des bibliothèques de gestion de routage pour gérer les pages de manière centralisée.