1<!---
  2    Licensed to the Apache Software Foundation (ASF) under one
  3    or more contributor license agreements.  See the NOTICE file
  4    distributed with this work for additional information
  5    regarding copyright ownership.  The ASF licenses this file
  6    to you under the Apache License, Version 2.0 (the
  7    "License"); you may not use this file except in compliance
  8    with the License.  You may obtain a copy of the License at
  9
 10      http://www.apache.org/licenses/LICENSE-2.0
 11
 12    Unless required by applicable law or agreed to in writing,
 13    software distributed under the License is distributed on an
 14    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 15    KIND, either express or implied.  See the License for the
 16    specific language governing permissions and limitations
 17    under the License.
 18-->
 19
 20# cordova-plugin-statusbar
 21
 22# StatusBar
 23
 24> Das `StatusBar` Objekt stellt einige Funktionen zum Anpassen des iOS und Android StatusBar.
 25
 26## Installation
 27
 28    cordova plugin add cordova-plugin-statusbar
 29    
 30
 31## "Einstellungen"
 32
 33#### config.xml
 34
 35*   **StatusBarOverlaysWebView** (Boolean, der Standardwert ist True). Stellen Sie auf iOS 7 die Statusbar-Overlay oder keine Überlagerung der WebView beim Start.
 36    
 37        <preference name="StatusBarOverlaysWebView" value="true" />
 38        
 39
 40*   **StatusBarBackgroundColor** (Farbe hex String, der Standardwert ist #000000). Legen Sie auf iOS 7 die Hintergrundfarbe der Statusbar von eine hexadezimale Zeichenfolge (#RRGGBB) beim Start.
 41    
 42        <preference name="StatusBarBackgroundColor" value="#000000" />
 43        
 44
 45*   **StatusBarStyle** (Status Bar-Stil, der Standardwert ist Lightcontent). Legen Sie auf iOS 7 den Status-Bar-Stil. Verfügbaren Optionen Standard, Lightcontent, Blacktranslucent, Blackopaque.
 46    
 47        <preference name="StatusBarStyle" value="lightcontent" />
 48        
 49
 50## Beim Start ausblenden
 51
 52Wä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.
 53
 54Diese 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:
 55
 56    <key>UIStatusBarHidden</key>
 57    <true/>
 58    <key>UIViewControllerBasedStatusBarAppearance</key>
 59    <false/>
 60    
 61
 62## Methoden
 63
 64Dieses Plugin wird globales `StatusBar`-Objekt definiert.
 65
 66Obwohl im globalen Gültigkeitsbereich, steht es nicht bis nach dem `deviceready`-Ereignis.
 67
 68    document.addEventListener("deviceready", onDeviceReady, false);
 69    function onDeviceReady() {
 70        console.log(StatusBar);
 71    }
 72    
 73
 74*   StatusBar.overlaysWebView
 75*   StatusBar.styleDefault
 76*   StatusBar.styleLightContent
 77*   StatusBar.styleBlackTranslucent
 78*   StatusBar.styleBlackOpaque
 79*   StatusBar.backgroundColorByName
 80*   StatusBar.backgroundColorByHexString
 81*   StatusBar.hide
 82*   StatusBar.show
 83
 84## Eigenschaften
 85
 86*   StatusBar.isVisible
 87
 88## Berechtigungen
 89
 90#### config.xml
 91
 92            <feature name="StatusBar">
 93                <param name="ios-package" value="CDVStatusBar" onload="true" />
 94            </feature>
 95    
 96
 97# StatusBar.overlaysWebView
 98
 99Stellen Sie auf iOS 7 Statusbar überlagern oder nicht überlagert die WebView.
100
101    StatusBar.overlaysWebView(true);
102    
103
104## Beschreibung
105
106Auf iOS 7 zu der Statusbar wie iOS 6 erscheinen auf False festgelegt. Legen Sie die Stil und Hintergrund Farbe entsprechend mit den anderen Funktionen.
107
108## Unterstützte Plattformen
109
110*   iOS
111
112## Kurzes Beispiel
113
114    StatusBar.overlaysWebView(true);
115    StatusBar.overlaysWebView(false);
116    
117
118# StatusBar.styleDefault
119
120Verwenden Sie die Standard-Statusbar (dunkle Text, für helle Hintergründe).
121
122    StatusBar.styleDefault();
123    
124
125## Unterstützte Plattformen
126
127*   iOS
128*   Windows Phone 7
129*   Windows Phone 8
130*   Windows Phone-8.1
131
132# StatusBar.styleLightContent
133
134Verwenden Sie die LightContent-Statusbar (heller Text, für dunkle Hintergründe).
135
136    StatusBar.styleLightContent();
137    
138
139## Unterstützte Plattformen
140
141*   iOS
142*   Windows Phone 7
143*   Windows Phone 8
144*   Windows Phone-8.1
145
146# StatusBar.styleBlackTranslucent
147
148Verwenden Sie die BlackTranslucent-Statusbar (heller Text, für dunkle Hintergründe).
149
150    StatusBar.styleBlackTranslucent();
151    
152
153## Unterstützte Plattformen
154
155*   iOS
156*   Windows Phone 7
157*   Windows Phone 8
158*   Windows Phone-8.1
159
160# StatusBar.styleBlackOpaque
161
162Verwenden Sie die BlackOpaque-Statusbar (heller Text, für dunkle Hintergründe).
163
164    StatusBar.styleBlackOpaque();
165    
166
167## Unterstützte Plattformen
168
169*   iOS
170*   Windows Phone 7
171*   Windows Phone 8
172*   Windows Phone-8.1
173
174# StatusBar.backgroundColorByName
175
176Auf iOS 7 Wenn Sie StatusBar.statusBarOverlaysWebView auf False festlegen, können Sie die Hintergrundfarbe der Statusbar von Farbnamen festlegen.
177
178    StatusBar.backgroundColorByName("red");
179    
180
181Unterstützte Farbnamen sind:
182
183    black, darkGray, lightGray, white, gray, red, green, blue, cyan, yellow, magenta, orange, purple, brown
184    
185
186## Unterstützte Plattformen
187
188*   iOS
189*   Windows Phone 7
190*   Windows Phone 8
191*   Windows Phone-8.1
192
193# StatusBar.backgroundColorByHexString
194
195Legt die Hintergrundfarbe der Statusbar von eine hexadezimale Zeichenfolge fest.
196
197    StatusBar.backgroundColorByHexString("#C0C0C0");
198    
199
200CSS-Kurzschrift-Eigenschaften werden ebenfalls unterstützt.
201
202    StatusBar.backgroundColorByHexString("#333"); // => #333333
203    StatusBar.backgroundColorByHexString("#FAB"); // => #FFAABB
204    
205
206Auf iOS 7 Wenn Sie StatusBar.statusBarOverlaysWebView auf False festlegen, können Sie die Hintergrundfarbe der Statusbar von eine hexadezimale Zeichenfolge (#RRGGBB) festlegen.
207
208Auf WP7 und WP8 können Sie auch Werte wie #AARRGGBB, angeben wo AA einen alpha-Wert ist
209
210## Unterstützte Plattformen
211
212*   iOS
213*   Windows Phone 7
214*   Windows Phone 8
215*   Windows Phone-8.1
216
217# StatusBar.hide
218
219Ausblenden der Statusleiste.
220
221    StatusBar.hide();
222    
223
224## Unterstützte Plattformen
225
226*   iOS
227*   Android
228*   Windows Phone 7
229*   Windows Phone 8
230*   Windows Phone-8.1
231
232# StatusBar.show
233
234Zeigt die Statusleiste.
235
236    StatusBar.show();
237    
238
239## Unterstützte Plattformen
240
241*   iOS
242*   Android
243*   Windows Phone 7
244*   Windows Phone 8
245*   Windows Phone-8.1
246
247# StatusBar.isVisible
248
249Lesen Sie diese Eigenschaft, um festzustellen, ob die Statusbar sichtbar oder nicht ist.
250
251    if (StatusBar.isVisible) {
252        // do something
253    }
254    
255
256## Unterstützte Plattformen
257
258*   iOS
259*   Android
260*   Windows Phone 7
261*   Windows Phone 8
262*   Windows Phone-8.1