<!--- # license: Licensed to the Apache Software Foundation (ASF) under one # or more contributor license agreements. See the NOTICE file # distributed with this work for additional information # regarding copyright ownership. The ASF licenses this file # to you under the Apache License, Version 2.0 (the # "License"); you may not use this file except in compliance # with the License. You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, # software distributed under the License is distributed on an # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. --> # cordova-plugin-statusbar [![Build Status](https://travis-ci.org/apache/cordova-plugin-statusbar.svg)](https://travis-ci.org/apache/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: ```js 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