# React Native Navigation Bar Color Change [![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fthebylito%2Freact-native-navigation-bar-color.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2Fthebylito%2Freact-native-navigation-bar-color?ref=badge_shield) React Native Navigation Bar Color Change is a [React Native](http://facebook.github.io/react-native/) library for change color of navigation/Bottom bar on Android. ### Android Only
## Table of Contents - [Installation](#installation) - [Example](#example) - [API](#api) - [License](#license) ## Support ## Installation
react-native >= 0.60.0 ### 1 - Install the package: `$ yarn add react-native-navigation-bar-color` or `$ npm install react-native-navigation-bar-color --save` ## That's is all!
react-native <= 0.59.0 ### 1 - Install the package: `$ yarn add react-native-navigation-bar-color` or `$ npm install react-native-navigation-bar-color --save` ### 2 - Configure package: 1. Open up `android/app/src/main/java/[...]/MainApplication.java` - Add `import com.thebylito.navigationbarcolor.NavigationBarColorPackage;` to the imports at the top of the file - Add `new NavigationBarColorPackage()` to the list returned by the `getPackages()` method 2. Append the following lines to `android/settings.gradle`: ``` include ':react-native-navigation-bar-color' project(':react-native-navigation-bar-color').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-navigation-bar-color/android') ``` 3. Insert the following lines inside the dependencies block in `android/app/build.gradle`: ``` implementation project(':react-native-navigation-bar-color') ```
## Example
**Android Implementation** ```javascript import React from 'react'; import {View, Text, Button} from 'react-native'; import changeNavigationBarColor, { hideNavigationBar, showNavigationBar, } from 'react-native-navigation-bar-color'; export default function App() { const setNavigationColor = color => { changeNavigationBarColor(color); }; const hideNavigation = () => { hideNavigationBar(); }; const showNavigation = () => { showNavigationBar(); }; const testSetTranslucent = () => { changeNavigationBarColor('translucent', false); }; const testSetTransparent = () => { changeNavigationBarColor('transparent', true); }; return (
## API ### `changeNavigationBarColor(color, Boolean(light icon color), Boolean(animated - default is true))`: (Android) Change color of Navigation/Bottom bar. color can be a "translucent" | "transparent" | HEX color, or name. ex: green, blue, #80b3ff, #ffffff.... Light is true? icons will be dark. - Returns a `Promise` ```javascript example = async () => { try{ const response = await changeNavigationBarColor('#80b3ff'); console.log(response)// {success: true} }catch(e){ console.log(e)// {success: false} } }; ``` ## OR ```javascript example = async () => { try{ const response = await changeNavigationBarColor('#80b3ff', true); console.log(response)// {success: true} }catch(e){ console.log(e)// {success: false} } }; ``` ### `hideNavigationBar()`: (Android) Hide Navigation Bar ```javascript import { hideNavigationBar } from 'react-native-navigation-bar-color'; ... hide = () => { hideNavigationBar(); }; ``` ### `showNavigationBar()`: (Android) Show Navigation Bar ```javascript import { showNavigationBar } from 'react-native-navigation-bar-color'; ... show = () => { showNavigationBar(); }; ``` ## License MIT [![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fthebylito%2Freact-native-navigation-bar-color.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2Fthebylito%2Freact-native-navigation-bar-color?ref=badge_large)