文章目录
- 1. 知识回顾
- 2. 使用方法
- 2.1 通过参数传递数据
- 2.2 获取参数中的数据
- 2.3 共享导航控制器
- 3. 示例代码
- 4. 内容总结
我们在上一章回中介绍了Jetpack中导航相关的内容,本章回中 继续介绍导航相关的内容。闲话休提,让我们一起Talk Android Jetpack吧!
1. 知识回顾
我们在上一章回中主要介绍了导航的基本概念和实现导航的Navigation
库,以及库中常用的基础知识:导航目的地,导航图,导航容器和导航控制器。
接着介绍了导航的使用方法,使用方法分两种:传统用法和compose中的用法,传统方法一笔带过,我们重点介绍的是compose中导航的用法,本章回将在此基础上介绍如何在导航过程中传递数据,这也是项目中经常使用的知识。
2. 使用方法
2.1 通过参数传递数据
在导航中传递数据是通过参数进行的,这里的参数是指composable
函数中的参数,下面是详细的使用步骤:
- 在路由中添加参数名称;
- 给参数中添加数据,并且指定数据类型;
- 把数据赋值给composable函数的参数arguments;
大家还记得在Activity跳转时通过intent传递数据吗?通过参数传递数据与此过程类似,参数的名称相当于key,参数中的数据就是value。因此通过参数传递数据就是使用键值对的方式把数据存放到函数的参数中。此外,数据的类型都是基本的类型,比如int,String。如果是复杂的类型,比如类类型,就需要使用序列化,我们在这里不介绍,大家可以参考官方文档,因为它和传递普通数据的原理相同,只是操作细节上不同。
2.2 获取参数中的数据
把数据存放到导航中的函数参数中后,我们还需要把数据取出来,取出来的方法比较容易,直接使用参数的的getXXX(key)
方法就可以,这里的key是路由中的参数名称,XXX表示某种数据类型,比如getInt,getString.我们在稍后的小节中通过具体的代码给大家演示。
2.3 共享导航控制器
因为每个页面都需要导航器,我最初的想法是在页面函数中传入参数,其缺点就是页面太多会很麻烦。开始我想通过参数传递导航控制器,但是导航控制器的类型不是基本类型,于是我又想到了另外一种方法:共享数据。
把导航控制器以共享数据的方式共享给各个页面,页面可以随时获取导航控制器。这时就需要使用compositionLocal
相关的知识,官方文档称它为:通过组合隐式向下传递数据的工具,这个比较难理解,大家可以把它理解为一种全局变量,或者类中的静态成员。如果有Flutter开发经验的看官,可以把它理解为provider组件。compositionLocal的使用方法如下:
- 创建compositionLocal对象;
- 给compositionLocal对象赋值;
- 获取compositionLocal对象中当前的值;
这个过程看着简单,不过其中会用到很多的函数,具体的函数就不一一介绍了,大家参考下面的示例代码就能明白。
//创建compositionLocal对象
val LocalNavController = compositionLocalOf<NavHostController> {
error("localNavController not present")
}
//给compositionLocal对象赋值
val navController = rememberNavController()
CompositionLocalProvider(
LocalNavController provides navController,
) {
NavHost() //省略路由函数
}
//获取compositionLocal对象中当前的值
val navController = LocalNavController.current
在上面的代码中通过compositionLocal
共享了导航控制器,其实在compose项目中,主题的颜色就是使用它实现共享的。
官方文档不建议大家使用它,而是使用给函数传递参数的方式替代它。具体在项目中使用compositionLocal
还是使用参数,这个我不做推荐,大家依据自己的项目的来决定。关于compositionLocal
更加详细的内容,大家可以参考官方文档,文档中还有示例供大家参考。
3. 示例代码
//在导航中通过参数传递数据,dataParam是个占位符,
composable("exButton/{dataParam}",
//把被传递的数据存放在参数中,使用了navArgument()方法,这里指定了默认值,调用navigate方法传入真实数据
arguments = listOf(
navArgument(name = "dataParam") {
type = NavType.StringType
defaultValue = "it is a default data"
nullable = true
}
)
) {
//从导航参数中获取数据,这里的it是lambda中的参数,它的类型是NavBackStackEntry类型
val data = it.arguments?.getString("dataParam")?:"no data"
println(data)
}
在上面的代码中,我们通过参数传递了一个String类型的数据,数据的key就是参数中的dataParam,数据的value就是name后面的值。
此外,给参数赋值时需要使用navArgument
()方法,可以在该方法中指定数据的类型的数据,还可以设置数据的默认值。编译并且运行上面的程序可以在log中看到参数中传递的数据值。
4. 内容总结
最后,我们对本章回的内容做一个全面的总结:
- 在导航时可以通过参数来传递数据;
- 传递的数据通常是Sting,Int等基本类型;
- 传递数据本质上是把键值对进行封装后再传递;
- 传递数据的Key和获取数据的key一定要相同;
- 可以使用compositionLocal实现数据共享功能;
看官们,与Jetpack中导航相关的内容就介绍到这里,欢迎大家在评论区交流与讨论