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.1 KiB

7 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. > `StatusBar`Obiekt zawiera kilka funkcji, aby dostosować iOS i Android StatusBar.
  20. ## Instalacja
  21. cordova plugin add cordova-plugin-statusbar
  22. ## Preferencje
  23. #### config.xml
  24. * **StatusBarOverlaysWebView** (boolean, domyślnie na wartość true). Na iOS 7 zrobić nakładki stanu lub nie nakładki widoku sieci Web podczas uruchamiania.
  25. <preference name="StatusBarOverlaysWebView" value="true" />
  26. * **StatusBarBackgroundColor** (kolor szesnastkowy ciąg, domyślnie #000000). Na iOS 7 ustawić kolor tła stanu przez ciąg szesnastkowy (#RRGGBB) przy starcie systemu.
  27. <preference name="StatusBarBackgroundColor" value="#000000" />
  28. * **StatusBarStyle** (stan styl paska, domyślnie lightcontent.) Na iOS 7 ustawić styl paska stanu. Dostępne opcje domyślne, lightcontent, blacktranslucent, blackopaque.
  29. <preference name="StatusBarStyle" value="lightcontent" />
  30. ## Przy starcie
  31. 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.
  32. 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ą:
  33. <key>UIStatusBarHidden</key>
  34. <true/>
  35. <key>UIViewControllerBasedStatusBarAppearance</key>
  36. <false/>
  37. ## Metody
  38. Ten plugin definiuje obiekt globalny `StatusBar`.
  39. Chociaż w globalnym zasięgu, to nie dostępne dopiero po `deviceready` imprezie.
  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. ## Właściwości
  54. * StatusBar.isVisible
  55. ## Uprawnienia
  56. #### config.xml
  57. <feature name="StatusBar">
  58. <param name="ios-package" value="CDVStatusBar" onload="true" />
  59. </feature>
  60. # StatusBar.overlaysWebView
  61. Na iOS 7 zrobić statusbar nakładki lub nie nakładka widoku sieci Web.
  62. StatusBar.overlaysWebView(true);
  63. ## Opis
  64. 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.
  65. ## Obsługiwane platformy
  66. * iOS
  67. ## Szybki przykład
  68. StatusBar.overlaysWebView(true);
  69. StatusBar.overlaysWebView(false);
  70. # StatusBar.styleDefault
  71. Użyj domyślnego stanu (ciemny tekst, teł światła).
  72. StatusBar.styleDefault();
  73. ## Obsługiwane platformy
  74. * iOS
  75. * Windows Phone 7
  76. * Windows Phone 8
  77. * Windows Phone 8.1
  78. # StatusBar.styleLightContent
  79. Użyj lightContent stanu (światło tekst, ciemne tło).
  80. StatusBar.styleLightContent();
  81. ## Obsługiwane platformy
  82. * iOS
  83. * Windows Phone 7
  84. * Windows Phone 8
  85. * Windows Phone 8.1
  86. # StatusBar.styleBlackTranslucent
  87. Użyj blackTranslucent stanu (światło tekst, ciemne tło).
  88. StatusBar.styleBlackTranslucent();
  89. ## Obsługiwane platformy
  90. * iOS
  91. * Windows Phone 7
  92. * Windows Phone 8
  93. * Windows Phone 8.1
  94. # StatusBar.styleBlackOpaque
  95. Użyj blackOpaque stanu (światło tekst, ciemne tło).
  96. StatusBar.styleBlackOpaque();
  97. ## Obsługiwane platformy
  98. * iOS
  99. * Windows Phone 7
  100. * Windows Phone 8
  101. * Windows Phone 8.1
  102. # StatusBar.backgroundColorByName
  103. Na iOS 7 gdy zostanie ustawiona wartość false, StatusBar.statusBarOverlaysWebView można ustawić kolor tła stanu przez nazwę koloru.
  104. StatusBar.backgroundColorByName("red");
  105. Nazwy kolorów obsługiwane są:
  106. black, darkGray, lightGray, white, gray, red, green, blue, cyan, yellow, magenta, orange, purple, brown
  107. ## Obsługiwane platformy
  108. * iOS
  109. * Windows Phone 7
  110. * Windows Phone 8
  111. * Windows Phone 8.1
  112. # StatusBar.backgroundColorByHexString
  113. Ustawia kolor tła stanu przez ciąg szesnastkowy.
  114. StatusBar.backgroundColorByHexString("#C0C0C0");
  115. Obsługiwane są również właściwości CSS.
  116. StatusBar.backgroundColorByHexString("#333"); // => #333333
  117. StatusBar.backgroundColorByHexString("#FAB"); // => #FFAABB
  118. Na iOS 7 gdy zostanie ustawiona wartość false, StatusBar.statusBarOverlaysWebView można ustawić kolor tła stanu przez ciąg szesnastkowy (#RRGGBB).
  119. Na WP7 i WP8 można również określić wartości jako #AARRGGBB, gdzie AA jest wartością alfa
  120. ## Obsługiwane platformy
  121. * iOS
  122. * Windows Phone 7
  123. * Windows Phone 8
  124. * Windows Phone 8.1
  125. # StatusBar.hide
  126. Ukryj pasek stanu.
  127. StatusBar.hide();
  128. ## Obsługiwane platformy
  129. * iOS
  130. * Android
  131. * Windows Phone 7
  132. * Windows Phone 8
  133. * Windows Phone 8.1
  134. # StatusBar.show
  135. Pokazuje pasek stanu.
  136. StatusBar.show();
  137. ## Obsługiwane platformy
  138. * iOS
  139. * Android
  140. * Windows Phone 7
  141. * Windows Phone 8
  142. * Windows Phone 8.1
  143. # StatusBar.isVisible
  144. Czytać tej właściwość, aby sprawdzić, czy stanu jest widoczne lub nie.
  145. if (StatusBar.isVisible) {
  146. // do something
  147. }
  148. ## Obsługiwane platformy
  149. * iOS
  150. * Android
  151. * Windows Phone 7
  152. * Windows Phone 8
  153. * Windows Phone 8.1