新增向上瀏覽動作

使用者需要能夠輕鬆返回應用程式主畫面的方法。如要這麼做,請使用向上鍵 應用程式列上的 按鈕 用於所有活動 (主要活動除外)使用者選取「向上」按鈕時,應用程式會導覽至 父項活動

本頁說明如何使用 Jetpack Navigation 元件,在應用程式列中新增向上按鈕。 如需更詳盡的說明,請參閱 使用 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);
  }