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);

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),
  ),
);

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,
    ),
  ),
);

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),
      ),
    );
  }
}

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(),
        );
    }
  },
)

Pour 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.

autres extensions