Adicionar uma ação "Up"

Os usuários precisam de uma maneira fácil de voltar à tela principal do app. Para fazer isso, forneça um Up botão na barra de apps para todas as atividades exceto a principal. Quando o usuário seleciona o botão "Para cima", o app navega para a atividade pai.

Esta página mostra como adicionar um botão "Up" a uma barra de apps usando o componente de navegação do Jetpack. Para uma explicação mais detalhada, consulte Atualizar componentes da interface com NavigationUI.

Observação:recomendamos o uso do componente de navegação do Jetpack para processar a navegação no app. Este componente processa a navegação para cima a partir da tela atual no app quando o usuário toca no botão "Para cima" . Para saber mais, consulte a documentação Componente de navegação do Jetpack.

Configurar a barra de apps

Configure sua barra de apps usando um AppBarConfiguration: No AppBarConfiguration, você pode informar a barra de apps sobre seus de destino. Se a gaveta de navegação estiver configurada, o ícone do menu aparece no app nos destinos de nível superior. Se a gaveta de navegação não estiver configurada, o botão de navegação será escondidas nos destinos de nível superior.

Em ambos os casos, o botão "Para cima" é exibido em todos os outros destinos. Pressionar o botão para cima chama navigateUp():

O exemplo a seguir mostra como configurar uma barra de apps usando 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);
  }