Navigation 3

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

  • Conventions pour la modélisation d'une pile "Retour", où chaque entrée de la pile "Retour" représente le contenu vers lequel l'utilisateur a navigué
  • Une interface utilisateur qui se met automatiquement à jour avec les modifications de la pile "Retour" (y compris les animations)
  • Une portée pour les éléments de la pile "Retour", ce qui permet 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 et de passer facilement d'une mise en page à l'autre
  • Un mécanisme permettant au contenu de communiquer avec sa mise en page parente (métadonnées)

De manière 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é dans le contenu. Consultez Résoudre les clés dans le contenu.
  2. Créez une pile "Retour" dans laquelle les clés sont insérées et supprimées lorsque les utilisateurs naviguent dans 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 "Retour" change, elle met à jour l'interface utilisateur pour afficher le contenu pertinent. Consultez Afficher la pile "Retour".
  4. Modifiez les stratégies de scène de NavDisplay's si nécessaire pour prendre en charge les mises en page adaptatives et différentes plates-formes.
  5. Prenez en charge les liens profonds pour accéder directement aux destinations.

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

Améliorations par rapport à Jetpack Navigation

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

  • Fournit une intégration plus simple avec Compose
  • Vous offre un contrôle total de la pile "Retour"
  • Permet de créer des mises en page qui peuvent lire plusieurs destinations à partir de la pile "Retour" en même temps, ce qui leur permet de s'adapter aux modifications de la 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 blocs de construction de Navigation 3 pour résoudre les problèmes de navigation courants.