建立導覽控制器

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

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

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

注意：您建立的每個 NavHost 都有相對應的 NavController。NavController 可用來存取 NavHost 的圖表。

Compose

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

val navController = rememberNavController()

您應在可組合函式階層中較高的階層建立 NavController。階層必須夠高，所有需參照此控制器的可組合函式才能完成參照。

您也能使用 NavController 做為單一可靠的資料來源，方便更新畫面外的可組合函式。這種做法符合狀態提升原則。

View

如果您使用 View UI 架構，可以視情況使用其中一種方法擷取 NavController。

Kotlin：

• Fragment.findNavController()
• View.findNavController()
• Activity.findNavController(viewId: Int)

Java：

• NavHostFragment.findNavController(Fragment)
• Navigation.findNavController(Activity, @IdRes int viewId)
• Navigation.findNavController(View)

通常，您會先取得 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();

警告：您使用 FragmentContainerView 建立 NavHostFragment，或使用 FragmentTransaction 將 NavHostFragment 手動新增至活動時，可能會遇到問題。如果您這麼做，且嘗試擷取 onCreate() 中的 NavController，可能會導致 Navigation.findNavController(Activity, @IdRes int) 失敗。請改為直接從 NavHostFragment 擷取 NavController，如上述範例所示。

其他資訊

• 設計導覽圖：這份指南詳細說明如何將圖表新增至 NavController，且圖中包含應用程式內的所有目的地。
• 前往目的地：這份指南詳細說明如何使用 NavController，在導覽圖中的目的地之間移動。