cordova-plugin-statusbar-background

1.0.0 • Public • Published

🍭 cordova-plugin-statusbar-background

Latest Stable Version Total Downloads License

This is a simple plugin for Android which will set the window statusbar and background color on start-up for you app's MainActivity to a color of your choice. This allows you to avoid the standard black status bar and dark grey background which will flash for a second before your splash screen appears. Set the color to the same background as your splash screen for a smoother start-up effect.

Installation

You'll need to set your desired window background color while installing the plugin by supplying the BG_SB_COLOR variable. Set it to whatever you want, preferrably the same color as your splash screen.

cordova plugin add cordova-plugin-statusbar-background --variable BG_SB_COLOR=#ff69b4 --save

Or install directly from this repo:

cordova plugin add https://github.com/Chongas/cordova-plugin-statusbar-background.git --variable BG_SB_COLOR=#ff69b4 --save

Supported Platforms

  • Cordova (cordova >=6.2.0)
  • Platform Android (cordova-android >=6.0.0)

Configuration

A custom BG_SB_COLOR variable will be added to your app's config.xml after installation with the value you selected (provided you included the --save flag). You can change it whenever you want, but you'll need to remove and re-add the Android platform from your project in order for the change to go through.

<plugin name="cordova-plugin-statusbar-background">
    <variable name="BG_SB_COLOR" value="#B4D455" />
</plugin>

To re-add the Android platform:

cordova platform remove android
cordova platform add android

TODO

  • Allow an image background to be used as windowBackground? Perhaps set it to the same image as the splash screen automatically?
  • Find a way to make changes to config.xml automatically update without having to re-add the platform.

Package Sidebar

Install

npm i cordova-plugin-statusbar-background

Weekly Downloads

0

Version

1.0.0

License

MIT

Unpacked Size

8.17 kB

Total Files

5

Last publish

Collaborators

  • chongas