——沉默不是因为词穷,而是因为心空。现实有多残酷,你就应该有多坚强。
前言
一、简介
(1)是什么
(2)有什么用
(3)有什么优点
二、基本使用
(1)添加依赖
(4)代码实现导航功能
三、组件分析
四、进阶
五、内容推荐
——这篇主要是梳理一下Jetpack架构组件之一的Navigation,并结合楼主所学做个总结。面向那些还没接触Navigation的同学们。看完这篇可以快速了解它,并轻松使用。也想请教前辈们指点文章中的错误或不足的地方。本篇只描述Navigation,不会拓展额外的知识,若想了解更多关于Jetpack组件知识可以看楼主写的Jetpack专栏。
——是Android Jetpack 中的导航组件,支持用户导航、进入和退出应用中不同内容片段的交互。
这是文档给的说法,描述简单。却不易理解,唯有使用过该组件的方可理解其深刻含义。
这里就不强行解释,待浏览完该文章再细品。
——Android Jetpack 的导航组件可帮助您实现导航,无论是简单的按钮点击,还是应用栏和抽屉式导航栏等更为复杂的模式。
dependencies {
def nav_version = "2.1.0"
// Java language implementation
implementation "androidx.navigation:navigation-fragment:$nav_version"
implementation "androidx.navigation:navigation-ui:$nav_version"
// Kotlin
implementation "androidx.navigation:navigation-fragment-ktx:$nav_version"
implementation "androidx.navigation:navigation-ui-ktx:$nav_version"
}
1.右击res—New>Android Resource File
2.定义名称与资源类型 Resource type =Navigation
这边定义login_navigation.xml文件如下。具体如何使用请参考官方文档。
可以通过视图清楚的查看Fragment之间的关系。
要使用navigation视图,需要在Activity布局中添加NavHost。NavHost也可以称为navigation的宿主。
使用如下:activity_splash.xml (app:navGraph="@navigation/login_navigation")
下面使用kotlin:
SplashFragment ——> LoginFragment :
findNavController().navigate(R.id.action_splashFragment_to_loginFragment)
LoginFragment ——> RegisterFragment:
findNavController().navigate(R.id.action_loginFragment_to_registerFragment)
RegisterFragment ——> LoginFragment : 返回
findNavController().popBackStack()
通过finNavController()可以在Fragment中自由切换。
最后会实现如下效果。
下面具体分析如何使用该导航组件
该导航组件由以下三个关键部分组成:Navigation、NavHost、NavController
(1)Navigation:在一个集中位置包含所有导航相关信息的 XML 资源。这包括应用内所有单个内容区域(称为目标)以及用户可以通过应用获取的可能路径
(2)NavHost:显示导航图中目标的空白容器。导航组件包含一个默认 NavHost 实现 (NavHostFragment),可显示 Fragment 目标
(3)NavController:在 NavHost 中管理应用导航的对象。当用户在整个应用中移动时,NavController 会安排 NavHost 中目标内容的交换
通过上面的例子:
Navigation实际上就是指navigation文件下的xml文件。
NavHost就是容纳navigation的容器。如下面的例子
NavController则是控制Fragment之间的跳转与切换
Kotlin:
Fragment.findNavController()
View.findNavController()
Activity.findNavController(viewId: Int)
Java:
NavHostFragment.findNavController(Fragment)
Navigation.findNavController(Activity, @IdRes int viewId)
Navigation.findNavController(View)
通过上面方法获取到NavController对象,并调用 navigate() 的某个重载,以在各个目的地之间导航
——Navigation 支持您通过定义目的地参数将数据附加到导航操作,可通过以下方式传递参数:
1.定义目的地参数
2.使用 Safe Args 传递安全的数据
Navigation 组件具有一个名为 Safe Args 的 Gradle 插件,该插件可以生成简单的 object 和 builder 类,以便以类型安全的方式浏览和访问任何关联的参数。我们强烈建议您将 Safe Args 用于导航和数据传递,因为它可以确保类型安全。
//添加依赖
buildscript {
repositories {
google()
}
dependencies {
def nav_version = "2.1.0"
classpath "androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version"
}
}
apply plugin: "androidx.navigation.safeargs"
apply plugin: "androidx.navigation.safeargs.kotlin"
//传递参数
@Override
public void onClick(View view) {
EditText amountTv = (EditText) getView().findViewById(R.id.editTextAmount);
int amount = Integer.parseInt(amountTv.getText().toString());
ConfirmationAction action =
SpecifyAmountFragmentDirections.confirmationAction()
action.setAmount(amount)
Navigation.findNavController(view).navigate(action);
}
//接收参数方法
@Override
public void onViewCreated(View view, @Nullable Bundle savedInstanceState) {
TextView tv = view.findViewById(R.id.textViewAmount);
int amount = ConfirmationFragmentArgs.fromBundle(getArguments()).getAmount();
tv.setText(amount + "")
}
3.使用 Bundle 对象在目的地之间传递参数
//传递参数
Bundle bundle = new Bundle();
bundle.putString("amount", amount);
Navigation.findNavController(view).navigate(R.id.confirmationAction, bundle);
//接收参数
TextView tv = view.findViewById(R.id.textViewAmount);
tv.setText(getArguments().getString("amount"));
4.将数据传递给起始目的地
您可以将数据传递给应用的起始目的地。首先,您必须显式构建一个 Bundle 来存储数据。然后,使用以下方法之一将该 Bundle 传递给起始目的地:
如果您要以编程方式创建 NavHost,请调用 NavHostFragment.create(R.navigation.graph, args),其中 args 是存储数据的 Bundle。
或者,您也可以通过调用以下 NavController.setGraph() 过载之一来设置起始目的地参数:
使用图表 ID:navController.setGraph(R.navigation.graph, args)
使用图表本身:navController.setGraph(navGraph, args)
要检索起始目的地中的数据,请调用 Fragment.getArguments()。
——navigation标签中再嵌入navigation
//跳转方法
view.findNavController().navigate(R.id.action_mainFragment_to_sendMoneyGraph)
——通过
...
—— 对于应用中的任何可通过多条路径到达的目的地,都应定义可转到它的相应全局操作
创建全局操作
...
使用全局操作
view.findNavController().navigate(R.id.action_global_mainFragment)
——借助 Navigation 组件,可以同时向操作添加属性动画和视图动画
——在目的地之间添加共享元素过渡效果
除了过渡动画之外,Navigation 组件还支持在目的地之间添加共享元素过渡效果。共享元素过渡以编程方式提供,而不是通过您的导航 XML 文件提供,因为它们需要引用您想要添加到共享元素过渡中的 View 实例
——Fragment 目的地共享元素过渡
借助 FragmentNavigator.Extras 类,您可以将共享元素附加到对 Fragment 目的地的 navigate() 调用
FragmentNavigator.Extras extras = new FragmentNavigator.Extras.Builder()
.addSharedElement(imageView, "header_image")
.addSharedElement(titleView, "header_title")
.build();
Navigation.findNavController(view).navigate(R.id.details,
null, // Bundle of args
null, // NavOptions
extras);
——Activity 目的地共享元素过渡
Activity 依靠 ActivityOptionsCompat 来控制共享元素过渡(启动具有一个共享元素的 Activity 文档对此进行了详细介绍)
ActivityOptions options = ActivityOptions.makeSceneTransitionAnimation(this,
Pair.create(imageView, "header_image"),
Pair.create(titleView, "header_title"));
ActivityNavigator.Extras extras = new ActivityNavigator.Extras.Builder()
.setActivityOptions(options)
.build();
Navigation.findNavController(view).navigate(R.id.details,
null, // Bundle of args
null, // NavOptions
extras);
——将弹出动画应用于 Activity 过渡
@Override
public void finish() {
super.finish();
ActivityNavigator.applyPopAnimationsToPendingTransition(this);
}
若您发现文章中存在错误或不足的地方,希望您能指出!