index.md 6.5 KB

cordova-plugin-statusbar

StatusBar

Il StatusBar oggetto fornisce alcune funzioni per personalizzare l'iOS e Android StatusBar.

Installazione

cordova plugin add cordova-plugin-statusbar

Preferenze

config.xml

  • StatusBarOverlaysWebView (boolean, default è true). IOS 7, rendono la statusbar sovrapposizione o la non sovrapposizione WebView all'avvio.

    <preference name="StatusBarOverlaysWebView" value="true" />
    
  • StatusBarBackgroundColor (stringa esadecimale colore, predefinito è #000000). IOS 7, impostare il colore di sfondo della barra di stato di una stringa esadecimale (#RRGGBB) all'avvio.

    <preference name="StatusBarBackgroundColor" value="#000000" />
    
  • StatusBarStyle (status bar in stile, default è lightcontent). IOS 7, impostare lo stile di barra di stato. Predefinita di opzioni disponibili, lightcontent, blacktranslucent, blackopaque.

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

Nascondendo all'avvio

In fase di esecuzione è possibile utilizzare la funzione di StatusBar.hide qui sotto, ma se si desidera che la barra di stato venga nascosta all'avvio di app, è necessario modificare il file info. plist dell'app.

Aggiungere o modificare questi due attributi, se non presente. Impostare la "barra di stato è inizialmente nascosto" a "YES" e "Aspetto di vista basati su controller status bar" a "NO". Se si modifica manualmente senza Xcode, le chiavi e i valori sono:

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

Metodi

Questo plugin definisce globale oggetto StatusBar.

Anche se in ambito globale, non è disponibile fino a dopo l'evento 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

Proprietà

  • StatusBar.isVisible

Autorizzazioni

config.xml

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

StatusBar.overlaysWebView

IOS 7, rendono la statusbar sovrapposizione o non sovrapporre WebView.

StatusBar.overlaysWebView(true);

Descrizione

IOS 7, impostato su false per rendere la barra di stato vengono visualizzati come iOS 6. Impostare il colore di sfondo e stile per soddisfare utilizzando altre funzioni.

Piattaforme supportate

  • iOS

Esempio rapido

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

StatusBar.styleDefault

Utilizzare la barra di stato predefinito (testo scuro, per sfondi di luce).

StatusBar.styleDefault();

Piattaforme supportate

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

StatusBar.styleLightContent

Utilizzare la barra di stato lightContent (testo in chiaro, per sfondi scuri).

StatusBar.styleLightContent();

Piattaforme supportate

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

StatusBar.styleBlackTranslucent

Utilizzare la barra di stato blackTranslucent (testo in chiaro, per sfondi scuri).

StatusBar.styleBlackTranslucent();

Piattaforme supportate

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

StatusBar.styleBlackOpaque

Utilizzare la barra di stato blackOpaque (testo in chiaro, per sfondi scuri).

StatusBar.styleBlackOpaque();

Piattaforme supportate

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

StatusBar.backgroundColorByName

IOS 7, quando StatusBar.statusBarOverlaysWebView è impostata su false, è possibile impostare il colore di sfondo della barra di stato con il nome di colore.

StatusBar.backgroundColorByName("red");

Nomi di colore supportati sono:

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

Piattaforme supportate

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

StatusBar.backgroundColorByHexString

Imposta il colore di sfondo della barra di stato di una stringa esadecimale.

StatusBar.backgroundColorByHexString("#C0C0C0");

Proprietà di scrittura stenografica CSS sono supportati anche.

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

IOS 7, quando StatusBar.statusBarOverlaysWebView è impostata su false, è possibile impostare il colore di sfondo della barra di stato di una stringa esadecimale (#RRGGBB).

Su WP7 e WP8 è inoltre possibile specificare i valori come #AARRGGBB, dove AA è un valore alfa

Piattaforme supportate

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

StatusBar.hide

Nascondere la barra di stato.

StatusBar.hide();

Piattaforme supportate

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

StatusBar.show

Mostra la barra di stato.

StatusBar.show();

Piattaforme supportate

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

StatusBar.isVisible

Leggere questa proprietà per vedere se la barra di stato è visibile o no.

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

Piattaforme supportate

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