No Description

README.md 5.8KB

cordova-plugin-splashscreen

Build Status

Este plugin muestra y esconde una pantalla de bienvenida durante el inicio de la aplicación.

Instalación

// npm hosted (new) id
cordova plugin add cordova-plugin-splashscreen
// you may also install directly from this repo
cordova plugin add https://github.com/apache/cordova-plugin-splashscreen.git

Plataformas soportadas

  • Amazon fire OS
  • Android
  • BlackBerry 10
  • iOS
  • Windows Phone 7 y 8
  • Windows 8
  • Windows
  • Explorador

Métodos

  • splashscreen.show
  • splashscreen.hide

Rarezas Android

En el archivo config.xml, es necesario agregar las siguientes preferencias:

<preference name="SplashScreen" value="foo" />
<preference name="SplashScreenDelay" value="10000" />
<preference name="SplashMaintainAspectRatio" value="true|false" />

Donde foo es el nombre del archivo splashscreen, preferiblemente un archivo de 9 parche. Asegúrese de agregar tus archivos splashcreen en tu directorio res/xml bajo las carpetas apropiadas. El segundo parámetro representa cuánto aparecerán el splashscreen en milisegundos. Valor predeterminado es ms 3000. Ver los iconos y salpicadura pantallas para obtener más información.

Preferencia “SplashMaintainAspectRatio” es opcional. Si establece en true, pantalla dibujable no es estirado para caber la pantalla, pero en su lugar simplemente “cover” la pantalla, como CSS “background-size: cover”. Esto es muy útil cuando las imágenes de pantallas splash no distorsionadas de cualquier manera, por ejemplo cuando contienen texto o paisaje. Esta opción funciona mejor con imágenes que tienen bordes grandes (zonas seguras) que pueden ser recortadas con seguridad en pantallas con diferentes relaciones de aspecto.

El plugin recarga splash dibujable cuando cambia de orientación, por lo que puede especificar diferente dibujo para orientaciones vertical y horizontal.

Navegador rarezas

Puede utilizar las siguientes preferencias en el archivo config.xml:

<platform name="browser">
    <preference name="SplashScreen" value="images/browser/splashscreen.jpg" /> <!-- defaults to "img/logo.png" -->
    <preference name="SplashScreenDelay" value="10000" /> <!-- defaults to "3000" -->
    <preference name="SplashScreenBackgroundColor" value="green" /> <!-- defaults to "#464646" -->
    <preference name="ShowSplashScreen" value="false" /> <!-- defaults to "true" -->
    <preference name="SplashScreenWidth" value="600" /> <!-- defaults to "170" -->
    <preference name="SplashScreenHeight" value="300" /> <!-- defaults to "200" -->
</platform>

iOS rarezas

  • FadeSplashScreen (booleano, por defecto true): establecida en false para evitar que la pantalla de bienvenida de descolorarse adentro y hacia fuera cuando cambia su estado de presentación.

    <preference name="FadeSplashScreen" value="false"/>
    
  • FadeSplashScreenDuration (float, por defecto es 2): especifica el número de segundos para que la pantalla se descolora efecto para ejecutar.

    <preference name="FadeSplashScreenDuration" value="4"/>
    
  • ShowSplashScreenSpinner (booleano, por defecto true): establecida en false para ocultar la ruleta de la pantalla de bienvenida.

    <preference name="ShowSplashScreenSpinner" value="false"/>
    

splashscreen.hide

Despedir a la pantalla de bienvenida.

navigator.splashscreen.hide();

BlackBerry 10, WP8, iOS Quirk

El config.xml del archivo AutoHideSplashScreen la configuración debe ser false . Para retrasar oculta la pantalla splash durante dos segundos, agregue un temporizador como la siguiente en el deviceready controlador de eventos:

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

splashscreen.show

Muestra la pantalla de bienvenida.

navigator.splashscreen.show();

La aplicación no se puede llamar navigator.splashscreen.show() hasta que haya iniciado la aplicación y el deviceready evento ha despedido. Pero puesto que normalmente la pantalla está destinada a ser visible antes de que comience su aplicación, que parecería que el propósito de la pantalla de bienvenida. Proporcionar cierta configuración en config.xml automáticamente show la pantalla de presentación inmediatamente después de su lanzamiento de la aplicación y antes de ser completamente ha iniciado y recibió el deviceready evento. Ver los iconos y salpicadura pantallas para obtener más información sobre haciendo esta configuración. Por esta razón, es poco probable que necesitas llamar a navigator.splashscreen.show() para hacer la pantalla visible para el inicio de la aplicación.