ahbottomnavigation

by aurelhubert

aurelhubert / ahbottomnavigation

A library to reproduce the behavior of the Bottom Navigation guidelines from Material Design.

3.8K Stars 697 Forks Last release: almost 2 years ago (v2.3.4) 280 Commits 14 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

AHBottomNavigation

Library to implement the Bottom Navigation component from Material Design guidelines (minSdkVersion=14).

Warning: For >= 2.3.0, you need to use AndroidX in your project

Demo

What's new (2.3.4) - Changelog

  • Fix a bug with the disappearing animation for the notification

Features

  • Follow the bottom navigation guidelines (https://www.google.com/design/spec/components/bottom-navigation.html)
  • Add 3 to 5 items (with title, icon & color)
  • Choose your style: Classic or colored navigation
  • Add a OnTabSelectedListener to detect tab selection
  • Support icon font color with "setForceTint(true)"
  • Manage notififcations for each item
  • Enable/disable tab state

How to?

Gradle

dependencies {
    compile 'com.aurelhubert:ahbottomnavigation:2.3.4'
}

XML


OR ```xml

...

<com.aurelhubert.ahbottomnavigation.ahbottomnavigation android:id="@+id/bottom_navigation" android:layout_width="match_parent" android:layout_height="wrap_content" android:layout_gravity="bottom"></com.aurelhubert.ahbottomnavigation.ahbottomnavigation>

```

Activity/Fragment

AHBottomNavigation bottomNavigation = (AHBottomNavigation) findViewById(R.id.bottom_navigation);

// Create items AHBottomNavigationItem item1 = new AHBottomNavigationItem(R.string.tab_1, R.drawable.ic_maps_place, R.color.color_tab_1); AHBottomNavigationItem item2 = new AHBottomNavigationItem(R.string.tab_2, R.drawable.ic_maps_local_bar, R.color.color_tab_2); AHBottomNavigationItem item3 = new AHBottomNavigationItem(R.string.tab_3, R.drawable.ic_maps_local_restaurant, R.color.color_tab_3);

// Add items bottomNavigation.addItem(item1); bottomNavigation.addItem(item2); bottomNavigation.addItem(item3);

// Set background color bottomNavigation.setDefaultBackgroundColor(Color.parseColor("#FEFEFE"));

// Disable the translation inside the CoordinatorLayout bottomNavigation.setBehaviorTranslationEnabled(false);

// Enable the translation of the FloatingActionButton bottomNavigation.manageFloatingActionButtonBehavior(floatingActionButton);

// Change colors bottomNavigation.setAccentColor(Color.parseColor("#F63D2B")); bottomNavigation.setInactiveColor(Color.parseColor("#747474"));

// Force to tint the drawable (useful for font with icon for example) bottomNavigation.setForceTint(true);

// Display color under navigation bar (API 21+) // Don't forget these lines in your style-v21 // true // true bottomNavigation.setTranslucentNavigationEnabled(true);

// Manage titles bottomNavigation.setTitleState(AHBottomNavigation.TitleState.SHOW_WHEN_ACTIVE); bottomNavigation.setTitleState(AHBottomNavigation.TitleState.ALWAYS_SHOW); bottomNavigation.setTitleState(AHBottomNavigation.TitleState.ALWAYS_HIDE);

// Use colored navigation with circle reveal effect bottomNavigation.setColored(true);

// Set current item programmatically bottomNavigation.setCurrentItem(1);

// Customize notification (title, background, typeface) bottomNavigation.setNotificationBackgroundColor(Color.parseColor("#F63D2B"));

// Add or remove notification for each item bottomNavigation.setNotification("1", 3); // OR AHNotification notification = new AHNotification.Builder() .setText("1") .setBackgroundColor(ContextCompat.getColor(DemoActivity.this, R.color.color_notification_back)) .setTextColor(ContextCompat.getColor(DemoActivity.this, R.color.color_notification_text)) .build(); bottomNavigation.setNotification(notification, 1);

// Enable / disable item & set disable color bottomNavigation.enableItemAtPosition(2); bottomNavigation.disableItemAtPosition(2); bottomNavigation.setItemDisableColor(Color.parseColor("#3A000000"));

// Set listeners bottomNavigation.setOnTabSelectedListener(new AHBottomNavigation.OnTabSelectedListener() { @Override public boolean onTabSelected(int position, boolean wasSelected) { // Do something cool here... return true; } }); bottomNavigation.setOnNavigationPositionListener(new AHBottomNavigation.OnNavigationPositionListener() { @Override public void onPositionChange(int y) { // Manage the new y position } });

With XML menu

int[] tabColors = getApplicationContext().getResources().getIntArray(R.array.tab_colors);
AHBottomNavigation bottomNavigation = (AHBottomNavigation) findViewById(R.id.bottom_navigation);
AHBottomNavigationAdapter navigationAdapter = new AHBottomNavigationAdapter(this, R.menu.bottom_navigation_menu_3);
navigationAdapter.setupWithBottomNavigation(bottomNavigation, tabColors);

TODO

  • Manage tablet

Contributions

Feel free to create issues / pull requests.

License

AHBottomNavigation library for Android
Copyright (c) 2018 Aurelien Hubert (http://github.com/aurelhubert).

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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.