tree: 7b07b4b93c021cd66483b25f7de80c9429a542ca [path history] [tgz]
  1. index.md
  2. README.md
doc/pl/README.md

cordova-plugin-statusbar

Build Status

StatusBar

StatusBarObiekt zawiera kilka funkcji, aby dostosować iOS i Android StatusBar.

Instalacja

cordova plugin add cordova-plugin-statusbar

Preferencje

config.xml

  • StatusBarOverlaysWebView (boolean, domyślnie na wartość true). Na iOS 7 zrobić nakładki stanu lub nie nakładki widoku sieci Web podczas uruchamiania.

    <preference name="StatusBarOverlaysWebView" value="true" />
    
  • 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.

    <preference name="StatusBarBackgroundColor" value="#000000" />
    
  • StatusBarStyle (stan styl paska, domyślnie lightcontent.) Na iOS 7 ustawić styl paska stanu. Dostępne opcje domyślne, lightcontent, blacktranslucent, blackopaque.

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

Dziwactwa Androida

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:

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

Przy starcie

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.

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ą:

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

Metody

Ten plugin definiuje obiekt globalny StatusBar.

Chociaż w globalnym zasięgu, to nie dostępne dopiero po deviceready imprezie.

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

Właściwości

  • StatusBar.isVisible

Uprawnienia

config.xml

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

StatusBar.overlaysWebView

Na iOS 7 zrobić statusbar nakładki lub nie nakładka widoku sieci Web.

StatusBar.overlaysWebView(true);

Opis

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.

Obsługiwane platformy

  • iOS

Szybki przykład

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

StatusBar.styleDefault

Użyj domyślnego stanu (ciemny tekst, teł światła).

StatusBar.styleDefault();

Obsługiwane platformy

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

StatusBar.styleLightContent

Użyj lightContent stanu (światło tekst, ciemne tło).

StatusBar.styleLightContent();

Obsługiwane platformy

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

StatusBar.styleBlackTranslucent

Użyj blackTranslucent stanu (światło tekst, ciemne tło).

StatusBar.styleBlackTranslucent();

Obsługiwane platformy

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

StatusBar.styleBlackOpaque

Użyj blackOpaque stanu (światło tekst, ciemne tło).

StatusBar.styleBlackOpaque();

Obsługiwane platformy

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

StatusBar.backgroundColorByName

Na iOS 7 gdy zostanie ustawiona wartość false, StatusBar.statusBarOverlaysWebView można ustawić kolor tła stanu przez nazwę koloru.

StatusBar.backgroundColorByName("red");

Nazwy kolorów obsługiwane są:

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

Obsługiwane platformy

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

StatusBar.backgroundColorByHexString

Ustawia kolor tła stanu przez ciąg szesnastkowy.

StatusBar.backgroundColorByHexString("#C0C0C0");

Obsługiwane są również właściwości CSS.

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

Na iOS 7 gdy zostanie ustawiona wartość false, StatusBar.statusBarOverlaysWebView można ustawić kolor tła stanu przez ciąg szesnastkowy (#RRGGBB).

Na WP7 i WP8 można również określić wartości jako #AARRGGBB, gdzie AA jest wartością alfa

Obsługiwane platformy

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

StatusBar.hide

Ukryj pasek stanu.

StatusBar.hide();

Obsługiwane platformy

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

StatusBar.show

Pokazuje pasek stanu.

StatusBar.show();

Obsługiwane platformy

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

StatusBar.isVisible

Czytać tej właściwość, aby sprawdzić, czy stanu jest widoczne lub nie.

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

Obsługiwane platformy

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