Skip to content

Latest commit

 

History

History
303 lines (214 loc) · 10 KB

README_ZH.md

File metadata and controls

303 lines (214 loc) · 10 KB
Raw

BottomNavigationViewEx

一个增强BottomNavigationView的安卓库。

MIT License api 9+

捐赠者

信息 金额
Linsong Wang 100$

功能

methods description
enableAnimation 开启或关闭点击动画(文字放大效果和图片移动效果)。 默认为 true.
enableItemShiftingMode 开始或关闭子菜单位移模式。 如果为 true，除了当前选中项，其他项的文本将会隐藏。 当菜单数大于3时，默认为 true。
enableShiftingMode 开始或关闭导航条位移模式。如果为 true，选中项和其他项的宽度不一样。当菜单数大于3时，默认为 true。
getBottomNavigationItemView 获取位于 position 的私有成员变量 mButton。
getBottomNavigationItemViews 获取私有成员变量 mButtons。
getCurrentItem 获取当前选中项的索引。
getIconAt 获取位于 position 的图片。
getItemCount 获取子项个数。
getItemHeight 获取菜单高度。
getLargeLabelAt 获取位于 position 的大标签. 每个子项包含两个标签，一个大的，一个小的。
getSmallLabelAt 获取位于 position 的小标签. 每个子项包含两个标签，一个大的，一个小的。
getMenuItemPosition 获取子菜单的索引。如果找不到，返回 -1。
getOnNavigationItemSelectedListener 获取 OnNavigationItemSelectedListener。
setCurrentItem 设置当前选中项。
setIconMarginTop 设置 icon 的 MarginTop，用于调节图标垂直位置。
setIconSize 设置所有的子项图标大小。
setIconSizeAt 设置位于 position 的图标的大小。
setIconsMarginTop 设置所有 icon 的 MarginTop，用于调节图标垂直位置。
setIconTintList 设置图片的渲染颜色列表(Selector)
setIconVisibility 设置图片可见性。
setItemBackground 设置子项的背景。
setItemHeight 设置子项高度。
setLargeTextSize 设置所有子项的大标签文本大小。每个子项有两个标签，一个大的，一个小的。当子项未选中时，显示小标签；选中时，显示大标签。
setSmallTextSize 设置所有子项的小标签文本大小。每个子项有两个标签，一个大的，一个小的。当子项未选中时，显示小标签；选中时，显示大标签。
setTextSize 设置所有子项的大和小标签文本大小。
setTextTintList 设置子项 TextView 的颜色。
setTextVisibility 设置文本可见性。
setTypeface 设置所有子项的 TextView 字体
setupWithViewPager 和 ViewPager 绑定，当 任何一个选中项改变时，都会自动改变另一项。

例子

样式

注意：这个 style 在安卓 4.x 上有 bug

和 ViewPager 一起使用

带数字的小红圈

中间悬浮按钮

加入工程

Sdk 版本

compileSdkVersion >= 25

导入本库(选择其中一种)

Gradle例子:

步骤 1. 在工程根目录的 build.gradle 最后添加如下代码:

allprojects {
	repositories {
		...
		maven { url "https://jitpack.io" }
		maven { url "https://maven.google.com" }
	}
}

步骤 2. 添加依赖

  1. 旧版本 support lib 25 或 26
compile 'com.github.ittianyu:BottomNavigationViewEx:1.2.4'
compile "com.android.support:design:26.+"
  1. 新版本 support lib = 28
implementation 'com.github.ittianyu:BottomNavigationViewEx:2.0.4'
implementation "com.android.support:design:28.0.0"
  1. AndroidX 使用新版本，然后在 gradle.properties 中添加如下配置
android.useAndroidX=true
android.enableJetifier=true

手动导入:

下载文件 BottomNavigationViewEx.java 并复制到你的工程中。

开始使用

在 xml 布局中添加自定义控件:

<com.ittianyu.bottomnavigationviewex.BottomNavigationViewEx
    android:id="@+id/bnve"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:layout_alignParentBottom="true"
    android:background="@color/colorPrimary"
    app:itemIconTint="@color/selector_item_color"
    app:itemTextColor="@color/selector_item_color"
    app:menu="@menu/menu_navigation_with_view_pager" />

在 Activity 中绑定控件:

BottomNavigationViewEx bnve = (BottomNavigationViewEx) findViewById(R.id.bnve);

禁止所有动画效果

bnve.enableAnimation(false);
bnve.enableShiftingMode(false);
bnve.enableItemShiftingMode(false);

自定义图标和文本大小

bnve.setIconSize(widthDp, heightDp);
bnve.setTextSize(sp);

和 ViewPager 绑定####

// set adapter
adapter = new VpAdapter(getSupportFragmentManager(), fragments);
bind.vp.setAdapter(adapter);

// binding with ViewPager
bind.bnve.setupWithViewPager(bind.vp);

添加带数字的小红点

  1. Gradle 中加入 badge 库的依赖 
    compile 'q.rorbin:badgeview:1.1.0'
  2. 和底部控件绑定 
    // add badge
addBadgeAt(2, 1);

private Badge addBadgeAt(int position, int number) {
    // add badge
    return new QBadgeView(this)
            .setBadgeNumber(number)
            .setGravityOffset(12, 2, true)
            .bindTarget(bind.bnve.getBottomNavigationItemView(position))
            .setOnDragStateChangedListener(new Badge.OnDragStateChangedListener() {
                @Override
                public void onDragStateChanged(int dragState, Badge badge, View targetView) {
                    if (Badge.OnDragStateChangedListener.STATE_SUCCEED == dragState)
                        Toast.makeText(BadgeViewActivity.this, R.string.tips_badge_removed, Toast.LENGTH_SHORT).show();
                }
            });
}

其他 BottomNavigationViewEx 的用法

请参考demo。

其他 BottomNavigationView 的用法

其他用法和官方 BottomNavigationView 一样。 详情点击这里

混淆

如果你启用了 ProGuard，那你应该加上以下混淆代码:

非 Android X 版本

-keep public class android.support.design.widget.BottomNavigationView { *; }
-keep public class android.support.design.internal.BottomNavigationMenuView { *; }
-keep public class android.support.design.internal.BottomNavigationPresenter { *; }
-keep public class android.support.design.internal.BottomNavigationItemView { *; }

Android X 版本

-keep public class com.google.android.material.bottomnavigation.BottomNavigationView { *; }
-keep public class com.google.android.material.bottomnavigation.BottomNavigationMenuView { *; }
-keep public class com.google.android.material.bottomnavigation.BottomNavigationPresenter { *; }
-keep public class com.google.android.material.bottomnavigation.BottomNavigationItemView { *; }

来源

本库修改自安卓官方 Support Library 25 design 中的 BottomNavigationView。

我在尝试使用官方的库时，发现缺少灵活性。比如官方并没有提供切换当前选中项的方法。所以我在此基础上包装了一层，对外公开了一些方法。

你完全没有必要担心库的稳定性，因为我是使用反射对父类进行最小限度的修改。

致谢

感谢 Adrián Mouly | liaolintao | Luong Vo.

授权

MIT License

Copyright (c) 2017 ittianyu

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

反馈

qq群:913494600

打赏

paypal: admin@ittianyu.com