README.md 7.43 KB

cordova-plugin-statusbar

Build Status

StatusBar

StatusBar개체 iOS와 안 드 로이드 상태 표시줄을 사용자 지정 하려면 몇 가지 기능을 제공 합니다.

설치

cordova plugin add cordova-plugin-statusbar

환경 설정

config.xml

  • StatusBarOverlaysWebView (boolean, 기본값: true)입니다. IOS 7, 시작 시 상태 표시줄 오버레이 또는 WebView 중첩 되지 확인 합니다.

    <preference name="StatusBarOverlaysWebView" value="true" />
  • StatusBarBackgroundColor (색상 16 진수 문자열 기본값: #000000). IOS에서 7과 안 드 로이드 5 시작 시 16 진수 문자열 (#RRGGBB) 상태 표시줄의 배경색을 설정 합니다.

    <preference name="StatusBarBackgroundColor" value="#000000" />
  • StatusBarStyle (상태 표시줄 스타일, 기본값: lightcontent). Ios 7, 상태 표시줄 스타일을 설정 합니다. 사용 가능한 옵션 기본, lightcontent, blacktranslucent, blackopaque.

    <preference name="StatusBarStyle" value="lightcontent" />

안 드 로이드 단점

안 드 로이드 5 + 지침 보다 귀하의 주요 응용 프로그램 상태 표시줄에 대 한 다른 색을 사용 하 여 지정한 색상 (와 달리 균일 한 상태 표시줄의 색상 많은 iOS 7 + 애플 리 케이 션), StatusBar.backgroundColorByHexString 또는 StatusBar.backgroundColorByName를 통해 대신 런타임에 상태 표시줄 색을 설정 하고자 할 수 있습니다. 한 가지 방법은 일 것입니다.

if (cordova.platformId == 'android') {
    StatusBar.backgroundColorByHexString("#333");
}

시작 시 숨기기

런타임 동안 아래의 StatusBar.hide 함수를 사용할 수 있습니다 하지만 당신이 원하는 응용 프로그램 시작 시 숨겨진 상태 표시줄, 응용 프로그램의 Info.plist 파일 수정 해야 합니다.

추가 편집이 두 특성이 없는 경우. "상태 표시줄 처음 숨겨진" "YES" 로 설정 하 고 "뷰 컨트롤러 기반 상태 표시줄 모양" **"NO"**로 설정 합니다. Xcode, 열쇠 없이 수동으로 편집 하는 경우 값은:

<key>UIStatusBarHidden</key>
<true/>
<key>UIViewControllerBasedStatusBarAppearance</key>
<false/>

메서드

이 플러그인 글로벌 StatusBar 개체를 정의합니다.

전역 범위에 있지만 그것은 불가능까지 deviceready 이벤트 후.

document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
    console.log(StatusBar);
}
  • StatusBar.overlaysWebView
  • StatusBar.styleDefault
  • StatusBar.styleLightContent
  • StatusBar.styleBlackTranslucent
  • StatusBar.styleBlackOpaque
  • StatusBar.backgroundColorByName
  • StatusBar.backgroundColorByHexString
  • StatusBar.hide
  • StatusBar.show

속성

  • StatusBar.isVisible

사용 권한

config.xml

        <feature name="StatusBar">
            <param name="ios-package" value="CDVStatusBar" onload="true" />
        </feature>

StatusBar.overlaysWebView

IOS 7, 오버레이 또는 하지 WebView 중첩 상태 표시줄을 확인 합니다.

StatusBar.overlaysWebView(true);

설명

7 iOS, iOS 6 처럼 나타나는 상태 표시줄을 false로 설정 합니다. 다른 함수를 사용 하 여에 맞게 스타일과 배경 색상을 설정 합니다.

지원 되는 플랫폼

  • iOS

빠른 예제

StatusBar.overlaysWebView(true);
StatusBar.overlaysWebView(false);

StatusBar.styleDefault

기본 상태 표시줄 (어두운 텍스트, 밝은 배경에 대 한)를 사용 합니다.

StatusBar.styleDefault();

지원 되는 플랫폼

  • iOS
  • Windows Phone 7
  • Windows Phone 8
  • Windows Phone 8.1

StatusBar.styleLightContent

LightContent 상태 표시줄 (어두운 배경에 대 한 가벼운 텍스트)을 사용 합니다.

StatusBar.styleLightContent();

지원 되는 플랫폼

  • iOS
  • Windows Phone 7
  • Windows Phone 8
  • Windows Phone 8.1

StatusBar.styleBlackTranslucent

BlackTranslucent 상태 표시줄 (어두운 배경에 대 한 가벼운 텍스트)을 사용 합니다.

StatusBar.styleBlackTranslucent();

지원 되는 플랫폼

  • iOS
  • Windows Phone 7
  • Windows Phone 8
  • Windows Phone 8.1

StatusBar.styleBlackOpaque

BlackOpaque 상태 표시줄 (어두운 배경에 대 한 가벼운 텍스트)을 사용 합니다.

StatusBar.styleBlackOpaque();

지원 되는 플랫폼

  • iOS
  • Windows Phone 7
  • Windows Phone 8
  • Windows Phone 8.1

StatusBar.backgroundColorByName

Ios 7, StatusBar.statusBarOverlaysWebView을 false로 설정 하면 설정할 수 있는 상태 표시줄의 배경색 색상 이름으로.

StatusBar.backgroundColorByName("red");

지원 되는 색 이름입니다.

black, darkGray, lightGray, white, gray, red, green, blue, cyan, yellow, magenta, orange, purple, brown

지원 되는 플랫폼

  • iOS
  • Android 5+
  • Windows Phone 7
  • Windows Phone 8
  • Windows Phone 8.1

StatusBar.backgroundColorByHexString

16 진수 문자열 상태 표시줄의 배경색을 설정합니다.

StatusBar.backgroundColorByHexString("#C0C0C0");

CSS 대표 속성 지원 됩니다.

StatusBar.backgroundColorByHexString("#333"); // => #333333
StatusBar.backgroundColorByHexString("#FAB"); // => #FFAABB

Ios 7, StatusBar.statusBarOverlaysWebView을 false로 설정 하면 설정할 수 있는 상태 표시줄의 배경색 16 진수 문자열 (#RRGGBB)에 의해.

WP7 및 WP8에 당신은 또한 #AARRGGBB, AA는 알파 값으로 값을 지정할 수 있습니다.

지원 되는 플랫폼

  • iOS
  • Android 5+
  • Windows Phone 7
  • Windows Phone 8
  • Windows Phone 8.1

StatusBar.hide

숨기기 상태 표시줄.

StatusBar.hide();

지원 되는 플랫폼

  • iOS
  • 안 드 로이드
  • Windows Phone 7
  • Windows Phone 8
  • Windows Phone 8.1

StatusBar.show

상태 표시줄을 표시합니다.

StatusBar.show();

지원 되는 플랫폼

  • iOS
  • 안 드 로이드
  • Windows Phone 7
  • Windows Phone 8
  • Windows Phone 8.1

StatusBar.isVisible

이 속성을 상태 표시줄 표시 되는 경우 읽기.

if (StatusBar.isVisible) {
    // do something
}

지원 되는 플랫폼

  • iOS
  • 안 드 로이드
  • Windows Phone 7
  • Windows Phone 8
  • Windows Phone 8.1