Android Navigation + Fragment 制作APP主页面导航(步骤 + 源码)
运行效果图
Navigation + Fragment制作APP主页面
前言
我相信你肯定见过这样的App主页面,底部或者顶部有多个按钮,点击之后会切换当前的页面,滑动当前页面也会切换底部按钮,这里我用几个App的主页面来说明一下吧
淘宝
微博
CSDN App
支付宝
可以说绝大部分App都是这种主页面布局模式,当然还有很多,在这里举列子是让你有一个概念而已。
那么来看看本文中实现的效果是怎么样的。如果不满意,我想也就不浪费你的时间了。
正文
从上面的一些APP主页面,在之前这种页面是通过什么来做的呢?这里有好几种组合:
① Activity + Fragment + TabLayout + ViewPager。
② Activity + Fragment + RadioGroup(RadioButton) + ViewPager。
相信你在很多的博客上或者自己的项目上看过或者使用过。而现在可以通过另一个更简洁的方式,那就是Activity+ Navigation + Fragment。虽然你看着只是少了一个控件而已,但实际上,大部分的工作都是由Navigation (导航)来完成。
说了这么多也该正式操作了,既然是写博客,自然要详细一些了,那么我们就从创建AS项目开始吧。这应该够详细了吧,首先创建一个名为AppHomeNavigation的项目。如下图所示,包名我就缩减了一下。
创建好之后如下图所示:
从这个图来看,项目本身没有任何问题,为了保险起见,建议先运行一下。
1. 添加依赖
Navigation 是JetPack中的组件,感兴趣可以去查看Google JetPack官方文档。而如果你想单独查看的Navigation 内容,可以点击Navigation 文档。
打开你的app下的build.gradle。在dependencies闭包中添加如下依赖:
def nav_version = "2.3.2"
// navigation依赖 ui 和 fragment
implementation "androidx.navigation:navigation-fragment:$nav_version"
implementation "androidx.navigation:navigation-ui:$nav_version"
添加位置如下图所示:
添加好之后,点击Sync进行项目同步,同步时会自动下载这些依赖库并配置到你的项目中。
添加完了依赖,就得先来简单介绍一下这个Navigation了,Navigation分为三大件:导航图、NavHost、NavController。
为了方便我介绍下面的三个概念,这里假设有A、B、C三个Fragment。
现在要从A切换到B
导航图:读取这个切换目标及路径
NavHost:包含A、B、C的容器,用于显示Fragment。
NavController:在得知切换目标时,控制NavHost去显示B这个Fragment。
这么一说,你是否有一些理解了呢?
2. 添加导航图
鼠标右键点击res → New → Android Resource File
然后会弹出一个窗体,在这个窗体里面设置文件名称,并选择文件类型,然后点击OK。
然后查看这个nav_graph.xml,你会发现有报错
不过先不用担心,因为这个里面是用来指向Fragment的,但是现在没有,那就创建。
然后先在com.llw.navigation下新建一个fragment包。
然后建一个Fragment类,这里命名我就用ABCDE来命名了,实际开发中是肯定不能这样的。
然后在layout新建一个布局fragment_b.xml
然后修改一下这个布局
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:gravity="center"
android:orientation="vertical">
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="A Fragment"
android:textColor="#000"
android:textSize="24sp" />
</LinearLayout>
布局有了,然后进入到AFragment中绑定这个布局的id。
public class AFragment extends Fragment {
@Nullable
@Override
public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
return inflater.inflate(R.layout.fragment_a, container, false);
}
}
那么这个AFragment就弄好了,同样按照上面的步骤创建BCDE的Fragment,这个重复的步骤我就不写了,因为有注水的涉嫌。
注意之前fragment_a.xml中我放了一个TextView用来表示这个是A,那么其他的xml中也要放置对应的BCDE,这样你切换的时候才能看到区别。
好了,下面可以打开这个nav_graph.xml进行Fragment的添加,在navigation标签下增加对AFragment的添加。
<!--AFragment-->
<fragment
android:id="@+id/afragment"
android:name="com.llw.navigation.fragment.AFragment"
android:label="afragment"
tools:layout="@layout/fragment_a" />
上面的也很简单,id表示它在导航图的标识,name指明这个Fragment的路径,包名+类名。label就是标签而已。layout就是绑定这个Fragment对应的布局。
这里你肯定回想,刚才不是在AFragment的onCreateView方法的返回中指明这这个布局吗?
那么这里又添加是为什么,因为你如果在导航图中指明了某一个Fragment的布局,那么在代码中就可以不用指明,也可以两者都指明,但至少要有一个地方指明,所以我这样写是可以的。为了让看的人更了解而已,虽然是多此一举。
那么这个nav_graph.xml的其他的Fragment也要添加,如下所示
<?xml version="1.0" encoding="utf-8"?>
<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">
<!--AFragment-->
<fragment
android:id="@+id/afragment"
android:name="com.llw.navigation.fragment.AFragment"
android:label="afragment"
tools:layout="@layout/fragment_a" />
<!--BFragment-->
<fragment
android:id="@+id/bfragment"
android:name="com.llw.navigation.fragment.BFragment"
android:label="bfragment"
tools:layout="@layout/fragment_b" />
<!--CFragment-->
<fragment
android:id="@+id/cfragment"
android:name="com.llw.navigation.fragment.CFragment"
android:label="cfragment"
tools:layout="@layout/fragment_c" />
<!--DFragment-->
<fragment
android:id="@+id/dfragment"
android:name="com.llw.navigation.fragment.DFragment"
android:label="dfragment"
tools:layout="@layout/fragment_d" />
<!--EFragment-->
<fragment
android:id="@+id/efragment"
android:name="com.llw.navigation.fragment.EFragment"
android:label="efragment"
tools:layout="@layout/fragment_e" />
</navigation>
然后你会发现还报错,那么你可以现在navigation标签中添加
tools:ignore="UnusedNavigation"
它就不报错了,这句话的意思是未使用导航的许可。因为我现在还没有使用这个nav_graph.xml所以要加上这一句话告诉AS,让它放心。等我们真正去使用时,是没有影响的,去不去掉都行。
3. 添加NavHost
这个在上面是介绍过的,它是用来装载和显示Fragment的,都知道Fragment是要依附在Activity上的,那么很明显这个NavHost也是要放在Activity中,那么下面打开activity_main.xml。修改代码如下:
<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout 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:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">
<!--NavHost-->
<fragment
android:id="@+id/nav_host_fragment"
android:name="androidx.navigation.fragment.NavHostFragment"
android:layout_width="match_parent"
android:layout_height="match_parent"
app:navGraph="@navigation/nav_graph" />
</androidx.constraintlayout.widget.ConstraintLayout>
可能这里你会比较陌生,这里的id,等下要在MainActivity中指明的,这里的name指明的是androidx.navigation.fragment.NavHostFragment,这个属性就表明这个fragment指明的就是NavHost,然后它还要添加需要显示的子Fragment,那么就通过navGraph来绑定这个导航图,之前导航图里面不是就有五个Fragment吗?所以这样NavHost的任务就完成了。
但是这时候又有一个问题,那就是我的这个NavHost初始显示哪一个Fragment,这一点Google的人也想到了,可以在导航图中指明。
打开nav_graph.xml。通过startDestination来指明启动Activity时显示的第一个Fragment。
app:startDestination="@id/afragment"
这里我指明了AFragment。那么值钱说到的三大件,就还差一个NavController。这个是用来控制NavHost显示Fragment,虽然我刚才在导航图nav_graph.xml中指明了第一个要显示的Fragment,但是它还缺少这个显示的动机,而这个动机由NavController来提供。
4. NavController控制显示Fragment
进入到MainActivity,在onCreate添加一句代码:
//获取navController
NavController navController = Navigation.findNavController(this, R.id.nav_host_fragment);
这时候你运行代码,然后你就会发现,显示了AFragment。
惊不惊喜意不意外?明明这个NavController还什么都没有做的,为什么就可以显示了呢?实际上它已经在工作了,只是你没有注意而已。
Navigation.findNavController(this, R.id.nav_host_fragment);
通过这一行代码这个工作开关就已经打开了,打开中读取导航图中第一个要显示Fragment,然后显示在NavHostFragment中。
5. Fragment之间跳转并传值
平时在实际的开发中常常会从一个Fragment跳转到另一个Fragment,并且带一些参数过去,之前这些跳转都是比较麻烦的,需要自己去写一些业务逻辑,而且还很容易出问题,让人谈之色变。但是在Navigation中,这个状况得到了很大的改善。
那么具体来看一下是怎么做的,比如我现在从AFragment跳转到BFragment。
下面就是见证骚操作的时候了。打开nav_graph.xml,修改AFragment。
<!--AFragment-->
<fragment
android:id="@+id/afragment"
android:name="com.llw.navigation.fragment.AFragment"
android:label="afragment"
tools:layout="@layout/fragment_a">
<!--添加动作-->
<action
android:id="@+id/action_afragment_to_bfragment"
app:destination="@id/bfragment"
app:enterAnim="@anim/nav_default_enter_anim"
app:exitAnim="@anim/nav_default_exit_anim" />
</fragment>
这里又多了一个新的action标签,表示动作,id的命名要规范,从这个命名来看就知道要从A跳转到B。然后就是destination属性,它指明一个跳转到的Fragment。enterAnim表示进入BFragment的动画,exitAnim表示退出BFragment的动画,这些都是Navgation中自带的。
现在动作写好了,那么下面就需要一个地方来触发这个动作,可以写一个简单的按钮来触发。
在fragment_a.xml中修改布局如下:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:gravity="center"
android:orientation="vertical">
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="A Fragment"
android:textColor="#000"
android:textSize="24sp" />
<Button
android:id="@+id/jumpBFragment"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="20dp"
android:text="跳转到 BFragment"
android:textAllCaps="false"
android:textSize="16sp" />
</LinearLayout>
然后进入到AFragment中,绑定id,增加点击事件。代码如下:
package com.llw.navigation.fragment;
import android.os.Bundle;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.Button;
import androidx.annotation.NonNull;
import androidx.annotation.Nullable;
import androidx.fragment.app.Fragment;
import androidx.navigation.NavController;
import androidx.navigation.Navigation;
import com.llw.navigation.R;
public class AFragment extends Fragment {
@Nullable
@Override
public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
return inflater.inflate(R.layout.fragment_a, container, false);
}
@Override
public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
super.onViewCreated(view, savedInstanceState);
Button jumpBFragment = view.findViewById(R.id.jumpBFragment);
jumpBFragment.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Navigation.findNavController(getView())
//导航
.navigate(R.id.action_afragment_to_bfragment);
}
});
}
}
这里唯一不好理解的就是navigate,表示导航的意思,这里面我传入了刚才定义在nav_graph.xml中的action的id。就表示这个导航将要执行这个actiion,那么它就会跳转到BFragment。运行一下
很明显,跳过去了,不过感觉还少了点什么,因为平常Fragment之间跳转时都会传递参数过去,那么这个也要传参数,而Navigation也提供了这个功能,可以通过Bundle进行传参。
所以只要简单的修改这个点击的方法就可以了。
jumpBFragment.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Bundle bundle = new Bundle();
bundle.putString("content","How are you?");
Navigation.findNavController(getView())
//导航
.navigate(R.id.action_afragment_to_bfragment,bundle);
}
});
这种Bundle传递参数我相信都不会陌生,那么在BFragment怎么去接收呢?
打开BFragment,修改代码如下:
package com.llw.navigation.fragment;
import android.os.Bundle;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.Toast;
import androidx.annotation.NonNull;
import androidx.annotation.Nullable;
import androidx.fragment.app.Fragment;
import com.llw.navigation.R;
public class BFragment extends Fragment {
@Nullable
@Override
public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
String content = getArguments().getString("content");
Toast.makeText(getActivity(),content,Toast.LENGTH_SHORT).show();
return inflater.inflate(R.layout.fragment_b, container, false);
}
}
这里通过
getArguments().getString("content");
来获取刚才放入Bundle里面的值,你以前可能没有见过这个方法,但是你只要把getArguments当成是getBundle()就好理解了,因为它实际上就是返回了一个Bundle。
然后看一下运行的效果吧。
可以看到是不是已经传递了传输过来,简单吧。
现在你会发现跳转是没有问题,但是回退呢?怎么回去呢?如果你这个时候在BFragment点击系统的返回键,你会发现直接退出当前应用了,因为这个时候Fragment还是属于MainActivity,那么它使用的就是Activity的返回栈,可当前只有一个Activity,所以它就退无可退,只能关闭应用,回到桌面了。为了解决这个问题,Navigation也提供了一个属性,在activity_main.xml中的的fragment中增加一个属性
app:defaultNavHost="true"
然后这个时候你再试一下,从A到B,然后点击系统返回键,就会返回到A,然后再点一下返回键就会退出当前应用。
神不神奇?app:defaultNavHost="true"表示这个回退栈由NavController来管理,当这个退无可退时才会调用Activity的回退栈。默认就是false,可以不加。
6. 添加底部导航
鼠标右键点击res → New → Android Resource File,然后选择Menu
之后打开menu.xml去添加子项。
<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto">
<item
android:id="@+id/afragment"
android:icon="@mipmap/ic_home"
android:title="首页" />
<item
android:id="@+id/bfragment"
android:icon="@mipmap/ic_category"
android:title="类别" />
<item
android:id="@+id/cfragment"
android:icon="@mipmap/ic_find"
android:title="发现" />
<item
android:id="@+id/dfragment"
android:icon="@mipmap/ic_msg"
android:title="消息" />
<item
android:id="@+id/efragment"
android:icon="@mipmap/ic_mine"
android:title="我的" />
</menu>
之前我是有5个Fragment,那么这里添加5个item,并且item的id要和之前导航图的fragment的id保持一致。这里面的图标其实很容易搞到。
ic_home.png
ic_category.png
ic_find.png
ic_msg.png
ic_mine.png
现在menu创建好了,那么可以在activity_main.xml中进行添加了。
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout 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:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">
<!--NavHost-->
<fragment
android:id="@+id/nav_host_fragment"
android:name="androidx.navigation.fragment.NavHostFragment"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:layout_above="@+id/bottom_navigation"
app:defaultNavHost="true"
app:navGraph="@navigation/nav_graph" />
<!--底部导航-->
<com.google.android.material.bottomnavigation.BottomNavigationView
android:id="@+id/bottom_navigation"
android:layout_width="match_parent"
android:layout_height="?attr/actionBarSize"
android:layout_alignParentBottom="true"
android:background="#FFF"
app:menu="@menu/menu" />
</RelativeLayout>
通过menu来指定导航栏的菜单,这样就把刚才的item都添加进去了
现在你通过预览已经可以看到这个底部导航栏了,不是吗?不过保险起见,我还是运行一手。
可以看到,底部的导航栏已经出来了,而且还可以点击,点击之后还有动画效果,并且图标和文字的颜色还有变化,因为实际上我只是放了灰色图标而已。那么这些工作就都是BottomNavigationView帮我们完成的,的确是省了不少事情,当然这个动画效果和点击之后的颜色都是可以让开发者自行改的。这是Google要做的UI统一,通过material来实现一些效果和动画。
7. 底部导航栏控制Fragment切换
在上面已经添加了底部导航栏,但是这个导航栏还没有和NavHost绑定起来,所以自然就无法在切换底部导航的同时,改变NavHost中的Fragment。进入到MainActivity。
public class MainActivity extends AppCompatActivity {
BottomNavigationView bottomNavigation;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
bottomNavigation = findViewById(R.id.bottom_navigation);
//获取navController
NavController navController = Navigation.findNavController(this, R.id.nav_host_fragment);
//通过setupWithNavController将底部导航和导航控制器进行绑定
NavigationUI.setupWithNavController(bottomNavigation,navController);
}
}
像这样绑定之后,你现在点击底部导航之后,NavController就会控制NavHost去显示相应的Fragment。
不过在运行之前把BFragment中接收参数并且弹Toast的代码删掉,否则切换的时候拿不到这个参数,就会ANR。
运行看看吧。
下面来改一下切换后的图标颜色和文字颜色吧。
右键点击drawable然后新建一个menu_item_selected.xml。
<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android">
<item android:color="#888888" android:state_checked="false" />
<item android:color="#1296DB" android:state_checked="true" />
</selector>
意思很简单,就是设置未选中和选中时的颜色。进入activity_mian.xml修改BottomNavigationView
<!--底部导航-->
<com.google.android.material.bottomnavigation.BottomNavigationView
android:id="@+id/bottom_navigation"
android:layout_width="match_parent"
android:layout_height="?attr/actionBarSize"
android:layout_alignParentBottom="true"
android:background="#FFF"
app:itemIconTint="@drawable/menu_item_selected"
app:itemTextColor="@drawable/menu_item_selected"
app:labelVisibilityMode="labeled"
app:menu="@menu/menu" />
app:itemIconTint="@drawable/menu_item_selected"
app:itemTextColor="@drawable/menu_item_selected"
可以看到itemIconTint和itemTextColor分别表示图标和文字,这里传入刚才传入的颜色样式。
app:labelVisibilityMode="labeled"
这个labeled表示一直显示标签文字,它还有三种模式,分别是auto、selected、unlabeled。
auto表示自动,默认就是这种模式,selected和auto差不多,unlabeled表示一直不显示标签文字。可以自行去尝试。
8. 运行效果图和源码
那么下面再运行一下吧。
可以看到现在有很多APP都是这样的效果。那么本篇文章要做的事情就做完了。
源码地址:AppHomeNavigation
总结
其实我这里没有做通过滑动Fragment来切换BottomNavigationView。如果要做的话,就要加ViewPager来控制Fragment,而不是NavHost来控制了,那样就脱离了这个文章的目的了。而且使用ViewPager的话就是相当于你把BottomNavigationView替换RadioButton或者TabLayout来使用,这种方式也有很多,我就过多的说明了,上高水长,后会有期~
本文地址:https://blog.csdn.net/qq_38436214/article/details/110876383