BottomNavigationBar跳坑小记

陈想Develop

BottomNavigationBar下载地址:

https://github.com/Ashok-Varma/BottomNavigation

在app的build.gradle中添加依赖

compile 'com.ashokvarma.android:bottom-navigation-bar:1.2.0'

导入Library会遇到的问题

问题 1: Error:(16, 0) Could not find property 'APP_VERSION_NAME' on project ':bottom-navigation-bar'. 
解决方案:
    复制下面的代码到Project的gradle.properties中

    ANDROID_BUILD_SDK_VERSION=23
    ANDROID_BUILD_TOOLS_VERSION=23.0.3
    ANDROID_BUILD_TARGET_SDK_VERSION=23
    ANDROID_BUILD_MIN_SDK_VERSION=14    
    APP_VERSION_NAME = 1.3.0
    APP_VERSION_CODE = 6    
    ANDROID_SUPPORT_LIBRARY_VERSION = 23.4.0
    ANDROID_PLAY_SERVICES_VERSION = 8.4.0

问题 2: Error:(2, 0) Plugin with id 'com.github.dcendents.android-maven' not found .
解决方案:
    复制下面的代码到Project的build.gradle中
    buildscript {
        repositories {
            jcenter()
        }
        dependencies {
            classpath 'com.android.tools.build:gradle:1.+'
            classpath 'org.codehaus.groovy:groovy-backports-compat23:2.3.5'
            classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.0'
            classpath 'com.github.dcendents:android-maven-plugin:1.2'
        }
    }
问题 3: Error:Cause: org/gradle/api/publication/maven/internal/DefaultMavenFactory
解决方案:
    替换代码
    当你使用的Gradle版本是2.4以上，Android插件版本是1.3.0以上的时候就会出现这个问题.这时候你只需将
    android-maven-gradle-plugin插件版本改为classpath ‘com.github.dcendents:android-maven-gradle-plugin:1.3’即可

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">

    <com.ashokvarma.bottomnavigation.BottomNavigationBar
        android:id="@+id/bottom_navigation_bar"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_gravity="bottom"/>

</LinearLayout>

Activity中添加BottomNavigationBar

BottomNavigationBar bottomNavigationBar = (BottomNavigationBar) findViewById(R.id.bottom_navigation_bar);

BottomNavigationBar添加Item,设置选中的Item,初始化

bottomNavigationBar
    .addItem(new BottomNavigationItem(R.mipmap.ic_launcher, "Books"))
    .addItem(new BottomNavigationItem(R.mipmap.ic_launcher, "Music"))
    .addItem(new BottomNavigationItem(R.mipmap.ic_launcher, "Movie"))
    .addItem(new BottomNavigationItem(R.mipmap.ic_launcher, "Games"))
    .setFirstSelectedPosition(0)
    .initialise();

BottomNavigationBar的切换事件监听

 bottomNavigationBar.setTabSelectedListener(new BottomNavigationBar.OnTabSelectedListener() {

        /*
         *点击Item时调用此方法  
         */
        @Override
        public void onTabSelected(int position) {

        }

        /*
         *对没有选中的Item进行处理的方法,
         */
        @Override
        public void onTabUnselected(int position) {

        }

        /*
         *当被选中的Item 再一次被点击时调用此方法
         */
        @Override
        public void onTabReselected(int position) {

        }
    });

设置BottomNavigationBar

1.Mode
    xml：bnbMode
    mothod：setMode()

    MODE_DEFAULT:
        如果Item的个数<=3就会使用MODE_FIXED模式，否则使用MODE_SHIFTING模式
    MODE_FIXED:
        填充模式，未选中的Item会显示文字，没有移位动画。
    MODE_SHIFTING:
        移位模式，未选中的Item不会显示文字，选中的会显示文字。在切换的时候会有一个像移位的动画
2.BackgroundStyle
    xml: bnbBackgroundStyle
    mothod：setBackgroundStyles()

    BACKGROUND_STYLE_DEFAULT
        如果设置的Mode为MODE_FIXED，将使用BACKGROUND_STYLE_STATIC 。如果Mode为MODE_SHIFTING将使用BACKGROUND_STYLE_RIPPLE。

    BACKGROUND_STYLE_STATIC
        点击的时候没有水波纹效果

    BACKGROUND_STYLE_RIPPLE
        点击的时候有水波纹效果

设置默认颜色

xml：bnbActiveColor, bnbInactiveColor, bnbBackgroundColor
方法：setActiveColor, setInActiveColor, setBarBackgroundColor

例:
    bottomNavigationBar
      .setActiveColor(R.color.primary)
      .setInActiveColor("#FFFFFF")
      .setBarBackgroundColor("#ECECEC")
注:

    1. in-active color
        表示未选中Item中的图标和文本颜色。默认为 Color.LTGRAY

    2. active color :
        在BACKGROUND_STYLE_STATIC下，表示选中Item的图标和文本颜色。BACKGROUND_STYLE_RIPPLE下，表示整个容器的背景色。默认Theme's Primary Color
    3.background color :
        在BACKGROUND_STYLE_STATIC下，表示整个容器的背景色。而在BACKGROUND_STYLE_RIPPLE下，表示选中Item的图标和文本颜色。默认 Color.WHITE

订制Item未选中颜色

我们可以为每个Item设置选中未选中的颜色，如果没有设置，将继承BottomNavigationBar设置的选中未选中颜色。
mothod：
    BottomNavigationItem.setInActiveColor() 设置Item未选中颜色方法
    BottomNavigationItem.setActiveColor() 设置Item选中颜色方法

Icon的定制

如果使用颜色的变化不足以展示一个选项Item的选中与非选中状态，可以使用BottomNavigationItem.setInActiveIcon()方法来设置。
例：
    //这里表示选中的图片
    new BottomNavigationItem(R.mipmap.ic_launcher, "books")
    //非选中的图片
    .setInactiveIcon(ContextCompat.getDrawab(this,R.mipmap.ic_launcher)))

设置自动隐藏与显示

如果BottomNavigationBar是在CoordinatorLayout布局里，默认设置当向下滑动时会自动隐藏它，当向上滑动时会自动显示它。我们可以通过setAutoHideEnabled(boolean)设置是否允许这种行为,好像这个方法木有啦。

手动隐藏与显示

bottomNavigationBar.hide();//隐藏
bottomNavigationBar.hide(true);//隐藏是否启动动画，这里并不能自定义动画
bottomNavigationBar.unHide();//显示
bottomNavigationBar.hide(true);//隐藏是否启动动画，这里并不能自定义动画

为Item添加Badge(角标)

1. 创建一个BadgeItem
    badge=new BadgeItem()
        .setBorderWidth(2)//Badge的Border(边界)宽度
        .setBorderColor("#FF0000")//Badge的Border颜色
        .setBackgroundColor("#9ACD32")//Badge背景颜色
        .setGravity(Gravity.RIGHT| Gravity.TOP)//位置，默认右上角
        .setText("2")//显示的文本
        .setTextColor("#F0F8FF")//文本颜色
        .setAnimationDuration(2000)
        .setHideOnSelect(true)//当选中状态时消失，非选中状态显示

2. 为BottomNavigationItem设置BadgeItem
    BottomNavigationItem(R.mipmap.ic_launcher, "books").setBadgeItem(badge);