diff --git a/README-en.md b/README-en.md new file mode 100644 index 0000000000000000000000000000000000000000..1549f503123feabe3fd7645d619ad789a76ec393 --- /dev/null +++ b/README-en.md @@ -0,0 +1,254 @@ +[中文(Chinese)](https://github.com/chaychan/BottomBarLayout) + +### 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: + +### Demo + +![](./intro_img/display1.gif) + +#### Display unread, show red dot, display message + +![](./intro_img/4.png) + +### V1.1.1 update instructions(2018-02-27) + +- Repair must be set up ViewPager problems, can be modified to set or not set; + +- Modify the click callback, callback more than a previousPosition (last page location) + +- Add two usage patterns + + +### V1.0.7 update instructions(2018-01-05) + +- Increase the threshold for unreadable attributes and set the properties for smooth transitions; + +- Remove oriention restrictions。 + +### V1.0.6 update instructions(2017-12-19) + +- Add slide listener, callback onItemSelected () + +### V1.0.4 update instructions(2017-10-10) + +- Increase the number of unread, tips red dot, suggesting the function of the message + +### Usage + +#### Attribute introduction + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +#### Configuration in the layout file + +In the xml file, configure BottomBarLayout to wrap the sub-item BottomBarItem + + + + + + + + + + + + + + + + + + + + + + +#### 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 + +#### 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: + +![](./intro_img/display2.gif) + +#### Set the item selected listener + + mBottomBarLayout.setOnItemSelectedListener(new BottomBarLayout.OnItemSelectedListener() { + @Override + public void onItemSelected(final BottomBarItem bottomBarItem, int position) { + //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 + + +#### **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:1.1.1' //It is recommended to use the latest version + } + + +The latest version can be viewed + +[https://github.com/chaychan/BottomBarLayout/releases](https://github.com/chaychan/BottomBarLayout/releases) + + +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: + + diff --git a/README.md b/README.md index f02afdb43fb11739116ebfb6ab75201c878d4cc8..762df44bd5f858f96ab23ccafd57cdb232cfdfc0 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,11 @@ +[英文(English)](https://github.com/chaychan/BottomBarLayout/blob/master/README-en.md) + ### 轻量级的底部导航栏   目前市场上的App,几乎都有底部页签导航栏,所以我们在开发的时候经常需要用到这个,虽然github上有不少已经封装好的底部导航栏的工具,例如bottombar,alphaIndicator(仿微信滑动渐变底部控件)等,但是这些控件由于功能太多,而且也没有给予详细的介绍文档,所以用起来不是特别容易,有时候我们仅仅只是想要一个简简单单的底部导航,但是又不想去自己在布局中搞一个个LinearLayout或者RadioGroup,然后切换页签的时候更换图标,让ViewPager跳转到对应的页面等一系列繁琐的操作,这时候,你可以使用BottomBarLayout,简简单单就可以实现以下效果: ![](./intro_img/display1.gif) -####显示未读数、提示小红点、提示消息 +#### 显示未读数、提示小红点、提示消息 ![](./intro_img/4.png) @@ -186,7 +188,7 @@ #### 显示未读数、提示小红点、提示消息 mBottomBarLayout.setUnread(0,20);//设置第一个页签的未读数为20 - mBottomBarLayout.setUnread(1,101);//设置第二个页签的未读书 + mBottomBarLayout.setUnread(1,101);//设置第二个页签的未读数 mBottomBarLayout.showNotify(2);//设置第三个页签显示提示的小红点 mBottomBarLayout.setMsg(3,"NEW");//设置第四个页签显示NEW提示文字