MDAndroid进阶之旅Android

BottomNavigationView--基本使用总结

2017-04-12  本文已影响3016人  CnPeng

1、BottomNavigationView 是什么?

BottomNavigationView 是安卓官方提供的底部导航栏,能够方便的实现下图中的底部导航效果。

Paste_Image.png

按照 官方的设计规范 https://material.io/guidelines/components/bottom-navigation.html# 当底部导航的标签在 3--5 个之间的时候(含3、5), 可以使用BottomNavigationView 。

当导航标签少于3个的时候,也可以使用,不会报错,但实际项目中一般不会有少于三个的;如果导航标签超过5个,在使用BottomNavigationView 时在运行期会报错,错误信息如下:
java.lang.IllegalArgumentException: Maximum number of items supported by BottomNavigationView is 5. Limit can be checked with BottomNavigationView#getMaxItemCount()。意思是说,最多不能超过 5 个条目!

2、BottomNavigationView的使用前提及相关属性

(1)、使用前提

BottomNavigationView是放置在design包中的,所以,使用前需要先引入com.android.support:design:25.1.0包,引入方式有两种,一种是直接从当前module的 gradle 文件中编辑,一种是从Project Structure 界面的 dependences 选项卡中导入。导入方式,参考下图:

直接从当前Module的gradle文件中编辑.png 从Project Structure 界面的 dependences 选项卡中导入.png

(2)主要属性及方法

整个BottomNavigationView 的背景色,设置背景色之后,切换选项时依旧会有水波纹效果(设置背景色也是为了将底部导航和上方的内容进行分割区分)

条目的背景色。设置之后在切换选项时将无法看到水波纹效果

条目图标的颜色。可以是单一颜色,也可以是颜色selector。通常建议设置selector,当未选中时指定一种颜色,选中时再指定另一种颜色。该selector 定义在 res -- color 目录下。(未设置该属性时,默认未选中状态为深灰色,选中状态时的颜色为当前主题的 colorPrimary 颜色)

条目文本的颜色。可以是单一颜色,也可以是颜色selector。通常建议设置selector,当未选中时指定一种颜色,选中时再指定另一种颜色。该selector 定义在 res -- color 目录下。未设置该属性时,默认未选中状态为深灰色,选中状态时的颜色为当前主题的 colorPrimary 颜色)

当前BottomNavigationView 所引用的menu 菜单。

设置导航条目被选中时的监听器

获取当前BottomNavigationView 中所引用的 menu 菜单对象

3、详细示例代码:

最终实现效果:


BottomNavigationView.gif
/**
 * 作者:CnPeng
 * <p>
 * 时间:2017/4/11:下午8:32
 * <p>
 * 说明:安卓原生底部导航栏 BottomNavigationView 的基本使用示例
 * <p>
 * 使用时需要先引入 design 包
 * <p>
 * 底部Item的数量不能超过5 ,否则会报错,报错信息如下: java.lang.IllegalArgumentException: Maximum number of items supported by
 * BottomNavigationView is 5. Limit can be checked with BottomNavigationView#getMaxItemCount()
 * <p>
 * 当item超过3个时,未被选中的item 只显示图标,只有被选中的才会显示图标和文字;而3个及3个以内时图标和文字都会显示
 * <p>
 * 如果底部Item 想实现小红点,就无法使用BottomNavigationView 了 。/(ㄒoㄒ)/~~
 */

public class BottomNavigationViewActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_bottom_navigation_view);

        final TextView tv_whichItemSelected = (TextView) findViewById(R.id.tv_whichItemSelected);

        BottomNavigationView bnv_001 = (BottomNavigationView) findViewById(R.id.bnv_001);

        //为底部导航设置条目选中监听
        bnv_001.setOnNavigationItemSelectedListener(new BottomNavigationView.OnNavigationItemSelectedListener() {
            @Override
            public boolean onNavigationItemSelected(
                    @NonNull
                            MenuItem item) {
                switch (item.getItemId()) {
                    case R.id.item1:
                        tv_whichItemSelected.setText(item.getTitle());
                        break;
                    case R.id.item2:
                        tv_whichItemSelected.setText(item.getTitle());
                        break;
                    case R.id.item3:
                        tv_whichItemSelected.setText(item.getTitle());
                        break;
                    case R.id.item4:
                        tv_whichItemSelected.setText(item.getTitle());
                        break;
                    case R.id.item5:
                        tv_whichItemSelected.setText(item.getTitle());
                        break;
                }
                
                return true;    //这里返回true,表示事件已经被处理。如果返回false,为了达到条目选中效果,还需要下面的代码 
                // item.setChecked(true);  不论点击了哪一个,都手动设置为选中状态true(该控件并没有默认实现)
                // 。如果不设置,只有第一个menu展示的时候是选中状态,其他的即便被点击选中了,图标和文字也不会做任何更改

            }
        });

        //默认选中底部导航栏中的第三个
        bnv_001.getMenu().getItem(2).setChecked(true);
    }
}
<?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"
                android:layout_width="match_parent"
                android:layout_height="match_parent">

    <TextView
        android:id="@+id/tv_whichItemSelected"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"/>
    <!--
    itemBackground  item的背景  ,设置之后将无法看到默认的水波纹效果
    itemIconTint    item图标的颜色,可以是固定值,可以是 颜色selector(定义在 res —— color 目录)
    itemTextColor   item文字的颜色,可以是固定值,可以是 颜色selector
    
    如果不设置itemIconTint和 itemTextColor的时候,当某一个item被选中,选中时图标和文字的颜色是 当前主题的 colorPrimary 颜色
  
    background    整个底部导航的背景色,设置之后,在切换被选中的item时依旧具有水波纹效果。(设置background 也是为了能够明显的区分底部导航和上方的具体内容)
    -->
    <android.support.design.widget.BottomNavigationView
        android:id="@+id/bnv_001"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_alignParentBottom="true"
        android:background="@color/e7e7e6"
        app:itemIconTint="@color/selectot_bnv"
        app:itemTextColor="@color/selectot_bnv"
        app:menu="@menu/menu_bottom_navigation"/>


</RelativeLayout>
<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android">

    <item android:id="@+id/item1"
          android:icon="@drawable/hot_green"
          android:title="Item1"/>
    <item android:id="@+id/item2"
          android:icon="?android:attr/actionModeShareDrawable"
          android:title="Item2"/>
    <item android:id="@+id/item3"
          android:icon="@drawable/act_attentioned"
          android:title="Item3"/>
    <item android:id="@+id/item4"
          android:icon="@android:drawable/btn_star_big_off"
          android:title="Item4"/>
    <item android:id="@+id/item5"
          android:icon="@drawable/mainfocus"
          android:title="Item5"/>

</menu>
<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:color="#f4b733" android:state_checked="true"></item>
    <item android:color="#666565"></item>
</selector>

4、总结

Paste_Image.png

参考:
http://codpoe.me/2016/10/27/bottom_navigation_view/

上一篇下一篇

猜你喜欢

热点阅读