Navigation 3

Navigation 3 est une bibliothèque de navigation conçue pour fonctionner avec Compose. Avec Navigation 3, vous contrôlez entièrement votre pile "Retour" et vous naviguez entre les destinations en ajoutant et en supprimant des éléments d'une liste. Il crée un système de navigation flexible dans l'application en fournissant :

  • Conventions pour modéliser une pile "Retour", où chaque entrée de la pile représente le contenu vers lequel l'utilisateur a navigué
  • Une UI qui se met automatiquement à jour en fonction des modifications de la pile « Retour » (y compris les animations)
  • Un champ d'application pour les éléments de la pile "Retour", permettant de conserver l'état lorsqu'un élément se trouve dans la pile "Retour"
  • Un système de mise en page adaptatif qui permet d'afficher plusieurs destinations en même temps, ce qui permet un changement dynamique entre ces mises en page.
  • Mécanisme permettant au contenu de communiquer avec sa mise en page parent (métadonnées)
  • Communication entre les destinations pour renvoyer les résultats entre les écrans

En règle générale, vous implémentez Navigation 3 de la manière suivante :

  1. Définissez le contenu vers lequel les utilisateurs peuvent naviguer dans votre application, chacun avec une clé unique, et ajoutez une fonction pour résoudre cette clé au contenu. Consultez Résoudre les clés en contenu.
  2. Créez une pile "Retour" sur laquelle les clés sont ajoutées et supprimées lorsque les utilisateurs parcourent votre application. Consultez Créer une pile "Retour".
  3. Utilisez un NavDisplay pour afficher la pile « Retour » de votre application. Chaque fois que la pile d'historique change, elle met à jour l'UI pour afficher le contenu pertinent. Consultez Afficher la pile "Retour".
  4. Modifiez les stratégies de scène de NavDisplay si nécessaire pour prendre en charge les mises en page adaptatives et différentes plates-formes.
  5. Prise en charge des liens profonds pour accéder directement aux destinations.

Vous pouvez consulter le code source complet de Navigation 3 sur AOSP.

Améliorations apportées à Jetpack Navigation

Navigation 3 améliore l'API Jetpack Navigation d'origine de la manière suivante :

  • Intégration plus simple avec Compose
  • Vous permet de contrôler entièrement la pile "Retour"
  • Permet de créer des mises en page capables de lire plusieurs destinations de la pile "Retour" en même temps, ce qui leur permet de s'adapter aux changements de taille de la fenêtre et à d'autres entrées.

Pour en savoir plus sur les principes de Navigation 3 et les choix de conception de l'API, consultez l'article de blog d'annonce.

Exemples de code

Le dépôt de recettes contient des exemples d'utilisation des composants de base de Navigation 3 pour résoudre les problèmes de navigation courants.