You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

118 lines
5.7 KiB

8 years ago
  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. # cordova-plugin-splashscreen
  20. [![Build Status](https://travis-ci.org/apache/cordova-plugin-splashscreen.svg)](https://travis-ci.org/apache/cordova-plugin-splashscreen)
  21. Questo plugin Visualizza e nasconde una schermata iniziale durante l'avvio dell'applicazione.
  22. ## Installazione
  23. // npm hosted (new) id
  24. cordova plugin add cordova-plugin-splashscreen
  25. // you may also install directly from this repo
  26. cordova plugin add https://github.com/apache/cordova-plugin-splashscreen.git
  27. ## Piattaforme supportate
  28. * Amazon fuoco OS
  29. * Android
  30. * BlackBerry 10
  31. * iOS
  32. * Windows Phone 7 e 8
  33. * Windows 8
  34. * Windows
  35. * Browser
  36. ## Metodi
  37. * splashscreen
  38. * splashscreen.Hide
  39. ### Stranezze Android
  40. Nel vostro `config. XML`, è necessario aggiungere le seguenti preferenze:
  41. <preference name="SplashScreen" value="foo" />
  42. <preference name="SplashScreenDelay" value="10000" />
  43. <preference name="SplashMaintainAspectRatio" value="true|false" />
  44. Dove foo è il nome del file splashscreen, preferibilmente un file 9 patch. Assicurati di aggiungere i tuoi file splashcreen res/xml nella directory sotto cartelle appropriate. Il secondo parametro rappresenta quanto tempo lo splashscreen apparirà in millisecondi. Il valore predefinito è 3000 ms. Per ulteriori informazioni, vedere [icone e schermate iniziali](http://cordova.apache.org/docs/en/edge/config_ref_images.md.html).
  45. "SplashMaintainAspectRatio" preferenza è facoltativo. Se impostato su true, schermata iniziale drawable non viene adattata per misura lo schermo, ma invece semplicemente "copre" lo schermo, come CSS "sfondo-dimensione: copertina". Questo è molto utile quando immagini schermata iniziale non possono essere distorta in qualche modo, per esempio quando contengono testo o scenario. Questa impostazione funziona meglio con immagini che hanno grandi margini (zone sicure) che possono essere ritagliati in modo sicuro su schermi con proporzioni diverse.
  46. Il plugin viene ricaricata splash drawable ogni volta che cambia orientamento, è possibile specificare diversi parte per orientamento verticale e orizzontale.
  47. ### Stranezze browser
  48. Nel vostro `config. XML`, è possibile utilizzare le seguenti preferenze:
  49. <platform name="browser">
  50. <preference name="SplashScreen" value="images/browser/splashscreen.jpg" /> <!-- defaults to "img/logo.png" -->
  51. <preference name="SplashScreenDelay" value="10000" /> <!-- defaults to "3000" -->
  52. <preference name="SplashScreenBackgroundColor" value="green" /> <!-- defaults to "#464646" -->
  53. <preference name="ShowSplashScreen" value="false" /> <!-- defaults to "true" -->
  54. <preference name="SplashScreenWidth" value="600" /> <!-- defaults to "170" -->
  55. <preference name="SplashScreenHeight" value="300" /> <!-- defaults to "200" -->
  56. </platform>
  57. ### iOS stranezze
  58. * `FadeSplashScreen` (boolean, impostazioni predefinite a `true`): impostare su `false` per impedire che la schermata iniziale e scompaiono quando cambia il relativo stato di visualizzazione.
  59. <preference name="FadeSplashScreen" value="false"/>
  60. * `FadeSplashScreenDuration` (float, il valore predefinito è `2`): specifica il numero di secondi per la schermata iniziale dissolvenza effetto da eseguire.
  61. <preference name="FadeSplashScreenDuration" value="4"/>
  62. * `ShowSplashScreenSpinner` (boolean, impostazioni predefinite a `true`): impostare su `false` per nascondere la filatrice schermata iniziale.
  63. <preference name="ShowSplashScreenSpinner" value="false"/>
  64. ## splashscreen.Hide
  65. Respingere la schermata iniziale.
  66. navigator.splashscreen.hide();
  67. ### BlackBerry 10, WP8, iOS Quirk
  68. Impostazione `AutoHideSplashScreen` del file `config.xml` deve essere `false`. Per ritardare nascondendo la schermata iniziale per due secondi, aggiungere un timer ad esempio nel gestore eventi `deviceready`:
  69. setTimeout(function() {
  70. navigator.splashscreen.hide();
  71. }, 2000);
  72. ## splashscreen
  73. Visualizza la schermata iniziale.
  74. navigator.splashscreen.show();
  75. L'applicazione non può chiamare `navigator.splashscreen.show()` fino a quando l'app ha iniziato e ha generato l'evento `deviceready`. Ma poiché in genere la schermata iniziale è destinata ad essere visibile prima app ha iniziato, che sembrerebbe per sconfiggere lo scopo della schermata iniziale. Fornendo qualche configurazione nel `file config.xml` sarà automaticamente `show` il tonfo schermo subito dopo il lancio dell'app e prima che completamente ha iniziato e ha ricevuto l'evento `deviceready`. Per ulteriori informazioni su facendo questa configurazione, vedere [icone e schermate iniziali](http://cordova.apache.org/docs/en/edge/config_ref_images.md.html). Per questo motivo, è improbabile che dovete chiamare `navigator.splashscreen.show()` per rendere la schermata visibile per avvio di app.