建立導覽控制器
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
導覽控制器是導覽的重要概念之一。它會保留導覽圖,並公開讓應用程式在圖中目的地之間移動的方法。
使用 Navigation 元件時,您可以使用 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
,在導覽圖中的目的地之間移動。
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間:2024-09-12 (世界標準時間)。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"缺少我需要的資訊"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"過於複雜/步驟過多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"過時"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻譯問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/程式碼問題"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"容易理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"確實解決了我的問題"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u4e0a\u6b21\u66f4\u65b0\u6642\u9593\uff1a2024-09-12 (\u4e16\u754c\u6a19\u6e96\u6642\u9593)\u3002"}
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2024-09-12 (世界標準時間)。"]]