tree: 7762f561cad2d2d85e9bf8aaf9ab99242d4a207d [path history] [tgz]
  1. index.md
  2. README.md
doc/de/README.md

cordova-plugin-statusbar

Build Status

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.backgroundColorByNamefestzulegen 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