导航是指允许用户跨越、进入和退出应用中不同内容片段的交互。
Android Jetpack 的 Navigation 组件包含 Navigation 库、Safe Args Gradle 插件,以及可帮助您实现应用导航的工具。Navigation 组件可处理各种导航用例,从简单的按钮点击到更复杂的模式(例如应用栏和抽屉式导航栏)。
主要概念
下表简要介绍了导航中的关键概念,以及用于实现这些概念的主要类型。
构思 |
目的 |
类型 |
---|---|---|
宿主 |
包含当前导航目的地的界面元素。也就是说,当用户浏览应用时,该应用实际上会在导航宿主中切换目的地。 |
|
图表 |
一种数据结构,用于定义应用中的所有导航目的地以及它们如何连接在一起。 |
|
控制器 |
用于管理目的地之间导航的中央协调器。该控制器提供了一些方法,可在目的地之间导航、处理深层链接、管理返回堆栈等。 |
|
目的地 |
导航图中的节点。当用户导航到此节点时,主机会显示其内容。 |
通常是在构建导航图时创建的。 |
路线 |
唯一标识目的地及其所需的任何数据。 您可以使用路线导航。路线可带您前往目的地。 |
任何可序列化的数据类型。 |
优点和功能
Navigation 组件提供了许多其他优势和功能,包括:
- 动画和过渡:为动画和过渡提供标准化资源。
- 深层链接:实现并处理可将用户直接转到目的地的深层链接。
- 界面模式:只需极少的额外工作即可支持抽屉式导航栏和底部导航等模式。
- 类型安全:支持在目的地之间传递类型安全的数据。
- ViewModel 支持:允许将
ViewModel
的作用域限定为导航图,以便在导航图的目的地之间共享与界面相关的数据。 - fragment 事务:全面支持和处理 fragment 事务。
- 返回和向上:默认情况下,系统会正确处理返回和向上操作。
设置您的环境
如需在您的项目中添加导航支持,请向应用的 build.gradle
文件添加以下依赖项:
plugins { // Kotlin serialization plugin for type safe routes and navigation arguments id 'org.jetbrains.kotlin.plugin.serialization' version '2.0.21' } dependencies { def nav_version = "2.8.8" // Jetpack Compose Integration implementation "androidx.navigation:navigation-compose:$nav_version" // Views/Fragments Integration implementation "androidx.navigation:navigation-fragment:$nav_version" implementation "androidx.navigation:navigation-ui:$nav_version" // Feature module support for Fragments implementation "androidx.navigation:navigation-dynamic-features-fragment:$nav_version" // Testing Navigation androidTestImplementation "androidx.navigation:navigation-testing:$nav_version" // JSON serialization library, works with the Kotlin serialization plugin. implementation "org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3" }
plugins { // Kotlin serialization plugin for type safe routes and navigation arguments kotlin("plugin.serialization") version "2.0.21" } dependencies { val nav_version = "2.8.8" // Jetpack Compose integration implementation("androidx.navigation:navigation-compose:$nav_version") // Views/Fragments integration implementation("androidx.navigation:navigation-fragment:$nav_version") implementation("androidx.navigation:navigation-ui:$nav_version") // Feature module support for Fragments implementation("androidx.navigation:navigation-dynamic-features-fragment:$nav_version") // Testing Navigation androidTestImplementation("androidx.navigation:navigation-testing:$nav_version") // JSON serialization library, works with the Kotlin serialization plugin implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3") }
如需了解如何向您的项目添加其他架构组件,请参阅向项目添加组件。
后续步骤
有关 Navigation 组件的更多文档和资源,请参阅以下资源。
详细指南
如需详细了解如何实现导航宿主和 NavController
,以及它们如何与 Compose 和其他界面框架进行交互,请参阅以下指南:
Codelab
视频
- 浏览导航组件
- 移到一个 activity 的 10 大最佳实践
- 一个 activity:为何、何时以及如何(2018 年 Android 开发者峰会)
- Android Jetpack:使用导航控制器管理界面导航(2018 年 Google I/O 大会)
示例
您可以在一条文本字符串中支持多个链接,以便用户选择要前往的位置并提高互动度。 您可以设置文本的部分样式,以提高可读性、提升用户体验,并通过使用颜色和字体来激发更大的创造力。 您可以在用户在文本字段中输入内容(例如输入姓名、电子邮件地址、地址或其他联系信息)时验证输入内容。此验证可减少错误并为用户节省时间。 如需在应用中显示图片(用于内容和响应用户操作),请从磁盘或互联网上的外部来源加载图片。 卡片可为界面提供 Material Design 容器。 使用 TopAppBar 可组合项创建顶部应用栏,以帮助用户在应用中导航和访问功能。 了解如何使用 Compose Animation API 为状态值添加动画效果、使用转场效果添加动画效果、为可见性或大小更改添加动画效果,以及添加交叉淡化效果。 应用栏是位于屏幕顶部或底部的容器,其中包含主要功能和导航项。 您可以创建一个图标,以便根据用户的切换开关隐藏或显示密码,从而提高安全性并提升用户体验。 您可以加载可绘制文件来显示动画图片,从而在应用中打造更具互动性和吸引力的用户体验。动画图片非常适合用于创建加载指示器、成功或错误指示器,以及促进游戏开发和各种其他界面功能。 限制应用在小屏设备上的屏幕方向,但不限制其在大屏设备上的屏幕方向。 您可以在图片的剪裁区域周围绘制阴影,以便以剪辑的形状显示图片。 了解如何管理可拆卸键盘配置更改。 进度指示器会显示操作的状态。 创建分页列表,以便用户滚动浏览无法在一屏中显示的内容。水平分页列表可帮助用户浏览图片、幻灯片或商品轮播界面等内容。垂直分页列表非常适合内容丰富的应用,在这些应用中,用户可能需要滚动浏览大量内容(例如文章)。 您可以使用切换开关让用户选择两种状态之一。 为界面选择合适的组件,并了解如何在应用中实现该组件。 按钮可触发特定操作。 条状标签组件可直观地表示复杂的实体,通常包含图标和标签。 构建您的首个 Jetpack Compose 测试。了解如何使用 Compose 的测试工件编写界面测试、使用测试规则、查找器和断言。 用户可以通过悬浮操作按钮在应用中执行主要操作。 拒绝触控笔手掌误触。 对话框会在应用主要内容之上的层上显示弹出式消息或请求用户输入。 框架可将界面的不同部分(例如应用栏和悬浮操作按钮)整合在一起,从而让应用具有一致的外观和风格。支持在单个文本字符串中添加多个链接
设置文本的部分样式
在用户输入时验证输入内容
加载和显示图片
创建一个用作容器的卡片
显示顶部应用栏
Compose 中的动画
显示应用栏
根据用户切换开关显示或隐藏密码
显示动画图片
限制应用在手机上的屏幕方向,但不限制其在大屏设备上的屏幕方向
显示裁剪为某个形状的图片
管理可拆卸键盘配置变更
创建进度指示器
显示分页列表
添加用户可以切换的开关
显示互动组件
创建按钮
创建用于表示复杂实体的条状标签
在 Compose 中进行测试
创建悬浮操作按钮 (FAB)
拒绝触控笔手掌轻触
显示弹出式消息或请求用户输入
创建一个框架组件来将界面整合在一起