建立導覽控制器

導覽控制器是導覽中的重要概念之一。它會保留導覽圖,並公開讓應用程式在圖表中的目的地之間移動。

使用導覽元件時,您可以使用 NavController 類別建立導覽控制器。NavController 是中心導覽 API,可追蹤使用者造訪過哪些目的地,並讓使用者在目的地之間移動。本指南說明如何在應用程式中建立 NavController

如要瞭解如何在 NavController 中新增導覽圖,請參閱「設計導覽圖」。NavController 提供了幾種前往圖表中目的地的不同方式。詳情請參閱「導覽至目的地」一文。

Compose

如要在使用 Jetpack Compose 時建立 NavController,請呼叫 rememberNavController()

val navController = rememberNavController()

您應在可組合項階層中建立 NavController 的高標。其高度必須夠高,讓所有需要參照其的可組合項都能進行參照。

這樣您就能使用 NavController 做為單一可靠資料來源,以更新畫面外的可組合項。這種做法符合狀態提升的原則。

View

如果您使用 View UI 架構,可以根據情況使用下列其中一種方法擷取 NavController:

Kotlin:

Java:

一般而言,您必須先取得 NavHostFragment,然後從片段中擷取 NavController。請參考下列程式碼片段:

Kotlin

val navHostFragment =
    supportFragmentManager.findFragmentById(R.id.nav_host_fragment) as NavHostFragment
val navController = navHostFragment.navController

Java

NavHostFragment navHostFragment =
    (NavHostFragment) getSupportFragmentManager().findFragmentById(R.id.nav_host_fragment);
NavController navController = navHostFragment.getNavController();

其他資訊

  • 設計導覽圖這份指南說明如何在 NavController 中加入圖表,其中包含應用程式中的所有目的地。
  • 前往目的地此指南詳細說明如何使用 NavController 在導覽圖中的目的地之間移動。