1<!--
  2# license: Licensed to the Apache Software Foundation (ASF) under one
  3#         or more contributor license agreements.  See the NOTICE file
  4#         distributed with this work for additional information
  5#         regarding copyright ownership.  The ASF licenses this file
  6#         to you under the Apache License, Version 2.0 (the
  7#         "License"); you may not use this file except in compliance
  8#         with the License.  You may obtain a copy of the License at
  9#
 10#           http://www.apache.org/licenses/LICENSE-2.0
 11#
 12#         Unless required by applicable law or agreed to in writing,
 13#         software distributed under the License is distributed on an
 14#         "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 15#         KIND, either express or implied.  See the License for the
 16#         specific language governing permissions and limitations
 17#         under the License.
 18-->
 19
 20# cordova-plugin-splashscreen
 21
 22[![Build Status](https://travis-ci.org/apache/cordova-plugin-splashscreen.svg)](https://travis-ci.org/apache/cordova-plugin-splashscreen)
 23
 24Este plugin muestra y esconde una pantalla de bienvenida durante el inicio de la aplicación.
 25
 26## Instalación
 27
 28    // npm hosted (new) id
 29    cordova plugin add cordova-plugin-splashscreen
 30    // you may also install directly from this repo
 31    cordova plugin add https://github.com/apache/cordova-plugin-splashscreen.git
 32    
 33
 34## Plataformas soportadas
 35
 36  * Amazon fire OS
 37  * Android
 38  * BlackBerry 10
 39  * iOS
 40  * Windows Phone 7 y 8
 41  * Windows 8
 42  * Windows
 43  * Explorador
 44
 45## Métodos
 46
 47  * splashscreen.show
 48  * splashscreen.hide
 49
 50### Rarezas Android
 51
 52En el `archivo config.xml`, es necesario agregar las siguientes preferencias:
 53
 54    <preference name="SplashScreen" value="foo" />
 55    <preference name="SplashScreenDelay" value="10000" />
 56    <preference name="SplashMaintainAspectRatio" value="true|false" />
 57    
 58
 59Donde 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](http://cordova.apache.org/docs/en/edge/config_ref_images.md.html) para obtener más información.
 60
 61Preferencia "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.
 62
 63El plugin recarga splash dibujable cuando cambia de orientación, por lo que puede especificar diferente dibujo para orientaciones vertical y horizontal.
 64
 65### Navegador rarezas
 66
 67Puede utilizar las siguientes preferencias en el `archivo config.xml`:
 68
 69    <platform name="browser">
 70        <preference name="SplashScreen" value="images/browser/splashscreen.jpg" /> <!-- defaults to "img/logo.png" -->
 71        <preference name="SplashScreenDelay" value="10000" /> <!-- defaults to "3000" -->
 72        <preference name="SplashScreenBackgroundColor" value="green" /> <!-- defaults to "#464646" -->
 73        <preference name="ShowSplashScreen" value="false" /> <!-- defaults to "true" -->
 74        <preference name="SplashScreenWidth" value="600" /> <!-- defaults to "170" -->
 75        <preference name="SplashScreenHeight" value="300" /> <!-- defaults to "200" -->
 76    </platform>
 77    
 78
 79### iOS rarezas
 80
 81  * `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.
 82    
 83        <preference name="FadeSplashScreen" value="false"/>
 84        
 85
 86  * `FadeSplashScreenDuration` (float, por defecto es `2`): especifica el número de segundos para que la pantalla se descolora efecto para ejecutar.
 87    
 88        <preference name="FadeSplashScreenDuration" value="4"/>
 89        
 90
 91  * `ShowSplashScreenSpinner` (booleano, por defecto `true`): establecida en `false` para ocultar la ruleta de la pantalla de bienvenida.
 92    
 93        <preference name="ShowSplashScreenSpinner" value="false"/>
 94        
 95
 96## splashscreen.hide
 97
 98Despedir a la pantalla de bienvenida.
 99
100    navigator.splashscreen.hide();
101    
102
103### BlackBerry 10, WP8, iOS Quirk
104
105El `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:
106
107        setTimeout(function() {
108            navigator.splashscreen.hide();
109        }, 2000);
110    
111
112## splashscreen.show
113
114Muestra la pantalla de bienvenida.
115
116    navigator.splashscreen.show();
117    
118
119La 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](http://cordova.apache.org/docs/en/edge/config_ref_images.md.html) 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.