7.2 KiB
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.
<preference name="StatusBarOverlaysWebView" value="true" />
-
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.
<preference name="StatusBarBackgroundColor" value="#000000" />
-
StatusBarStyle (Status Bar-Stil, der Standardwert ist Lightcontent). Legen Sie auf iOS 7 den Status-Bar-Stil. Verfügbaren Optionen Standard, Lightcontent, Blacktranslucent, Blackopaque.
<preference name="StatusBarStyle" value="lightcontent" />
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:
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:
<key>UIStatusBarHidden</key>
<true/>
<key>UIViewControllerBasedStatusBarAppearance</key>
<false/>
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"
<feature name="StatusBar">
<param name="ios-package" value="CDVStatusBar" onload="true" />
</feature>
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