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.4 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`개체 iOS와 안 드 로이드 상태 표시줄을 사용자 지정 하려면 몇 가지 기능을 제공 합니다.
  23. ## 설치
  24. cordova plugin add cordova-plugin-statusbar
  25. ## 환경 설정
  26. #### config.xml
  27. * **StatusBarOverlaysWebView** (boolean, 기본값: true)입니다. IOS 7, 시작 시 상태 표시줄 오버레이 또는 WebView 중첩 되지 확인 합니다.
  28. <preference name="StatusBarOverlaysWebView" value="true" />
  29. * **StatusBarBackgroundColor** (색상 16 진수 문자열 기본값: #000000). IOS에서 7과 안 드 로이드 5 시작 시 16 진수 문자열 (#RRGGBB) 상태 표시줄의 배경색을 설정 합니다.
  30. <preference name="StatusBarBackgroundColor" value="#000000" />
  31. * **StatusBarStyle** (상태 표시줄 스타일, 기본값: lightcontent). Ios 7, 상태 표시줄 스타일을 설정 합니다. 사용 가능한 옵션 기본, lightcontent, blacktranslucent, blackopaque.
  32. <preference name="StatusBarStyle" value="lightcontent" />
  33. ### 안 드 로이드 단점
  34. 안 드 로이드 5 + 지침 보다 귀하의 주요 응용 프로그램 상태 표시줄에 대 한 다른 색을 사용 하 여 지정한 색상 (와 달리 균일 한 상태 표시줄의 색상 많은 iOS 7 + 애플 리 케이 션), `StatusBar.backgroundColorByHexString` 또는 `StatusBar.backgroundColorByName`를 통해 대신 런타임에 상태 표시줄 색을 설정 하고자 할 수 있습니다. 한 가지 방법은 일 것입니다.
  35. ```js
  36. if (cordova.platformId == 'android') {
  37. StatusBar.backgroundColorByHexString("#333");
  38. }
  39. ```
  40. ## 시작 시 숨기기
  41. 런타임 동안 아래의 StatusBar.hide 함수를 사용할 수 있습니다 하지만 당신이 원하는 응용 프로그램 시작 시 숨겨진 상태 표시줄, 응용 프로그램의 Info.plist 파일 수정 해야 합니다.
  42. 추가 편집이 두 특성이 없는 경우. **"상태 표시줄 처음 숨겨진"** **"YES"** 로 설정 하 고 **"뷰 컨트롤러 기반 상태 표시줄 모양"** **"NO"**로 설정 합니다. Xcode, 열쇠 없이 수동으로 편집 하는 경우 값은:
  43. <key>UIStatusBarHidden</key>
  44. <true/>
  45. <key>UIViewControllerBasedStatusBarAppearance</key>
  46. <false/>
  47. ## 메서드
  48. 이 플러그인 글로벌 `StatusBar` 개체를 정의합니다.
  49. 전역 범위에 있지만 그것은 불가능까지 `deviceready` 이벤트 후.
  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. ## 속성
  64. * StatusBar.isVisible
  65. ## 사용 권한
  66. #### config.xml
  67. <feature name="StatusBar">
  68. <param name="ios-package" value="CDVStatusBar" onload="true" />
  69. </feature>
  70. # StatusBar.overlaysWebView
  71. IOS 7, 오버레이 또는 하지 WebView 중첩 상태 표시줄을 확인 합니다.
  72. StatusBar.overlaysWebView(true);
  73. ## 설명
  74. 7 iOS, iOS 6 처럼 나타나는 상태 표시줄을 false로 설정 합니다. 다른 함수를 사용 하 여에 맞게 스타일과 배경 색상을 설정 합니다.
  75. ## 지원 되는 플랫폼
  76. * iOS
  77. ## 빠른 예제
  78. StatusBar.overlaysWebView(true);
  79. StatusBar.overlaysWebView(false);
  80. # StatusBar.styleDefault
  81. 기본 상태 표시줄 (어두운 텍스트, 밝은 배경에 대 한)를 사용 합니다.
  82. StatusBar.styleDefault();
  83. ## 지원 되는 플랫폼
  84. * iOS
  85. * Windows Phone 7
  86. * Windows Phone 8
  87. * Windows Phone 8.1
  88. # StatusBar.styleLightContent
  89. LightContent 상태 표시줄 (어두운 배경에 대 한 가벼운 텍스트)을 사용 합니다.
  90. StatusBar.styleLightContent();
  91. ## 지원 되는 플랫폼
  92. * iOS
  93. * Windows Phone 7
  94. * Windows Phone 8
  95. * Windows Phone 8.1
  96. # StatusBar.styleBlackTranslucent
  97. BlackTranslucent 상태 표시줄 (어두운 배경에 대 한 가벼운 텍스트)을 사용 합니다.
  98. StatusBar.styleBlackTranslucent();
  99. ## 지원 되는 플랫폼
  100. * iOS
  101. * Windows Phone 7
  102. * Windows Phone 8
  103. * Windows Phone 8.1
  104. # StatusBar.styleBlackOpaque
  105. BlackOpaque 상태 표시줄 (어두운 배경에 대 한 가벼운 텍스트)을 사용 합니다.
  106. StatusBar.styleBlackOpaque();
  107. ## 지원 되는 플랫폼
  108. * iOS
  109. * Windows Phone 7
  110. * Windows Phone 8
  111. * Windows Phone 8.1
  112. # StatusBar.backgroundColorByName
  113. Ios 7, StatusBar.statusBarOverlaysWebView을 false로 설정 하면 설정할 수 있는 상태 표시줄의 배경색 색상 이름으로.
  114. StatusBar.backgroundColorByName("red");
  115. 지원 되는 색 이름입니다.
  116. black, darkGray, lightGray, white, gray, red, green, blue, cyan, yellow, magenta, orange, purple, brown
  117. ## 지원 되는 플랫폼
  118. * iOS
  119. * Android 5+
  120. * Windows Phone 7
  121. * Windows Phone 8
  122. * Windows Phone 8.1
  123. # StatusBar.backgroundColorByHexString
  124. 16 진수 문자열 상태 표시줄의 배경색을 설정합니다.
  125. StatusBar.backgroundColorByHexString("#C0C0C0");
  126. CSS 대표 속성 지원 됩니다.
  127. StatusBar.backgroundColorByHexString("#333"); // => #333333
  128. StatusBar.backgroundColorByHexString("#FAB"); // => #FFAABB
  129. Ios 7, StatusBar.statusBarOverlaysWebView을 false로 설정 하면 설정할 수 있는 상태 표시줄의 배경색 16 진수 문자열 (#RRGGBB)에 의해.
  130. WP7 및 WP8에 당신은 또한 #AARRGGBB, AA는 알파 값으로 값을 지정할 수 있습니다.
  131. ## 지원 되는 플랫폼
  132. * iOS
  133. * Android 5+
  134. * Windows Phone 7
  135. * Windows Phone 8
  136. * Windows Phone 8.1
  137. # StatusBar.hide
  138. 숨기기 상태 표시줄.
  139. StatusBar.hide();
  140. ## 지원 되는 플랫폼
  141. * iOS
  142. * 안 드 로이드
  143. * Windows Phone 7
  144. * Windows Phone 8
  145. * Windows Phone 8.1
  146. # StatusBar.show
  147. 상태 표시줄을 표시합니다.
  148. StatusBar.show();
  149. ## 지원 되는 플랫폼
  150. * iOS
  151. * 안 드 로이드
  152. * Windows Phone 7
  153. * Windows Phone 8
  154. * Windows Phone 8.1
  155. # StatusBar.isVisible
  156. 이 속성을 상태 표시줄 표시 되는 경우 읽기.
  157. if (StatusBar.isVisible) {
  158. // do something
  159. }
  160. ## 지원 되는 플랫폼
  161. * iOS
  162. * 안 드 로이드
  163. * Windows Phone 7
  164. * Windows Phone 8
  165. * Windows Phone 8.1