2016-03-04 13:56:22 -06:00
|
|
|
import {Plugin, Cordova, CordovaProperty} from './plugin';
|
2015-11-28 16:17:04 -06:00
|
|
|
|
2016-02-16 17:42:41 -06:00
|
|
|
declare var window;
|
2016-01-25 16:20:36 -06:00
|
|
|
|
|
|
|
/**
|
2016-03-24 13:00:18 -04:00
|
|
|
* @name Status Bar
|
2016-03-12 18:30:16 -05:00
|
|
|
* @description
|
2016-01-25 16:20:36 -06:00
|
|
|
* Manage the appearance of the native status bar.
|
|
|
|
*
|
2016-02-16 17:42:41 -06:00
|
|
|
* Requires Cordova plugin: `cordova-plugin-statusbar`. For more info, please see the [StatusBar plugin docs](https://github.com/apache/cordova-plugin-statusbar).
|
2016-03-12 18:30:16 -05:00
|
|
|
*
|
|
|
|
* @usage
|
|
|
|
* ```ts
|
2016-03-24 13:00:18 -04:00
|
|
|
* import {StatusBar} from 'ionic-native';
|
|
|
|
*
|
|
|
|
*
|
|
|
|
*
|
2016-03-12 18:30:16 -05:00
|
|
|
* StatuBar.overlaysWebView(true);
|
|
|
|
*
|
2016-03-12 18:56:01 -05:00
|
|
|
* StatusBar.
|
2016-03-12 18:30:16 -05:00
|
|
|
* ```
|
|
|
|
*
|
2016-01-25 16:20:36 -06:00
|
|
|
*/
|
2015-11-28 18:26:55 -06:00
|
|
|
@Plugin({
|
2015-11-28 16:17:04 -06:00
|
|
|
plugin: 'cordova-plugin-statusbar',
|
2016-02-22 16:20:00 -05:00
|
|
|
pluginRef: 'StatusBar',
|
|
|
|
repo: 'https://github.com/apache/cordova-plugin-statusbar'
|
2015-11-28 18:26:55 -06:00
|
|
|
})
|
|
|
|
export class StatusBar {
|
2016-01-25 16:20:36 -06:00
|
|
|
/**
|
|
|
|
* Set whether the status bar overlays the main app view. The default
|
|
|
|
* is true.
|
|
|
|
*
|
2016-02-16 17:42:41 -06:00
|
|
|
* @param {boolean} doesOverlay Whether the status bar overlays the main app view.
|
2016-01-25 16:20:36 -06:00
|
|
|
*/
|
2016-02-16 17:42:41 -06:00
|
|
|
@Cordova({
|
|
|
|
sync: true
|
|
|
|
})
|
2016-04-29 23:56:49 -04:00
|
|
|
static overlaysWebView(doesOverlay: boolean) {};
|
2016-01-25 16:20:36 -06:00
|
|
|
|
2016-02-16 17:42:41 -06:00
|
|
|
/**
|
|
|
|
* Use the default statusbar (dark text, for light backgrounds).
|
|
|
|
*/
|
|
|
|
@Cordova({
|
|
|
|
sync: true
|
|
|
|
})
|
2016-04-29 23:56:49 -04:00
|
|
|
static styleDefault() {};
|
2016-01-25 16:20:36 -06:00
|
|
|
|
2016-02-16 17:42:41 -06:00
|
|
|
/**
|
|
|
|
* Use the lightContent statusbar (light text, for dark backgrounds).
|
|
|
|
*/
|
|
|
|
@Cordova({
|
|
|
|
sync: true
|
|
|
|
})
|
2016-04-29 23:56:49 -04:00
|
|
|
static styleLightContent() {};
|
2016-01-25 16:20:36 -06:00
|
|
|
|
2016-02-16 17:42:41 -06:00
|
|
|
/**
|
|
|
|
* Use the blackTranslucent statusbar (light text, for dark backgrounds).
|
|
|
|
*/
|
|
|
|
@Cordova({
|
|
|
|
sync: true
|
|
|
|
})
|
2016-04-29 23:56:49 -04:00
|
|
|
static styleBlackTranslucent() {};
|
2016-02-16 17:42:41 -06:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Use the blackOpaque statusbar (light text, for dark backgrounds).
|
|
|
|
*/
|
|
|
|
@Cordova({
|
|
|
|
sync: true
|
|
|
|
})
|
2016-04-29 23:56:49 -04:00
|
|
|
static styleBlackOpaque() {};
|
2016-01-25 16:20:36 -06:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Set the status bar to a specific named color. Valid options:
|
|
|
|
* black, darkGray, lightGray, white, gray, red, green, blue, cyan, yellow, magenta, orange, purple, brown.
|
|
|
|
*
|
2016-04-15 18:20:41 +08:00
|
|
|
* iOS note: you must call StatusBar.overlaysWebView(false) to enable color changing.
|
2016-01-25 16:20:36 -06:00
|
|
|
*
|
2016-02-16 17:42:41 -06:00
|
|
|
* @param {string} colorName The name of the color (from above)
|
2016-01-25 16:20:36 -06:00
|
|
|
*/
|
2016-02-16 17:42:41 -06:00
|
|
|
@Cordova({
|
|
|
|
sync: true
|
|
|
|
})
|
2016-04-29 23:56:49 -04:00
|
|
|
static backgroundColorByName(colorName: string) {};
|
2016-01-25 16:20:36 -06:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Set the status bar to a specific hex color (CSS shorthand supported!).
|
|
|
|
*
|
2016-04-15 18:20:41 +08:00
|
|
|
* iOS note: you must call StatusBar.overlaysWebView(false) to enable color changing.
|
2016-01-25 16:20:36 -06:00
|
|
|
*
|
2016-02-16 17:42:41 -06:00
|
|
|
* @param {string} hexString The hex value of the color.
|
2016-01-25 16:20:36 -06:00
|
|
|
*/
|
2016-02-16 17:42:41 -06:00
|
|
|
@Cordova({
|
|
|
|
sync: true
|
|
|
|
})
|
2016-04-29 23:56:49 -04:00
|
|
|
static backgroundColorByHexString(hexString: string) {};
|
2016-01-25 16:20:36 -06:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Hide the StatusBar
|
|
|
|
*/
|
2016-02-16 17:42:41 -06:00
|
|
|
@Cordova({
|
|
|
|
sync: true
|
|
|
|
})
|
2016-04-29 23:56:49 -04:00
|
|
|
static hide() {};
|
2016-01-25 16:20:36 -06:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Show the StatusBar
|
|
|
|
*/
|
2016-02-16 17:42:41 -06:00
|
|
|
@Cordova({
|
|
|
|
sync: true
|
|
|
|
})
|
2016-04-29 23:56:49 -04:00
|
|
|
static show() {};
|
2016-02-16 17:42:41 -06:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Whether the StatusBar is currently visible or not.
|
|
|
|
*/
|
2016-03-04 13:56:22 -06:00
|
|
|
@CordovaProperty
|
2016-03-10 15:48:20 -06:00
|
|
|
static get isVisible() { return window.StatusBar.isVisible; }
|
2015-11-28 16:17:04 -06:00
|
|
|
}
|