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
6.9 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. > `StatusBar`Obiekt zawiera kilka funkcji, aby dostosować iOS i Android StatusBar.
  23. ## Instalacja
  24. cordova plugin add cordova-plugin-statusbar
  25. ## Preferencje
  26. #### config.xml
  27. * **StatusBarOverlaysWebView** (boolean, domyślnie na wartość true). Na iOS 7 zrobić nakładki stanu lub nie nakładki widoku sieci Web podczas uruchamiania.
  28. <preference name="StatusBarOverlaysWebView" value="true" />
  29. * **StatusBarBackgroundColor** (kolor ciąg szesnastkowy, domyślnie #000000). Na iOS 7 i Android 5 kolor tła stanu przez ciąg szesnastkowy (#RRGGBB) przy starcie systemu.
  30. <preference name="StatusBarBackgroundColor" value="#000000" />
  31. * **StatusBarStyle** (stan styl paska, domyślnie lightcontent.) Na iOS 7 ustawić styl paska stanu. Dostępne opcje domyślne, lightcontent, blacktranslucent, blackopaque.
  32. <preference name="StatusBarStyle" value="lightcontent" />
  33. ### Dziwactwa Androida
  34. Android 5 + wytyczne określają przy użyciu różnych kolorów statusbar niż główne aplikacji kolor (w przeciwieństwie do stanu jednolitych kolorów wiele aplikacje iOS 7 +), więc może chcesz ustawić kolor pasek stanu w czasie wykonywania zamiast za pośrednictwem `StatusBar.backgroundColorByHexString` lub `StatusBar.backgroundColorByName`. Jednym sposobem na to byłoby:
  35. ```js
  36. if (cordova.platformId == 'android') {
  37. StatusBar.backgroundColorByHexString("#333");
  38. }
  39. ```
  40. ## Przy starcie
  41. Podczas uruchamiania można użyć funkcji StatusBar.hide poniżej, ale jeśli chcesz StatusBar ukryty w uruchamiania aplikacji, należy zmodyfikować plik Info.plist Twojej aplikacji.
  42. Dodawanie/edycja tych dwóch atrybutów jeśli nie obecny. Ustawianie **"pasek stanu jest początkowo ukryte"** na **"Tak"** i **"Oparte na kontroler stanu paska wygląd"** na **"Nie"**. Jeśli możesz go edytować ręcznie bez Xcode, kluczy i wartości są:
  43. <key>UIStatusBarHidden</key>
  44. <true/>
  45. <key>UIViewControllerBasedStatusBarAppearance</key>
  46. <false/>
  47. ## Metody
  48. Ten plugin definiuje obiekt globalny `StatusBar`.
  49. Chociaż w globalnym zasięgu, to nie dostępne dopiero po `deviceready` imprezie.
  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. ## Właściwości
  64. * StatusBar.isVisible
  65. ## Uprawnienia
  66. #### config.xml
  67. <feature name="StatusBar">
  68. <param name="ios-package" value="CDVStatusBar" onload="true" />
  69. </feature>
  70. # StatusBar.overlaysWebView
  71. Na iOS 7 zrobić statusbar nakładki lub nie nakładka widoku sieci Web.
  72. StatusBar.overlaysWebView(true);
  73. ## Opis
  74. Na iOS 7 zestaw do false, aby na pasku stanu pojawia się jak iOS 6. Ustaw kolor tła i styl do korzystania z innych funkcji.
  75. ## Obsługiwane platformy
  76. * iOS
  77. ## Szybki przykład
  78. StatusBar.overlaysWebView(true);
  79. StatusBar.overlaysWebView(false);
  80. # StatusBar.styleDefault
  81. Użyj domyślnego stanu (ciemny tekst, teł światła).
  82. StatusBar.styleDefault();
  83. ## Obsługiwane platformy
  84. * iOS
  85. * Windows Phone 7
  86. * Windows Phone 8
  87. * Windows Phone 8.1
  88. # StatusBar.styleLightContent
  89. Użyj lightContent stanu (światło tekst, ciemne tło).
  90. StatusBar.styleLightContent();
  91. ## Obsługiwane platformy
  92. * iOS
  93. * Windows Phone 7
  94. * Windows Phone 8
  95. * Windows Phone 8.1
  96. # StatusBar.styleBlackTranslucent
  97. Użyj blackTranslucent stanu (światło tekst, ciemne tło).
  98. StatusBar.styleBlackTranslucent();
  99. ## Obsługiwane platformy
  100. * iOS
  101. * Windows Phone 7
  102. * Windows Phone 8
  103. * Windows Phone 8.1
  104. # StatusBar.styleBlackOpaque
  105. Użyj blackOpaque stanu (światło tekst, ciemne tło).
  106. StatusBar.styleBlackOpaque();
  107. ## Obsługiwane platformy
  108. * iOS
  109. * Windows Phone 7
  110. * Windows Phone 8
  111. * Windows Phone 8.1
  112. # StatusBar.backgroundColorByName
  113. Na iOS 7 gdy zostanie ustawiona wartość false, StatusBar.statusBarOverlaysWebView można ustawić kolor tła stanu przez nazwę koloru.
  114. StatusBar.backgroundColorByName("red");
  115. Nazwy kolorów obsługiwane są:
  116. black, darkGray, lightGray, white, gray, red, green, blue, cyan, yellow, magenta, orange, purple, brown
  117. ## Obsługiwane platformy
  118. * iOS
  119. * Android 5+
  120. * Windows Phone 7
  121. * Windows Phone 8
  122. * Windows Phone 8.1
  123. # StatusBar.backgroundColorByHexString
  124. Ustawia kolor tła stanu przez ciąg szesnastkowy.
  125. StatusBar.backgroundColorByHexString("#C0C0C0");
  126. Obsługiwane są również właściwości CSS.
  127. StatusBar.backgroundColorByHexString("#333"); // => #333333
  128. StatusBar.backgroundColorByHexString("#FAB"); // => #FFAABB
  129. Na iOS 7 gdy zostanie ustawiona wartość false, StatusBar.statusBarOverlaysWebView można ustawić kolor tła stanu przez ciąg szesnastkowy (#RRGGBB).
  130. Na WP7 i WP8 można również określić wartości jako #AARRGGBB, gdzie AA jest wartością alfa
  131. ## Obsługiwane platformy
  132. * iOS
  133. * Android 5+
  134. * Windows Phone 7
  135. * Windows Phone 8
  136. * Windows Phone 8.1
  137. # StatusBar.hide
  138. Ukryj pasek stanu.
  139. StatusBar.hide();
  140. ## Obsługiwane platformy
  141. * iOS
  142. * Android
  143. * Windows Phone 7
  144. * Windows Phone 8
  145. * Windows Phone 8.1
  146. # StatusBar.show
  147. Pokazuje pasek stanu.
  148. StatusBar.show();
  149. ## Obsługiwane platformy
  150. * iOS
  151. * Android
  152. * Windows Phone 7
  153. * Windows Phone 8
  154. * Windows Phone 8.1
  155. # StatusBar.isVisible
  156. Czytać tej właściwość, aby sprawdzić, czy stanu jest widoczne lub nie.
  157. if (StatusBar.isVisible) {
  158. // do something
  159. }
  160. ## Obsługiwane platformy
  161. * iOS
  162. * Android
  163. * Windows Phone 7
  164. * Windows Phone 8
  165. * Windows Phone 8.1