|
|
<!---
# license: Licensed to the Apache Software Foundation (ASF) under one
# or more contributor license agreements. See the NOTICE file
# distributed with this work for additional information
# regarding copyright ownership. The ASF licenses this file
# to you under the Apache License, Version 2.0 (the
# "License"); you may not use this file except in compliance
# with the License. You may obtain a copy of the License at
# # http://www.apache.org/licenses/LICENSE-2.0
# # Unless required by applicable law or agreed to in writing,
# software distributed under the License is distributed on an
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
# KIND, either express or implied. See the License for the
# specific language governing permissions and limitations
# under the License.
-->
# cordova-plugin-statusbar
[![Build Status](https://travis-ci.org/apache/cordova-plugin-statusbar.svg)](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. <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:
```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:
<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
|