# cordova-plugin-statusbar
[](https://travis-ci.org/apache/cordova-plugin-statusbar)
# StatusBar
> Das `StatusBar` Objekt stellt einige Funktionen zum Anpassen des iOS und Android StatusBar.
## Installation
cordova plugin add cordova-plugin-statusbar
## "Einstellungen"
#### "config.xml"
* **StatusBarOverlaysWebView** (Boolean, der Standardwert ist True). Stellen Sie auf iOS 7 die Statusbar-Overlay oder keine Überlagerung der WebView beim Start.
* **StatusBarBackgroundColor** (Farbe hex String, Standardwert ist #000000). Auf iOS legen 7 und Android 5, Sie die Hintergrundfarbe der Statusbar von eine hexadezimale Zeichenfolge (#RRGGBB) beim Start.
* **StatusBarStyle** (Status Bar-Stil, der Standardwert ist Lightcontent). Legen Sie auf iOS 7 den Status-Bar-Stil. Verfügbaren Optionen Standard, Lightcontent, Blacktranslucent, Blackopaque.
### Android Eigenarten
Die Android 5 + Leitlinien angeben, verwenden eine andere Farbe für die Statusbar als Ihre Hauptanwendung Farbe (anders als die einheitliche Statusbar Farbe viele iOS 7 + apps), so Sie die Statusbar Farbe zur Laufzeit statt über `StatusBar.backgroundColorByHexString` oder `StatusBar.backgroundColorByName`festzulegen möchten vielleicht. Eine Möglichkeit dazu wäre:
```js
if (cordova.platformId == 'android') {
StatusBar.backgroundColorByHexString("#333");
}
```
## Beim Start ausblenden
Während der Laufzeit können Sie die StatusBar.hide-Funktion unten, aber die StatusBar beim Start der app versteckt werden soll, müssen Sie Ihre app Info.plist Datei ändern.
Diese beiden Attribute hinzufügen/bearbeiten, wenn nicht vorhanden. Legen Sie **"Statusleiste ist anfangs ausgeblendet"** auf **"YES"** und **"View Controller-basierte Status Bar aussehen"** auf **"NO"**. Wenn Sie es manuell ohne Xcode bearbeiten, werden die Schlüssel und Werte:
UIStatusBarHidden
UIViewControllerBasedStatusBarAppearance
## Methoden
Dieses Plugin wird globales `StatusBar`-Objekt definiert.
Obwohl im globalen Gültigkeitsbereich, steht es nicht bis nach dem `deviceready`-Ereignis.
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
console.log(StatusBar);
}
* StatusBar.overlaysWebView
* StatusBar.styleDefault
* StatusBar.styleLightContent
* StatusBar.styleBlackTranslucent
* StatusBar.styleBlackOpaque
* StatusBar.backgroundColorByName
* StatusBar.backgroundColorByHexString
* StatusBar.hide
* StatusBar.show
## Eigenschaften
* StatusBar.isVisible
## Berechtigungen
#### "config.xml"
# StatusBar.overlaysWebView
Stellen Sie auf iOS 7 Statusbar überlagern oder nicht überlagert die WebView.
StatusBar.overlaysWebView(true);
## Beschreibung
Auf iOS 7 zu der Statusbar wie iOS 6 erscheinen auf False festgelegt. Legen Sie die Stil und Hintergrund Farbe entsprechend mit den anderen Funktionen.
## Unterstützte Plattformen
* iOS
## Kurzes Beispiel
StatusBar.overlaysWebView(true);
StatusBar.overlaysWebView(false);
# StatusBar.styleDefault
Verwenden Sie die Standard-Statusbar (dunkle Text, für helle Hintergründe).
StatusBar.styleDefault();
## Unterstützte Plattformen
* iOS
* Windows Phone 7
* Windows Phone 8
* Windows Phone-8.1
# StatusBar.styleLightContent
Verwenden Sie die LightContent-Statusbar (heller Text, für dunkle Hintergründe).
StatusBar.styleLightContent();
## Unterstützte Plattformen
* iOS
* Windows Phone 7
* Windows Phone 8
* Windows Phone-8.1
# StatusBar.styleBlackTranslucent
Verwenden Sie die BlackTranslucent-Statusbar (heller Text, für dunkle Hintergründe).
StatusBar.styleBlackTranslucent();
## Unterstützte Plattformen
* iOS
* Windows Phone 7
* Windows Phone 8
* Windows Phone-8.1
# StatusBar.styleBlackOpaque
Verwenden Sie die BlackOpaque-Statusbar (heller Text, für dunkle Hintergründe).
StatusBar.styleBlackOpaque();
## Unterstützte Plattformen
* iOS
* Windows Phone 7
* Windows Phone 8
* Windows Phone-8.1
# StatusBar.backgroundColorByName
Auf iOS 7 Wenn Sie StatusBar.statusBarOverlaysWebView auf False festlegen, können Sie die Hintergrundfarbe der Statusbar von Farbnamen festlegen.
StatusBar.backgroundColorByName("red");
Unterstützte Farbnamen sind:
black, darkGray, lightGray, white, gray, red, green, blue, cyan, yellow, magenta, orange, purple, brown
## Unterstützte Plattformen
* iOS
* Android 5+
* Windows Phone 7
* Windows Phone 8
* Windows Phone-8.1
# StatusBar.backgroundColorByHexString
Legt die Hintergrundfarbe der Statusbar von eine hexadezimale Zeichenfolge fest.
StatusBar.backgroundColorByHexString("#C0C0C0");
CSS-Kurzschrift-Eigenschaften werden ebenfalls unterstützt.
StatusBar.backgroundColorByHexString("#333"); // => #333333
StatusBar.backgroundColorByHexString("#FAB"); // => #FFAABB
Auf iOS 7 Wenn Sie StatusBar.statusBarOverlaysWebView auf False festlegen, können Sie die Hintergrundfarbe der Statusbar von eine hexadezimale Zeichenfolge (#RRGGBB) festlegen.
Auf WP7 und WP8 können Sie auch Werte wie #AARRGGBB, angeben wo AA einen alpha-Wert ist
## Unterstützte Plattformen
* iOS
* Android 5+
* Windows Phone 7
* Windows Phone 8
* Windows Phone-8.1
# StatusBar.hide
Ausblenden der Statusleiste.
StatusBar.hide();
## Unterstützte Plattformen
* iOS
* Android
* Windows Phone 7
* Windows Phone 8
* Windows Phone-8.1
# StatusBar.show
Zeigt die Statusleiste.
StatusBar.show();
## Unterstützte Plattformen
* iOS
* Android
* Windows Phone 7
* Windows Phone 8
* Windows Phone-8.1
# StatusBar.isVisible
Lesen Sie diese Eigenschaft, um festzustellen, ob die Statusbar sichtbar oder nicht ist.
if (StatusBar.isVisible) {
// do something
}
## Unterstützte Plattformen
* iOS
* Android
* Windows Phone 7
* Windows Phone 8
* Windows Phone-8.1