6.9 KiB
cordova-plugin-statusbar
StatusBar
StatusBar
Obiekt 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