internrocket / cordova-plugin-statusbarcolor

Change the status bar color in Android Lollipop

Status Bar Color Cordova Plugin For Android Lollipop

Installation

Prerequsites

This must be compiled at Android API level 21 or higher which means you'll have to be using cordova-android v3.7.1 or higher. The latest version of cordova-cli does not use cordova-android 3.7.1, so to manually install run the following:

cordova platform remove android
cordova platform add [email protected]

config.xml

The plugin supports any string from android.graphics.Color.parseColor(), but to ensure compatibility with cordova-plugin-statusbar make sure to use a hex string in the format #RRGGBB.

set the preference StatusBarBackgroundColor (also used by cordova-plugin-statusbar)

<preference name="StatusBarBackgroundColor" value="#BD3138" />

License

The MIT License (MIT)

Copyright (c) 2015 internrocket, inc.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

cordova-plugin-statusbarcolor's Issues

Preference for an automatically darker statusbar per material design spec

...if you switch line 21 of your StatusBarColor.java to int color = Color.parseColor(preferences.getString("StatusBarBackgroundColor", "#000000")) - Color.decode("#621b16");
i THINK that will correctly darken the status bar

• @codysherman

• Material Design Color Spec
• add a preference for optionally automatically darkening the status bar

Phonegap Build

Is there any way to use this plugin with Phonegap Build?
Sadly the cordova-plugin-statusbar plugin still only supports iOS and not Android.

Coloring 'recents' screen header color?

An old comment you left here:

http://stackoverflow.com/questions/27838528/changing-color-of-header-in-multitask-view#comment45576749_27838803

implied that provided the build is built against api 21 or higher, the recents color should match statusbar color. Is this no longer the case? Am I just holding it wrong?

Allow dynamic setting of activity header color

It would be awesome if you added a function like StatusBarColor.activityColor() so I could set the color dynamically from my app's JavaScript, like cordova-plugin-statusbar.

My app has a feature to change the theme on the fly, so I need a way to dynamically update the color when the user chooses a different theme.

Update docs for new version of cordova-android

The latest cordova cli has been updated with a version of cordova-android that supports Android Lollipop, and as a result the manual update of the platform is no longer necessary and should be removed from the docs.

Publish to NPM

It would be neat if you could either publish this plugin on the Cordova NPM repository or alternatively open a pull request into cordova-plugin-statusbar to add the functionality to theme the header in the multi-task view.

The reason I ask: I'm using PhoneGap Build for my app, and as far as I know there isn't an easy way to include a plugin that's not available through the NPM repository.