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.

78 lines
3.3 KiB

8 years ago
  1. <!---
  2. 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. http://www.apache.org/licenses/LICENSE-2.0
  10. Unless required by applicable law or agreed to in writing,
  11. software distributed under the License is distributed on an
  12. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
  13. KIND, either express or implied. See the License for the
  14. specific language governing permissions and limitations
  15. under the License.
  16. -->
  17. # cordova-plugin-splashscreen
  18. Ce plugin affiche et masque un écran de démarrage lors du lancement de l'application.
  19. ## Installation
  20. cordova plugin add cordova-plugin-splashscreen
  21. ## Plates-formes prises en charge
  22. * Amazon Fire OS
  23. * Android
  24. * BlackBerry 10
  25. * iOS
  26. * Windows Phone 7 et 8
  27. * Windows 8
  28. ## Méthodes
  29. * splashscreen.Show
  30. * splashscreen.Hide
  31. ### Quirks Android
  32. Dans votre fichier config.xml, vous devez ajouter les préférences suivantes :
  33. <preference name="SplashScreen" value="foo" />
  34. <preference name="SplashScreenDelay" value="10000" />
  35. Où foo est le nom du fichier splashscreen, préférablement un fichier de 9 correctif. Assurez-vous d'ajouter vos fichiers splashcreen dans votre répertoire res/xml dans les dossiers appropriés. Le deuxième paramètre représente combien de temps le splashscreen apparaîtra en millisecondes. Il est par défaut à 3000 ms. Pour plus d'informations, consultez [icônes et écrans de démarrage][1].
  36. [1]: http://cordova.apache.org/docs/en/edge/config_ref_images.md.html
  37. ## splashscreen.Hide
  38. Faire disparaître de l'écran de démarrage.
  39. navigator.splashscreen.hide();
  40. ### BlackBerry 10, WP8, iOS Quirk
  41. Paramètre `AutoHideSplashScreen` du fichier `config.xml` doit avoir la valeur `false`. Pour retarder la cacher l'écran de démarrage pendant deux secondes, ajouter un minuteur semblable à la suivante dans le gestionnaire d'événements `deviceready` :
  42. setTimeout(function() {
  43. navigator.splashscreen.hide();
  44. }, 2000);
  45. ## splashscreen.Show
  46. Affiche l'écran de démarrage.
  47. navigator.splashscreen.show();
  48. Votre application ne peut pas appeler `navigator.splashscreen.show()` jusqu'à ce que l'application a commencé et l'événement `deviceready` est déclenché. Mais puisqu'en général, l'écran de démarrage est destiné à être visible avant que votre application a commencé, qui semblerait à l'encontre des objectifs de l'écran de démarrage. Fournir une configuration dans le fichier `config.xml` automatiquement `show` le splash projettera immédiatement après votre lancement de l'app et avant qu'il a complètement démarré et a reçu l'événement `deviceready`. Voir les [icônes et les écrans de démarrage][1] pour plus d'informations sur la conduite de cette configuration. Pour cette raison, il est peu probable que vous devez appeler `navigator.splashscreen.show()` pour rendre l'écran de démarrage visible pour le démarrage de l'application.