Navigation是jetpack中的一个ui控件,使用该组件可方便管理fragment的导航行为,甚至可以图形化管理fragment的跳转/动画,十分方便。
首先需要引入依赖
implementation'androidx.navigation:navigation-fragment-ktx:2.3.2'
implementation'androidx.navigation:navigation-ui-ktx:2.3.2'
之后新建资源
选择Navigation相关项目,文件名随意
在承载fragment的activity中声明以下内容用于执行navigation
注意name要固定写死
defaultNavHost表示是否要帮你处理back事件,即跳转之后back键返回上一界面
navGraph表示创建的nav配置文件位置
切换到design界面,新建一个Destination,
创建一个新的Destination,也可以选择一个已经存在的fragment作为Destination,跳转至少需要两个destination,
点击上方的小房子,可以选择主目的
fragment边缘拉出箭头,连接到另一个fragment上,生成跳转action
在设计界面添加过度动画
对应生成的代码:
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/nav_graph"
app:startDestination="@id/mainFragment">
<fragment
android:id="@+id/mainFragment"
android:name="com.chip.testnav.MainFragment"
android:label="fragment_main"
tools:layout="@layout/fragment_main" >
<action
android:id="@+id/action_mainFragment_to_secondFragment"
app:destination="@id/secondFragment"
app:enterAnim="@anim/slide_in_right"
app:exitAnim="@anim/slide_out_left"
app:popEnterAnim="@anim/slide_in_left"
app:popExitAnim="@anim/slide_out_right" />
</fragment>
<fragment
android:id="@+id/secondFragment"
android:name="com.chip.testnav.SecondFragment"
android:label="SecondFragment" />
</navigation>
主destination:
app:startDestination
name对应相应的fragment,点击可以链接过去
android:name
action表示箭头
<action
destination表示目的地
app:destination
enterAnim代表对应的动画
enterAnim
之后还需要在mainfragment中触发action
tv.setOnClickListener(Navigation.
createNavigateOnClickListener(R.id.action_mainFragment_to_secondFragment)
也可通过另一种方式绑定触发
tv.setOnClickListener { v -> Navigation.findNavController(v).navigate(
R.id.action_mainFragment_to_secondFragment) }
本质没什么太大区别,createNavigateOnClickListener里面一样还是会触发Navigation的find和navigate方法
这样就实现了最简单的点击跳转切换
如果需要增加args的能力,需要先引入对应safe-args-gradle插件
apply插件
applyplugin:'androidx.navigation.safeargs'
design界面支持直接声明类型,默认值
对应生成了代码
之后跳转之前,需要自己创建bundle,初始化并赋值
val bundle:Bundle =MainFragmentArgs.Builder().setUserName("xiaoming").
setAge(14).build().toBundle()
tv.setOnClickListener(Navigation.createNavigateOnClickListener
(R.id.action_mainFragment_to_secondFragment,bundle))
在接收方直接读取参数即可
可以在build目录下查看对应代码
本质上就是帮开发者实现了builder里的get/set方法