原创首发    
 Jetpack学习笔记之BottomNavigationBars (8)

BottomNavigationBars

底部导航栏不属于Jetpack库的范畴,但对于任何一个APP几乎都是不可缺少的。
BottomNavigationView是Google Material组件库中的一个组件,实现了底部导航栏的常用功能。
为了后续实战案例中,可以零基础入门,本节我们简单总结一下BottomNavigationView的知识点和使用方法。
BottomNavigationView设计原则
- 可以在底部展示3-5个导航菜单。Android中不超过5个
- 如果少于3个,可以使用tabs,超过5个,请使用navigation drawer。
- 每个导航菜单包括一个icon 和 一个 text label。
- icon 和 text label 都有 Inactive 和 active两种状态,应该使用颜色、高亮或非高亮对状态进行明显区分。
- 底部导航菜单一般导航到顶级页面,而tabs选项卡通常是页面中共享的同一个主题。
- icon 应该永远展示,text label可能会不显示,但是建议同时显示两者,特别是icon不能很好的代表顶级页面的含义时。
- icon 的右上角可以显示一个带有数字的badges徽章。
- 当滚动页面时,可以显示或隐藏BottomNavigationView,以展示更多空间。
- 页面切换时,建议使用淡入淡出动效,而不使用横向运动切换。
- BottomNavigationView的默认高度为56dp。
简单使用
新建一个使用kotlin 的androidX项目。
添加依赖:
implementation 'com.google.android.material:material:1.3.0-alpha03'
修改默认布局文件:
<?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">
    <TextView
        android:id="@+id/tv"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:gravity="center"
        android:text="@string/app_name"
        app:layout_constraintBottom_toTopOf="@+id/bottom_nav_bar"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintHorizontal_bias="0.0"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintVertical_bias="0.5" />
    <com.google.android.material.bottomnavigation.BottomNavigationView
        android:id="@+id/bottom_nav_bar"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_marginStart="0dp"
        android:layout_marginEnd="0dp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:menu="@menu/bottom_nav_menu" />
</androidx.constraintlayout.widget.ConstraintLayout>
BottomNavigationView 的menu属性即是定义菜单资源的:
bottom_nav_menu.xml 文件如下:
<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android">
    <item
        android:id="@+id/home"
        android:icon="@drawable/ic_home_24"
        android:title="@string/home" />
    <item
        android:id="@+id/photos"
        android:icon="@drawable/ic_photo_24"
        android:title="@string/photos" />
    <item
        android:id="@+id/mine"
        android:icon="@drawable/ic_mine_24"
        android:title="@string/mine" />
</menu>
设置切换监听
class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        setTv("首页")
        //等同:BottomNavigationView.OnNavigationItemSelectedListener 
        bottom_nav_bar.setOnNavigationItemSelectedListener {
            when (it.itemId) {
                R.id.home -> {
                    setTv("首页")
                    true
                }
                R.id.photos -> {
                    setTv("相册")
                    true
                }
                R.id.mine -> {
                    setTv("我的")
                    true
                }
                else -> false
            }
        }
    }
    private fun setTv(s: String) {
        setTitle(s)
        tv.text = s
    }
}
甚至不需要写任何代码,我们就完成了最简单示例。
其它属性的设置可以参考:https://material.io/develop/android/components/bottom-navigation
和架构组件一起使用
上面的示例太过简单了,一般BottomNavigationView会和其它架构组件一起,菜单切换时加载指定的Fragment页面或Navigation UI。
我们新建一个项目,File-->New-->New Project,
在Phone and Table中选择Bottom Navigation Activity模板。
即会创建一个最基本的底部导航栏框架。
代码也非常简单,我已经上传到gitee上了。
PS:
如果你看了之前Jetpack的所有学习笔记,应该对Jetpack 和 Kotlin 会有一个简单的了解。
后续系列的文章,我都会先引入一个简单示例,然后结合实战讲解了。























