新增向上瀏覽動作

使用者需要能夠輕鬆返回應用程式的主畫面。如要這麼做,請在應用程式列上提供主要活動以外的所有活動按鈕 。當使用者選取向上按鈕時,應用程式會前往父項活動。

本頁說明如何使用 Jetpack 導覽元件,將向上按鈕新增至應用程式列。如需更詳細的說明,請參閱「使用 NavigationUI 更新 UI 元件」。

設定應用程式列

使用 AppBarConfiguration 設定應用程式列。從 AppBarConfiguration 中,您可以通知頂層目的地的應用程式列。設定導覽匣後,導覽匣選單圖示 就會顯示在頂層目的地的應用程式列中。如果未設定導覽匣,導覽按鈕就不會顯示在頂層目的地中。

在這兩種情況下,所有其他目的地都會顯示「向上」按鈕。按下向上按鈕即可呼叫 navigateUp()

以下範例說明如何使用 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);
  }