https://github.com/aurelhubert/ahbottomnavigation

A library to reproduce the behavior of the Bottom Navigation guidelines from Material Design.
https://github.com/aurelhubert/ahbottomnavigation

Last synced: 1 day ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/aurelhubert/ahbottomnavigation
• Owner: aurelhubert
• Created: 2016-03-17T12:17:56.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2021-07-10T21:57:52.000Z (over 3 years ago)
• Last Synced: 2024-12-05T10:06:44.561Z (8 days ago)
• Language: Java
• Size: 5.38 MB
• Stars: 3,839
• Watchers: 71
• Forks: 683
• Open Issues: 145
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md

Awesome Lists containing this project

• awesome-github-android-ui - ahbottomnavigation - 实现MD风格的按钮导航组件库 (BottomNavigation)

README

        

# 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](https://github.com/aurelhubert/ahbottomnavigation/blob/master/CHANGELOG.md)

* 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

```groovy

dependencies {

    compile 'com.aurelhubert:ahbottomnavigation:2.3.4'

}

```

### XML

```xml

```

OR

```xml

    ...

    

```

### Activity/Fragment

```java

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

```java

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.

```