idoctnef 4ea75c4e01 | 8 years ago | |
---|---|---|
.. | ||
README.md | 8 years ago | |
index.md | 8 years ago |
Este plugin muestra y esconde una pantalla de bienvenida durante el inicio de la aplicació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
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.
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>
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"/>
Despedir a la pantalla de bienvenida.
navigator.splashscreen.hide();
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);
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.