You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

275 lines
7.2 KiB

7 years ago
  1. <!---
  2. # license: 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. # cordova-plugin-statusbar
  20. [![Build Status](https://travis-ci.org/apache/cordova-plugin-statusbar.svg)](https://travis-ci.org/apache/cordova-plugin-statusbar)
  21. # StatusBar
  22. > Das `StatusBar` Objekt stellt einige Funktionen zum Anpassen des iOS und Android StatusBar.
  23. ## Installation
  24. cordova plugin add cordova-plugin-statusbar
  25. ## "Einstellungen"
  26. #### "config.xml"
  27. * **StatusBarOverlaysWebView** (Boolean, der Standardwert ist True). Stellen Sie auf iOS 7 die Statusbar-Overlay oder keine Überlagerung der WebView beim Start.
  28. <preference name="StatusBarOverlaysWebView" value="true" />
  29. * **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.
  30. <preference name="StatusBarBackgroundColor" value="#000000" />
  31. * **StatusBarStyle** (Status Bar-Stil, der Standardwert ist Lightcontent). Legen Sie auf iOS 7 den Status-Bar-Stil. Verfügbaren Optionen Standard, Lightcontent, Blacktranslucent, Blackopaque.
  32. <preference name="StatusBarStyle" value="lightcontent" />
  33. ### Android Eigenarten
  34. 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:
  35. ```js
  36. if (cordova.platformId == 'android') {
  37. StatusBar.backgroundColorByHexString("#333");
  38. }
  39. ```
  40. ## Beim Start ausblenden
  41. 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.
  42. 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:
  43. <key>UIStatusBarHidden</key>
  44. <true/>
  45. <key>UIViewControllerBasedStatusBarAppearance</key>
  46. <false/>
  47. ## Methoden
  48. Dieses Plugin wird globales `StatusBar`-Objekt definiert.
  49. Obwohl im globalen Gültigkeitsbereich, steht es nicht bis nach dem `deviceready`-Ereignis.
  50. document.addEventListener("deviceready", onDeviceReady, false);
  51. function onDeviceReady() {
  52. console.log(StatusBar);
  53. }
  54. * StatusBar.overlaysWebView
  55. * StatusBar.styleDefault
  56. * StatusBar.styleLightContent
  57. * StatusBar.styleBlackTranslucent
  58. * StatusBar.styleBlackOpaque
  59. * StatusBar.backgroundColorByName
  60. * StatusBar.backgroundColorByHexString
  61. * StatusBar.hide
  62. * StatusBar.show
  63. ## Eigenschaften
  64. * StatusBar.isVisible
  65. ## Berechtigungen
  66. #### "config.xml"
  67. <feature name="StatusBar">
  68. <param name="ios-package" value="CDVStatusBar" onload="true" />
  69. </feature>
  70. # StatusBar.overlaysWebView
  71. Stellen Sie auf iOS 7 Statusbar überlagern oder nicht überlagert die WebView.
  72. StatusBar.overlaysWebView(true);
  73. ## Beschreibung
  74. 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.
  75. ## Unterstützte Plattformen
  76. * iOS
  77. ## Kurzes Beispiel
  78. StatusBar.overlaysWebView(true);
  79. StatusBar.overlaysWebView(false);
  80. # StatusBar.styleDefault
  81. Verwenden Sie die Standard-Statusbar (dunkle Text, für helle Hintergründe).
  82. StatusBar.styleDefault();
  83. ## Unterstützte Plattformen
  84. * iOS
  85. * Windows Phone 7
  86. * Windows Phone 8
  87. * Windows Phone-8.1
  88. # StatusBar.styleLightContent
  89. Verwenden Sie die LightContent-Statusbar (heller Text, für dunkle Hintergründe).
  90. StatusBar.styleLightContent();
  91. ## Unterstützte Plattformen
  92. * iOS
  93. * Windows Phone 7
  94. * Windows Phone 8
  95. * Windows Phone-8.1
  96. # StatusBar.styleBlackTranslucent
  97. Verwenden Sie die BlackTranslucent-Statusbar (heller Text, für dunkle Hintergründe).
  98. StatusBar.styleBlackTranslucent();
  99. ## Unterstützte Plattformen
  100. * iOS
  101. * Windows Phone 7
  102. * Windows Phone 8
  103. * Windows Phone-8.1
  104. # StatusBar.styleBlackOpaque
  105. Verwenden Sie die BlackOpaque-Statusbar (heller Text, für dunkle Hintergründe).
  106. StatusBar.styleBlackOpaque();
  107. ## Unterstützte Plattformen
  108. * iOS
  109. * Windows Phone 7
  110. * Windows Phone 8
  111. * Windows Phone-8.1
  112. # StatusBar.backgroundColorByName
  113. Auf iOS 7 Wenn Sie StatusBar.statusBarOverlaysWebView auf False festlegen, können Sie die Hintergrundfarbe der Statusbar von Farbnamen festlegen.
  114. StatusBar.backgroundColorByName("red");
  115. Unterstützte Farbnamen sind:
  116. black, darkGray, lightGray, white, gray, red, green, blue, cyan, yellow, magenta, orange, purple, brown
  117. ## Unterstützte Plattformen
  118. * iOS
  119. * Android 5+
  120. * Windows Phone 7
  121. * Windows Phone 8
  122. * Windows Phone-8.1
  123. # StatusBar.backgroundColorByHexString
  124. Legt die Hintergrundfarbe der Statusbar von eine hexadezimale Zeichenfolge fest.
  125. StatusBar.backgroundColorByHexString("#C0C0C0");
  126. CSS-Kurzschrift-Eigenschaften werden ebenfalls unterstützt.
  127. StatusBar.backgroundColorByHexString("#333"); // => #333333
  128. StatusBar.backgroundColorByHexString("#FAB"); // => #FFAABB
  129. Auf iOS 7 Wenn Sie StatusBar.statusBarOverlaysWebView auf False festlegen, können Sie die Hintergrundfarbe der Statusbar von eine hexadezimale Zeichenfolge (#RRGGBB) festlegen.
  130. Auf WP7 und WP8 können Sie auch Werte wie #AARRGGBB, angeben wo AA einen alpha-Wert ist
  131. ## Unterstützte Plattformen
  132. * iOS
  133. * Android 5+
  134. * Windows Phone 7
  135. * Windows Phone 8
  136. * Windows Phone-8.1
  137. # StatusBar.hide
  138. Ausblenden der Statusleiste.
  139. StatusBar.hide();
  140. ## Unterstützte Plattformen
  141. * iOS
  142. * Android
  143. * Windows Phone 7
  144. * Windows Phone 8
  145. * Windows Phone-8.1
  146. # StatusBar.show
  147. Zeigt die Statusleiste.
  148. StatusBar.show();
  149. ## Unterstützte Plattformen
  150. * iOS
  151. * Android
  152. * Windows Phone 7
  153. * Windows Phone 8
  154. * Windows Phone-8.1
  155. # StatusBar.isVisible
  156. Lesen Sie diese Eigenschaft, um festzustellen, ob die Statusbar sichtbar oder nicht ist.
  157. if (StatusBar.isVisible) {
  158. // do something
  159. }
  160. ## Unterstützte Plattformen
  161. * iOS
  162. * Android
  163. * Windows Phone 7
  164. * Windows Phone 8
  165. * Windows Phone-8.1