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.

262 lines
6.5 KiB

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