BottomNavigationView--基本使用总结
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 选项卡中导入。导入方式,参考下图:
(2)主要属性及方法
- android:background
整个BottomNavigationView 的背景色,设置背景色之后,切换选项时依旧会有水波纹效果(设置背景色也是为了将底部导航和上方的内容进行分割区分)
- app:itemBackground
条目的背景色。设置之后在切换选项时将无法看到水波纹效果
- app:itemIconTint
条目图标的颜色。可以是单一颜色,也可以是颜色selector。通常建议设置selector,当未选中时指定一种颜色,选中时再指定另一种颜色。该selector 定义在 res -- color 目录下。(未设置该属性时,默认未选中状态为深灰色,选中状态时的颜色为当前主题的 colorPrimary 颜色)
- itemTextColor
条目文本的颜色。可以是单一颜色,也可以是颜色selector。通常建议设置selector,当未选中时指定一种颜色,选中时再指定另一种颜色。该selector 定义在 res -- color 目录下。未设置该属性时,默认未选中状态为深灰色,选中状态时的颜色为当前主题的 colorPrimary 颜色)
- app:menu
当前BottomNavigationView 所引用的menu 菜单。
- setOnNavigationItemSelectedListener()
设置导航条目被选中时的监听器
- getMenu( )
获取当前BottomNavigationView 中所引用的 menu 菜单对象
3、详细示例代码:
最终实现效果:
BottomNavigationView.gif
- BottomNavigationViewActivity.java
/**
* 作者: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);
}
}
- activity_bottom_navigation.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"
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>
- menu_bottom_navigation.xml
<?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>
- selector_bnv.xml
<?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、总结
-
(1)BottomNavigationView 整体实现比较简单,但是扩展性不强。比如,想在某个条目的右上角加上小红点,这就行不通了。。。
-
(2)没有提供直接选中某项的方法,默认选中第一项。如果想更改默认选中,就需要通过getMenu( ) 方法获取menu 对象,然后获取其中的具体 item,最后再调用item 的 setChecked(true)
-
(3) 总的条目数量不能超过5个。当条目数量小于等于三个时,能将条目的图标和title 完全展示出来。如果大于3个小于等于5个,则只有被选中的条目才能同时展示图标和title,未被选中的条目只展示图标。
-
(4)创建 menu 菜单的时候,没必要手写,可以切换到design模式下,直接拖拽,然后再最右侧更改属性即可,大致如下图: