Skip to content

Latest commit

 

History

History
336 lines (268 loc) · 11.8 KB

README-en-2.0.md

File metadata and controls

336 lines (268 loc) · 11.8 KB

中文(Chinese)

Support

If you feel that my project is helpful to you, please help me to click on the star and let more people see it. Thank you!

Introduction

  Currently, App on the market almost has a navigation bar at the bottom, so we often need to use this during development. Although there are many tools on the github packaged bottom navigation bar, such as bottombar, alphaIndicator Swipe gradient bottom controls etc., but these controls are not particularly easy to use due to too many functions and no detailed documentation. Sometimes we just want a simple bottom navigation, but we don't want to go One by one in the layout of the LinearLayout or RadioGroup, and then change the tab icon, let ViewPager jump to the corresponding page and a series of tedious operations, this time, you can use BottomBarLayout, simply can achieve the following effect:

Apk

click to download

or scan the QR code

How to import

Add the jitpack repository address in allprojects{} in build.gradle in the project root directory, as follows:

    allprojects {
	    repositories {
	        jcenter()
	        maven { url 'https://jitpack.io' }//Add jitpack warehouse address
	    }
	}

Open the build.gradle in the app's module, add dependencies in dependencies {} as follows:

    dependencies {
	    compile 'com.github.chaychan:BottomBarLayout:2.1.0' //It is recommended to use the latest version
	}

The latest version can be viewed

https://github.com/chaychan/BottomBarLayout/releases

Demo

Display unread, show red dot, display message

Support to use lottie

Historical version update notes

Historical version update notes

Usage

Attribute introduction

        <!--Default icon-->
        <attr name="iconNormal" format="reference"/>

        <!--Selected icon-->
        <attr name="iconSelected" format="reference"/>

        <!--Bottom text-->
        <attr name="itemText" format="string"/>

        <!--Bottom text size-->
        <attr name="itemTextSize" format="dimension"/>

        <!--Default bottom text color-->
        <attr name="textColorNormal" format="color"/>

        <!--Selected bottom text color-->
        <attr name="textColorSelected" format="color"/>

        <!--The top of the text and icon-->
        <attr name="itemMarginTop" format="dimension"/>

        <!--Whether to open the touch background effect-->
        <attr name="openTouchBg" format="boolean"/>

        <!--Set touch background-->
        <attr name="touchDrawable" format="reference"/>

        <!--Set the width of the icon-->
        <attr name="iconWidth" format="dimension"/>

        <!--Set the height of the icon-->
        <attr name="iconHeight" format="dimension"/>

        <!--Set the padding of BottomBarItem-->
        <attr name="itemPadding" format="dimension"/>

        <!--Set unread font size-->
        <attr name="unreadTextSize" format="dimension"/>
 		<!--Set unread font color-->
        <attr name="unreadTextColor" format="reference"/>
        <!--Set unread font background-->
        <attr name="unreadTextBg" format="reference"/>

        <!--Set the message font size-->
        <attr name="msgTextSize" format="dimension"/>
		<!--Set the message font color-->
        <attr name="msgTextColor" format="reference"/>
        <!--Set the message font background-->
        <attr name="msgTextBg" format="reference"/>

        <!--Set the message prompt point background-->
        <attr name="notifyPointBg" format="reference"/>

        <!--Set the number of unread array thresholds greater than the threshold to be displayed as n + n as the set threshold-->
        <attr name="unreadThreshold" format="integer"/>

Configuration in the layout file

In the xml file, configure BottomBarLayout to wrap the sub-item BottomBarItem

   <?xml version="1.0" encoding="utf-8"?>
   <LinearLayout
       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"
       android:orientation="vertical"
   >

   <android.support.v4.view.ViewPager
       android:id="@+id/vp_content"
       android:layout_width="match_parent"
       android:layout_height="0dp"
       android:layout_weight="1"
       ></android.support.v4.view.ViewPager>

   <com.chaychan.library.BottomBarLayout
       android:id="@+id/bbl"
       android:layout_width="match_parent"
       android:layout_height="45dp"
       android:orientation="horizontal"
       android:gravity="center"
       android:layout_gravity="center"
       android:background="@color/tab_gb"
       >

       <com.chaychan.library.BottomBarItem
           android:layout_width="0dp"
           android:layout_weight="1"
           android:layout_height="match_parent"
           app:iconNormal="@mipmap/tab_home_normal"
           app:iconSelected="@mipmap/tab_home_selected"
           app:itemText="首页"
           app:textColorNormal="@color/tab_normal_color"
           app:textColorSelected="@color/tab_selected_color"
           app:itemTextSize="8sp"
           app:itemMarginTop="-5dp"
           />

       <com.chaychan.library.BottomBarItem
           android:layout_width="0dp"
           android:layout_weight="1"
           android:layout_height="match_parent"
           app:iconNormal="@mipmap/tab_video_normal"
           app:iconSelected="@mipmap/tab_video_selected"
           app:itemText="视频"
           app:textColorNormal="@color/tab_normal_color"
           app:textColorSelected="@color/tab_selected_color"
           app:itemTextSize="8sp"
           app:itemMarginTop="-5dp"
           />


       <com.chaychan.library.BottomBarItem
           android:layout_width="0dp"
           android:layout_weight="1"
           android:layout_height="match_parent"
           app:iconNormal="@mipmap/tab_micro_normal"
           app:iconSelected="@mipmap/tab_micro_selected"
           app:itemText="微头条"
           app:textColorNormal="@color/tab_normal_color"
           app:textColorSelected="@color/tab_selected_color"
           app:itemTextSize="8sp"
           app:itemMarginTop="-5dp"
           />

       <com.chaychan.library.BottomBarItem
           android:layout_width="0dp"
           android:layout_weight="1"
           android:layout_height="match_parent"
           app:iconNormal="@mipmap/tab_me_normal"
           app:iconSelected="@mipmap/tab_me_selected"
           app:itemText="我的"
           app:textColorNormal="@color/tab_normal_color"
           app:textColorSelected="@color/tab_selected_color"
           app:itemTextSize="8sp"
           app:itemMarginTop="-5dp"
           />

     </com.chaychan.library.BottomBarLayout>

   </LinearLayout>

Java file settings

Find the corresponding ViewPager and BottomBarLayout, set Adapter for ViewPager, and then set the ViewPager for BottomBarLayout

     mVpContent.setAdapter(new MyAdapter(getSupportFragmentManager()));
     mBottomBarLayout.setViewPager(mVpContent);

This realizes the bottom navigation bar function

Add item dynamically

     for (int i = 0; i < mTitleIds.length; i++) {
            //create item
            BottomBarItem item = createBottomBarItem(i);
            mBottomBarLayout.addItem(item); //addItem

            TabFragment homeFragment = createFragment(mTitleIds[i]);
            mFragmentList.add(homeFragment);
    }


	 private BottomBarItem createBottomBarItem(int i) {
        BottomBarItem item = new BottomBarItem.Builder(this)
                .titleTextSize(8)
                .titleNormalColor(R.color.tab_normal_color)
                .titleSelectedColor(R.color.tab_selected_color)
	//          .openTouchBg(false)
	//          .marginTop(5)
	//          .itemPadding(5)
	//          .unreadNumThreshold(99)
	//          .unreadTextColor(R.color.white)

                //There are still many properties, please see the methods in the Builder for details.
                .create(mNormalIconIds[i], mSelectedIconIds[i], getString(mTitleIds[i]));
        return item;
    }

Remove item

     mBottomBarLayout.removeItem(0);

Turn on the slide effect

Tab switch between the closure of the default sliding effect, if you need to open the setSmoothScroll () method can be called by calling BottomBarLayout:

    mBottomBarLayout.setSmoothScroll(true);

You can also specify BottomBarLayout's smoothScroll property to be true in the layout file.

The effect after opening is as follows:

Intercept before jump

    mBottomBarLayout.setOnPageChangeInterceptor(position -> {
        boolean isLogin = false; //Simulate no login
        if (position == TAB_POSITION_ME && !isLogin){
            //no login intercept  to other tab or to LoginActivity
            Toast.makeText(ViewPager2DemoActivity.this, "Test intercept, Login first please", Toast.LENGTH_SHORT).show();
            return true;
        }
        return false; 
  });

Set the item selected listener

  mBottomBarLayout.setOnItemSelectedListener((bottomBarItem, previousPosition, currentPosition) -> {
         //do something
  });

Display unread, show red dot, display message

    mBottomBarLayout.setUnread(0,20);//Set the first tab's unread 20
    mBottomBarLayout.setUnread(1,101);//Set the first tab's unread 101
    mBottomBarLayout.showNotify(2);//The third page shows the tips of the little red dot
    mBottomBarLayout.setMsg(3,"NEW");//The fourth tab shows the NEW text

When the setting of unread less than or equal to 0, the disappearance of small red dot will disappear; When the unread count is 1-99, the corresponding number is displayed. When unread more than 99, it shows 99+;

Set unaware reading threshold

   The unread threshold may specify the BottomBarItem's unreadThreshold property setting, which defaults to 99. For example, if app:unreadThreshold="999" is set, if the reading does not exceed this value, "999+" is displayed。

Hidden tips red dot, tips message

	mBottomBarLayout.hideNotify(2);//Hide the third page shows the tips of the little red dot
    mBottomBarLayout.hideMsg(3);//Hide the text displayed on the fourth tab

Set unread font color

   app:unreadTextColor="@color/unreadTextColor"

Set the unread background

    app:unreadTextBg="@drawable/shape_unread"

Drawable is written as follows:

    <?xml version="1.0" encoding="utf-8"?>
	<shape xmlns:android="http://schemas.android.com/apk/res/android">
	    <corners android:radius="20dp" />
	    <solid android:color="@color/red" />
	    <padding android:left="4dp" android:right="4dp" android:top="1dp" android:bottom="1dp"/>
	</shape>

Set prompt text font color, background

     app:msgTextColor="@color/msgTextColor"
     app:msgTextBg="@drawable/shape_msg"

Set prompt point background

	 app:notifyPointBg="@drawable/shape_notify_point"

Set the name of lottie file

	app:lottieJson="home.json"

"home.json" is stored in the assets directory. To set Lottie's width and height, use the iconWidth and iconHeight attributes

Well, here's the introduction of BottomBarLayout stop here, the reason for the package this control is mainly for the convenience of development, hope to help more people, if you have any ideas or comments may wish to put forward to me, I will continue to improve BottomBarLayout of.

Support and encouragement

If you think my project is helpful to you, star! So I will be more motivated to improve this project.