Kongzue Tabbar
Kongzue Tabbar是一款简单的底部导航栏组件，仅需要简单配置即可满足绝大多数需要使用导航栏的场景。
Github： https://github.com/kongzue/Tabbar
info
Demo预览图如下：
Tabbar
优势
-
无需两份图！每个 TabIcon 仅需一份颜色的图即可，Tabbar 会根据您设置的颜色自动叠加颜色！
-
易于上手，快速创建，满足绝大多数导航栏使用场景。
使用方法
- 从 Maven 仓库或 jCenter 引入：
Maven仓库：
<dependency>
<groupId>com.kongzue.tabbar</groupId>
<artifactId>tabbar</artifactId>
<version>1.0</version>
<type>pom</type>
</dependency>
Gradle：
在dependencies{}中添加引用：
implementation 'com.kongzue.tabbar:tabbar:1.0'
- 从XML布局文件创建：
<com.kongzue.tabbar.TabBarView xmlns:app="http://schemas.android.com/apk/res-auto"
android:id="@+id/tabbar"
android:layout_width="match_parent"
android:layout_height="55dp"
app:focusColor="#3e78ed"
app:iconPadding="2dp"
app:normalColor="#606060"
app:textSize="12dp"
app:tabPaddingVertical="5dp"/>
其中各属性解释如下：
| 字段 | 含义 | 默认值 |
|---|---|---|
| focusColor | 处于焦点状态的颜色 | #3e78ed |
| normalColor | 处于普通状态的颜色 | #606060 |
| iconPadding | 图标内边距 | 5dp |
| textSize | 文本字号 | 12dp |
| tabPaddingVertical | tab按钮上下内边距 | 5dp |
也可通过set方法设置：
tabbar = findViewById(R.id.tabbar);
tabbar.setFocusColor(Color.rgb(62, 120, 238)); //处于焦点状态的颜色
tabbar.setNormalColor(Color.rgb(96, 96, 96)); //处于普通状态的颜色
tabbar.setTextSize(dp2px(12)); //文本字号
tabbar.setIconPadding(dp2px(5)); //图标内边距
tabbar.setTabPaddingVertical(dp2px(5)); //tab按钮上下内边距
- 创建Tab：
首先需要创建一个 List<Tab> 用来存放Tab数据：
List<Tab> tabs = new ArrayList<>();
tabs.add(new Tab(this, "首页", R.mipmap.img_maintab_home));
tabs.add(new Tab(this, "联系人", R.mipmap.img_maintab_contacts));
tabs.add(new Tab(this, "我的", R.mipmap.img_maintab_me));
然后将它们设置到 Tabbar 即可：
tabbar.setTab(tabs);
完成！
额外的说明
- Tab 的创建（构造）方式
Tab 支持多种构建方式：
new Tab(this, "首页", R.mipmap.img_maintab_home) //使用资源文件创建
new Tab("首页", bitmap); //使用 Bitmap 位图创建
new Tab("首页", drawable); //使用 drawable 创建
Tab 亦支持 get、set 方法，可以通过他们设置属性值。
其次，关于 Tab 字段的说明：
| 字段 | 含义 | 是否必须 |
|---|---|---|
| name | Tab 标签名称 | 是 |
| icon | Tab 图标 | 是 |
- 按钮点击监听
可通过以下代码设置监听
tabbar.setOnTabChangeListener(new OnTabChangeListener() {
@Override
public void onTabChanged(int index) {
Log.i(">>>", "onTabChanged: " + index);
}
})
其中，index 即当前点击了哪个按钮的索引号。
- 设置默认焦点按钮：
可通过以下代码设置设置默认焦点按钮：
tabbar.setNormalFocusIndex(index);
其中，index 即要设置为焦点的按钮的索引号。
开源协议
Copyright Tabbar
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
网友评论