Ajouter une action "Haut"

Les utilisateurs ont besoin d'un moyen facile de revenir à l'écran principal de votre application. Pour ce faire, indiquez une valeur Up bouton dans la barre d'application pour toutes les activités, sauf la principale. Lorsque l'utilisateur sélectionne le bouton "Haut", l'application accède à l'activité parent.

Cette page explique comment ajouter un bouton "Haut" à une barre d'application à l'aide du composant Navigation de Jetpack. Pour une explication plus détaillée, consultez Mettre à jour les composants de l'interface utilisateur avec NavigationUI

<ph type="x-smartling-placeholder">

</ph> Remarque:Nous vous recommandons d'utiliser le composant Navigation de Jetpack pour gérer la navigation dans votre application. Ce composant gère la navigation vers le haut à partir de l'écran actuel dans votre application lorsque l'utilisateur appuie sur le bouton "Haut" . Pour en savoir plus, consultez la documentation Composant Navigation de Jetpack.

Configurer votre barre d'application

Configurez votre barre d'application à l'aide d'un AppBarConfiguration À partir du AppBarConfiguration, vous pouvez indiquer à la barre d'application votre niveau supérieur de destination. Si le panneau de navigation est configuré, l'icône de menu du panneau s'affiche sur l'application sur les destinations de niveau supérieur. Si le panneau de navigation n'est pas configuré, le bouton de navigation est est masqué sur les destinations de niveau supérieur.

Dans les deux cas, le bouton "Niveau supérieur" s'affiche sur toutes les autres destinations. Appuyez sur le bouton Haut pour appeler navigateUp()

L'exemple suivant montre comment configurer une barre d'application avec AppBarConfiguration:

Kotlin

  override fun onCreate(savedInstanceState: Bundle?) {
    ...
    val navController = findNavController(R.id.nav_host_fragment_activity_main)
    
    val appBarConfiguration = AppBarConfiguration(
        setOf(
            R.id.navigation_home, R.id.navigation_dashboard, R.id.navigation_notifications
        )
    )
    binding.myToolbar.setupWithNavController(navController, appBarConfiguration)
  }
  

Java

  @Override
  protected void onCreate(Bundle savedInstanceState) {
      ...
      NavController navController = Navigation.findNavController(this, R.id.nav_host_fragment_activity_main);

      AppBarConfiguration appBarConfiguration = new AppBarConfiguration.Builder(
              R.id.navigation_home, R.id.navigation_dashboard, R.id.navigation_notifications)
              .build();
      NavigationUI.setupWithNavController(binding.myToolbar, navController, appBarConfiguration);
  }