A beautiful, customizable and easy-to-use Material Design Bottom Navigation for react-native.
npm install react-native-material-bottom-navigation
A beautiful, customizable and easy-to-use
Material Design Bottom Navigation for react-native.
- Pure JavaScript. No native dependencies. No linking. No obstacles.
- Looks beautiful. Stunning and fluid animations. You won't believe it's not a native view.
- Customize it. You can adjust nearly everything to make it fit perfectly to your app.
- Easy to use. Uses established React patterns for both simple and advanced usage.
- Pluggable. Includes customizable Tabs and Badges. Not enough? Create and use your own!
Using npm:
``sh`
npm install react-native-material-bottom-navigation
Or using yarn:
`sh`
yarn add react-native-material-bottom-navigation
- Installation
- Demo
- Usage
- Documentation
- Notes
- Contribute
- Contributors
- License

Shifting Tab

Full Tab
![]()
Icon Tab
This library uses "render props" as established pattern for component composition. The example below illustrates the basic usage of the Bottom Navigation. All available Props are listed in the Documentation.
Dive into the example below, check out the example app and take a look at the Usage Documentation.
`js
import BottomNavigation, {
FullTab
} from 'react-native-material-bottom-navigation'
export default class App extends React.Component {
tabs = [
{
key: 'games',
icon: 'gamepad-variant',
label: 'Games',
barColor: '#388E3C',
pressColor: 'rgba(255, 255, 255, 0.16)'
},
{
key: 'movies-tv',
icon: 'movie',
label: 'Movies & TV',
barColor: '#B71C1C',
pressColor: 'rgba(255, 255, 255, 0.16)'
},
{
key: 'music',
icon: 'music-note',
label: 'Music',
barColor: '#E64A19',
pressColor: 'rgba(255, 255, 255, 0.16)'
}
]
state = {
activeTab: 'games'
}
renderIcon = icon => ({ isActive }) => (
)
renderTab = ({ tab, isActive }) => (
key={tab.key}
label={tab.label}
renderIcon={this.renderIcon(tab.icon)}
/>
)
render() {
return (
{/ Your screen contents depending on current tab. /}
onTabPress={newTab => this.setState({ activeTab: newTab.key })}
renderTab={this.renderTab}
tabs={this.tabs}
/>
)
}
}
`
Note: Out-of-the-box support for React Navigation (called NavigationComponent in earlier releases) was removed with v1. Check this example for a custom React Navigation integration. Read more...
You can also view the entire documentation on GitBook: https://timomeh.gitbook.io/material-bottom-navigation/
- Usage
- API Reference
-
-
-
-
-
Check this example for a custom React Navigation integration.
In contrary to earlier releases, this library does not support React Navigation _out of the box_. React Navigation now ships with its own Material Bottom Navigation: createMaterialBottomTabNavigator`.
You can still implement react-native-material-bottom-navigation manually by using React Navigation's Custom Navigators. Check out this example.
Google updated the Material Guidelines on Google I/O 2018 with new specifications, including a slightly changed Bottom Navigation and a new "App Bar Bottom" with a FAB in a centered cutout. react-native-material-bottom-navigation uses the _older_ specs.
Contributions are always welcome. Read more in the Contribution Guides.
Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
Thanks goes to these wonderful people (emoji key):
|
Timo Mรคmecke
๐ ๐ป ๐จ ๐ ๐ก ๐") ๐ค ๐ |
Shayan Javadi
๐ป |
David
๐ป |
Jayser Mendez
๐ |
Peter Kottas
๐ป |
Matt Oakes
๐ป |
Keeley Carrigan
๐ป |
| :---: | :---: | :---: | :---: | :---: | :---: | :---: |
|
Sean Holbert
๐ป |
Alessandro Parolin
๐ |
Prashanth Acharya M
๐ |
Alexey Tcherevatov
๐ป ๐ |
Trevor Atlas
๐ |
This project follows the all-contributors specification. Contributions of any kind welcome!
MIT, ยฉ 2017 - present Timo Mรคmecke