背景
Navigation组件是Android X 依赖库中的一个导航组件,它能接替管理多Fragment之间的关系及跳转行为,提供一个清晰可见的视图管理界面来管理整个视图树
功能组成
- Navigation Graph 【导航图定义】
- 作用:用来定义各个Fragment之间的跳转行为,
- image.png
- 上图表示每个Fragment均有自己的ID,同时通过红色箭头表示各个Fragment之间的跳转关系,让开发者清楚知道各个页面之间的关系,开发过程中可以通过Fragment的ID进行跳转
- 作用:用来定义各个Fragment之间的跳转行为,
- NavHostFragment 【导航承载容器】
- 作用:NavHostFragment持有一个FrameLayout,接下来Navigation Graph中的所有Fragment之间的切换都是在该容器内完成的
- NavController 【导航跳转控制器】
- 作用:NavHostFragment在管理页面时,将页面之间的控制行为转交给NavConroller进行处理,比如控制页面相互跳转,或者参数传递,页面返回处理等
功能准备阶段
-
导航视图的申明[Navigation Graph]
- 创建视图文件至指定目录下:
app/src/main/res/navigation/xxx_navigation.xml
- 创建视图根节点
<navigation
,通过app:startDestination="@+id/home_dest"
指定默认显示的根布局 - 创建视图子节点
<fragment
- 通过视图子节点的
<action
节点,定义下一个需要跳转的页面,配置页面跳转时的动画 - 通过视图子节点的
<argument
节点,定义当前父节点<fragment
所需要的参数类型,可以定义多个<argument
节点 - 通过视图子节点的
<deeplink
节点,申明外部可以通过deeplink协议直接跳转到当前<fragment
上,不需要额外过多的处理
- 通过视图子节点的
- 导航视图的整体节点图
<navigation <fragment <action <argument <deeplink
- 创建视图文件至指定目录下:
-
导航承载容器的申明[NavHostFragment]
- 在Activity的布局中,申明NavHostFragment,并关联 Navgation Graph,该视图树默认显示的页面是
<navgation
节点中的app:startDestination="@+id/home_dest"
对应的fragment
<fragment android:id="@+id/my_nav_host_fragment" android:name="androidx.navigation.fragment.NavHostFragment" android:layout_width="match_parent" android:layout_height="match_parent" app:defaultNavHost="true" app:navGraph="@navigation/mobile_navigation" />
- 在Activity的布局中,申明NavHostFragment,并关联 Navgation Graph,该视图树默认显示的页面是
基本功能
页面跳转 - 两种方式
- 通过 destinationId的方式跳转
- 定义
<fragment android:id="@+id/flow_step_one_dest" android:name="com.example.android.codelabs.navigation.FlowStepFragment" tools:layout="@layout/flow_step_one_fragment"/>
- 跳转逻辑
findNavController().navigate(R.id.flow_step_one_dest)
- 定义
- 通过 actionid的方式跳转
- 定义
<fragment <action android:id="@+id/next_action" app:destination="@+id/flow_step_one_dest" 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>
- 跳转逻辑
这时候会找到action对应的destinationid,然后再进行跳转
view.findViewById<Button>(R.id.navigate_action_button)?.setOnClickListener( Navigation.createNavigateOnClickListener(R.id.next_action, null) )
- 定义
参数传递 - 两种方式
- 代码传递
val bundle = Bundle() bundle.putString("name", "netease") findNavController().navigate(R.id.flow_step_one_dest, bundle)
- 通过布局文件的argument节点传递数据
- 布局文件
<navigation <fragment android:id="@+id/flow_step_two_dest"> <argument android:name="name" android:defaultValue="defaultName" app:argType="string" /> </fragment>
- 代码传递
val args = FlowStepFragmentArgs("netease") findNavController().navigate(R.id.flow_step_two_dest, args.toBundle())
- 布局文件
参数保存
- 通过ViewModel来保存数据
- 在Fragment.onDestoryView中,将数据保存至Arguments中
进阶使用
- deeplink打开指定页面,指定回退的页面
- 和ToolBar的联合使用
存在的坑
- 在进行页面切换时,需要保证切换前后的两个页面都在Navigation Graph中,否者无法获取NavController对象,导致页面切换失败
- fragment切换的实现是通过replace来完成的,也就是说会销毁视图,这里就需要我们自己手动对数据进行保存
网友评论