Splashscreen

Visualizza e nasconde la schermata iniziale dell'applicazione.

Metodi

• splashscreen
• splashscreen.Hide

La funzionalità di accesso

A partire dalla versione 3.0, Cordova implementa le API a livello di dispositivo come plugin. Utilizzare la CLI plugin comando, descritto in Command-Line Interface, aggiungere o rimuovere questa funzionalità per un progetto:

    $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-splashscreen.git
    $ cordova plugin rm org.apache.cordova.core.splashscreen

Questi comandi si applicano a tutte le piattaforme mirate, ma modificano le impostazioni di configurazione specifiche della piattaforma descritte di seguito:

• Android (inapp/res/xml/config.xml)

  <feature name="SplashScreen">
      <param name="android-package" value="org.apache.cordova.SplashScreen" />
  </feature>
  

• iOS (inconfig.xml)

  <feature name="SplashScreen">
      <param name="ios-package" value="CDVSplashScreen" />
  </feature>
  

Alcune piattaforme possono supportare questa funzionalità senza richiedere alcuna configurazione speciale. Per una panoramica, vedere supporto della piattaforma.

Installazione

Android

1. Copiare l'immagine della schermata iniziale del progetto Android res/drawable directory. La dimensione di ogni immagine dovrebbe essere:

2. XLarge (xhdpi): almeno 960 × 720

3. grande (hdpi): almeno 640 × 480
4. medio (mdpi): almeno 470 × 320

5. piccolo (ldpi): almeno 426 × 320

   È consigliabile utilizzare un' immagine 9-patch per la schermata iniziale.

6. Nel onCreate metodo della classe che estende DroidGap , aggiungere le seguenti due righe:

   super.setIntegerProperty("splashscreen", R.drawable.splash);
   super.loadUrl(Config.getStartUrl(), 10000);
   

   La prima riga imposta l'immagine da visualizzare come splashscreen. Se è il nome tuo immagine niente altro che splash.png , è necessario modificare questa linea. La seconda linea è la normale super.loadUrl linea, ma ha un secondo parametro che specifica un valore di timeout per la schermata iniziale. In questo esempio la schermata iniziale viene visualizzato per 10 secondi. Per chiudere la schermata iniziale una volta che l'app riceve il deviceready evento, chiamare il navigator.splashscreen.hide() metodo.

iOS

Copiare le immagini di schermata iniziale del progetto iOS Resources/splash directory. Aggiungere solo le immagini per i dispositivi che si desidera supportare, come iPad o iPhone. La dimensione di ogni immagine dovrebbe essere:

• Default-568h@2x~iPhone.png (1136 x 640 pixel)
• Default-Landscape@2x~ipad.png (1496 x 2048 pixel)
• Default-Landscape~ipad.png (748 x 1024 pixel)
• Default-Portrait@2x~ipad.png (2008 x 1536 pixel)
• Default-Portrait~ipad.png (1004 x 768 pixel)
• Default@2x~iPhone.png (640 x 960 pixel)
• Default~iPhone.png (320 x 480 pixel)

---

splashscreen

Visualizza la schermata iniziale.

navigator.splashscreen.show();

Descrizione

Questo metodo visualizza la schermata iniziale dell'applicazione.

Piattaforme supportate

• Android
• BlackBerry 10
• iOS
• Windows Phone 7 e 8
• Windows 8

Esempio rapido

navigator.splashscreen.show();

Esempio completo

<!DOCTYPE html>
<html>
  <head>
    <title>Splashscreen Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available
    //
    function onDeviceReady() {
        navigator.splashscreen.show();
    }

    </script>
  </head>
  <body>
    <h1>Example</h1>
  </body>
</html>

---

splashscreen.Hide

Respingere la schermata iniziale.

navigator.splashscreen.hide();

Descrizione

Questo metodo è respinto la schermata iniziale dell'applicazione.

Piattaforme supportate

• Android
• BlackBerry 10
• iOS
• Windows Phone 7 e 8
• Windows 8

Esempio rapido

navigator.splashscreen.hide();

Esempio completo

<!DOCTYPE html>
<html>
  <head>
    <title>Splashscreen Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available
    //
    function onDeviceReady() {
        navigator.splashscreen.hide();
    }

    </script>
  </head>
  <body>
    <h1>Example</h1>
  </body>
</html>

iOS Quirk

Il config.xml di file AutoHideSplashScreen impostazione deve essere false . Per ritardare nascondendo la schermata iniziale per due secondi, aggiungere un timer ad esempio nel deviceready gestore di evento:

    setTimeout(function() {
        navigator.splashscreen.hide();
    }, 2000);