Navigation tab bar with colorful interactions.
You can check the sample app here.
You can download a .aar
from GitHub's releases page.
You can use Gradle:
compile 'devlight.io:navigationtabbar:1.2.5'
Or Maven:
<dependency>
<groupId>devlight.io</groupId>
<artifactId>navigationtabbar</artifactId>
<version>1.2.5</version>
<type>aar</type>
</dependency>
Or Ivy:
<dependency org='devlight.io' name='navigationtabbar' rev='1.2.5'>
<artifact name='$AID' ext='pom'></artifact>
</dependency>
NavigationTabBar
requires a minimum SDK version of 11.
Parameters
For NTB
you can set such parameters as:
-
models:
allows you to setNTB
models, where you set icon and color. Can be set up only via code. -
behavior:
allows you to set bottom translation behavior. -
view pager:
allows you to connectNTB
withViewPager
. If you want your can also setOnPageChangeListener
. -
background color:
allows you to set background toNTB
which automatically set with offset relative to badge gravity and corners radius. -
model selected icon:
allows you to set selected icon when current model is active. -
model title:
allows you to enable title in you model. -
model badge:
allows you to enable badge in you model. -
use custom typeface on badge:
allows you to handle set of custom typeface in your badge. -
title mode:
allows you to handle mode of the model title show. Can show all or only active. -
title size:
allows you to set titles size. -
scale mode:
allows you to handle mode of the model icon and title scale. -
tint mode:
allows you to enable or disable icon tinting. -
badge size:
allows you to set badges size. -
badge position:
allows you to set the badge position in you model. Can be: left(25%), center(50%) and right(75%). -
badge gravity:
allows you to set the badge gravity in NTB. Can be top or bottom. -
badge colors:
allows you to set the badge bg and title colors. -
typeface:
allows you to set custom typeface to your title. -
corners radius:
allows you to set corners radius of pointer. -
icon size fraction:
allows you to set icon size fraction relative to smaller model side. -
animation duration:
allows you to set animation duration. -
inactive color:
allows you to set inactive icon color. -
active color:
allows you to set active icon color. -
tab bar listener:
allows you to set listener which triggering on start or on end when you set model index. -
preview colors:
allows you to set preview colors, which generate count of models equals to count of colors.
Tips
Creation of models occurs through Builder
pattern.
ModelBuilder
requires two fields: icon and color. Title, badge title and selected icon is optional.
You can set selected icon. Resize and scale of selected icon equals to original icon.
Orientation automatically detected according to View
size.
By default badge bg color is the active model color and badge title color is the model bg color. To reset colors just set AUTO_COLOR
value to badge bg and title color.
By default badge sizes and title sizes is auto fit. To reset calculation just set AUTO_SIZE
value to badge size and title size.
By default icon size fraction is 0.5F
(half of smaller side of NTB
model). To reset scale fraction of icon to automatic just put in method AUTO_SCALE
value.
If your set ViewPager
and enable swipe you can action down on active pointer and do like drag.
Init
Check out in code init:
final NavigationTabBar navigationTabBar = (NavigationTabBar) findViewById(R.id.ntb);
final ArrayList<NavigationTabBar.Model> models = new ArrayList<>();
models.add(
new NavigationTabBar.Model.Builder(
getResources().getDrawable(R.drawable.ic_first),
Color.parseColor(colors[0])
).title("Heart")
.badgeTitle("NTB")
.build()
);
models.add(
new NavigationTabBar.Model.Builder(
getResources().getDrawable(R.drawable.ic_second),
Color.parseColor(colors[1])
).title("Cup")
.badgeTitle("with")
.build()
);
models.add(
new NavigationTabBar.Model.Builder(
getResources().getDrawable(R.drawable.ic_third),
Color.parseColor(colors[2])
).title("Diploma")
.badgeTitle("state")
.build()
);
models.add(
new NavigationTabBar.Model.Builder(
getResources().getDrawable(R.drawable.ic_fourth),
Color.parseColor(colors[3])
).title("Flag")
.badgeTitle("icon")
.build()
);
models.add(
new NavigationTabBar.Model.Builder(
getResources().getDrawable(R.drawable.ic_fifth),
Color.parseColor(colors[4])
).title("Medal")
.badgeTitle("777")
.build()
);
navigationTabBar.setModels(models);
navigationTabBar.setViewPager(viewPager, 2);
navigationTabBar.setTitleMode(NavigationTabBar.TitleMode.ACTIVE);
navigationTabBar.setBadgeGravity(NavigationTabBar.BadgeGravity.BOTTOM);
navigationTabBar.setBadgePosition(NavigationTabBar.BadgePosition.CENTER);
navigationTabBar.setTypeface("fonts/custom_font.ttf");
navigationTabBar.setIsBadged(true);
navigationTabBar.setIsTitled(true);
navigationTabBar.setIsTinted(true);
navigationTabBar.setIsBadgeUseTypeface(true);
navigationTabBar.setBadgeBgColor(Color.RED);
navigationTabBar.setBadgeTitleColor(Color.WHITE);
navigationTabBar.setIsSwiped(true);
navigationTabBar.setBgColor(Color.BLACK);
navigationTabBar.setBadgeSize(10);
navigationTabBar.setTitleSize(10);
navigationTabBar.setIconSizeFraction(0.5);
If your models is in badge mode you can set title, hide, show, toggle and update badge title like this:
model.setTitle("Here some title to model");
model.hideBadge();
model.showBadge();
model.toggleBadge();
model.updateBadgeTitle("Here some title like NEW or some integer value");
To enable behavior translation inside CoordinatorLayout
when at bottom of screen:
navigationTabBar.setBehaviorEnabled(true);
To deselect active index and reset pointer:
navigationTabBar.deselect();
Other methods check out in sample.
And XML init:
<devlight.io.library.ntb.NavigationTabBar
android:id="@+id/ntb"
android:layout_width="match_parent"
android:layout_height="50dp"
app:ntb_animation_duration="400"
app:ntb_preview_colors="@array/colors"
app:ntb_corners_radius="10dp"
app:ntb_active_color="#fff"
app:ntb_inactive_color="#000"
app:ntb_badged="true"
app:ntb_titled="true"
app:ntb_scaled="true"
app:ntb_tinted="true"
app:ntb_title_mode="all"
app:ntb_badge_position="right"
app:ntb_badge_gravity="top"
app:ntb_badge_bg_color="#ffff0000"
app:ntb_badge_title_color="#ffffffff"
app:ntb_typeface="fonts/custom_typeface.ttf"
app:ntb_badge_use_typeface="true"
app:ntb_swiped="true"
app:ntb_bg_color="#000"
app:ntb_icon_size_fraction="0.5"
app:ntb_badge_size="10sp"
app:ntb_title_size="10sp"/>
XML属性中文详解:
<devlight.io.library.ntb.NavigationTabBar 各属性详解
全局:
app:ntb_bg_color="#000" ntb的背景颜色 可自定义
app:ntb_active_color="#000" ntb活动时的图标+标题颜色 可自定义
app:ntb_inactive_color="#0f0" ntb不活动时的图标+标题颜色 可自定义
app:ntb_corners_radius="10dp" ntb切换时的动画弧度大小 可自定义
app:ntb_animation_duration="1000" ntb切换时的动画时间 单位:ms
图标相关:
app:ntb_icon_size_fraction="1" 图标所占的大小比例 最佳值:0.5
标题相关:
app:ntb_titled="true" 是否显示图标所对应的标题 默认为false
app:ntb_title_mode="active" 图片所对应的标题显示模式 active:活动时才显示 all:总是显示 PS:app:ntb_titled属性值为 true 时才可用
app:ntb_title_size="10sp" 设置图标所对应的标题文字大小 请自定义
勋章相关:
app:ntb_badged="false" 是否显示勋章 默认为false
app:ntb_badge_gravity="top" 勋章的上下位置 top|bottom
app:ntb_badge_position="right" 勋章的左右位置 left(25%), center(50%) and right(75%)
app:ntb_badge_bg_color="#ffff0000" 勋章的背景颜色 可自定义
app:ntb_badge_title_color="#000000" 勋章的标题文字颜色 可自定义 PS:不设置的话默认为切换动画的背景色
app:ntb_badge_size="12sp" 勋章的标题文字大小 可自定义
字体相关:
app:ntb_badge_use_typeface="false" 是否使用自定义字体 默认为false
app:ntb_typeface="fonts/by3500.ttf" 设置ntb的自定义字体 请将自定义的字体文件放在 asset/fonts 文件夹下
其他:
app:ntb_preview_colors="@array/colors"
app:ntb_scaled="true"
app:ntb_tinted="true"
app:ntb_swiped="true"/>
To report a specific problem or feature request, open a new issue on Github.
Thanks to Martijn van Dijk for developing Xamarin bindings library for NavigationTabBar.
Plugin is available on Nuget.
Sincere thanks, to portal FAnDroid.info (StartAndroid) who released the review of this library in detail. If you understand the Russian language, then feel free to see the video or read the text version of its great post.
Inspired by:
Sergey Valiukh |
---|
Thanks to Valery Nuzhniy for NTB badge design.
Created by Basil Miller - @gigamole
Here you can see open source work developed by Devlight LLC.
This and another works is an exclusive property of Devlight LLC.
If you want to use this library in applications which will be available on Google Play, please report us about it or author of the library.
Whether you're searching for a new partner or trusted team for creating your new great product we are always ready to start work with you.
You can contact us via info@devlight.io or opensource@devlight.io.
Thanks in advance.
Devlight LLC, 2016
devlight.io