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.6 KiB

7 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. Ten plugin wyświetla i ukrywa ekran powitalny podczas uruchamiania aplikacji.
  22. ## Instalacja
  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. ## Obsługiwane platformy
  28. * Amazon Fire OS
  29. * Android
  30. * BlackBerry 10
  31. * iOS
  32. * Windows Phone 7 i 8
  33. * Windows 8
  34. * Windows
  35. * Przeglądarka
  36. ## Metody
  37. * splashscreen.show
  38. * splashscreen.Hide
  39. ### Dziwactwa Androida
  40. W pliku `config.xml`musisz dodać następujące preferencje:
  41. <preference name="SplashScreen" value="foo" />
  42. <preference name="SplashScreenDelay" value="10000" />
  43. <preference name="SplashMaintainAspectRatio" value="true|false" />
  44. Gdzie foo jest nazwą pliku ekranu powitalnego, najlepiej 9 łatce. Upewnij się dodać pliki splashcreen do katalogu res/xml w odpowiednich folderach. Drugi parametr reprezentuje, jak długo ekranu powitalnego pojawi się w milisekundach. Domyślnie 3000 ms. Aby uzyskać więcej informacji, zobacz [ikony i ekrany powitalne w aplikacjach](http://cordova.apache.org/docs/en/edge/config_ref_images.md.html).
  45. "SplashMaintainAspectRatio" preferencji jest opcjonalne. Jeśli zestaw na wartość true, ekran powitalny dolarowe nie jest rozciągnięty do ekranów, ale zamiast po prostu "obejmuje" ekranu, jak CSS "tło-rozmiar: okładka". Jest to bardzo przydatne, kiedy opryskać tęcza obrazy nie zniekształcony w jakikolwiek sposób, na przykład, gdy zawierają one dekoracje lub tekst. To ustawienie działa najlepiej z obrazów, które mają duże marginesy (bezpiecznych obszarów), które mogą być bezpiecznie przycięte na ekrany z różnych proporcji.
  46. Plugin ładuje rozchlapać dolarowe, gdy zmienia orientację, tak można określić różnych drawables do orientacji pionowej i poziomej.
  47. ### Quirks przeglądarki
  48. W pliku `config.xml`można użyć następujące preferencje:
  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. ### Dziwactwa iOS
  58. * `FadeSplashScreen` (wartość logiczna, domyślnie `true`): zestaw na `false` , aby zapobiec Znikająca i odkładane po zmianie stanu wyświetlania ekranu powitalnego.
  59. <preference name="FadeSplashScreen" value="false"/>
  60. * `FadeSplashScreenDuration` (float, domyślnie `2`): określa liczbę sekund dla ekranu powitalnego zanikanie efekt do wykonać.
  61. <preference name="FadeSplashScreenDuration" value="4"/>
  62. * `ShowSplashScreenSpinner` (wartość logiczna, domyślnie `true`): zestaw na `false` , aby ukryć pokrętła ekran powitalny.
  63. <preference name="ShowSplashScreenSpinner" value="false"/>
  64. ## splashscreen.Hide
  65. Odrzucić ten opryskaæ têcza.
  66. navigator.splashscreen.hide();
  67. ### Jeżyna 10, WP8, iOS dziwactwo
  68. Plik `config.xml` `AutoHideSplashScreen` ustawienie musi być `false`. Opóźnienia, ukrywanie ekranu powitalnego przez dwie sekundy, dodać timer następujących w `deviceready` obsługa zdarzeń:
  69. setTimeout(function() {
  70. navigator.splashscreen.hide();
  71. }, 2000);
  72. ## splashscreen.show
  73. Wyświetla ekran powitalny.
  74. navigator.splashscreen.show();
  75. Aplikacja nie można wywołać `navigator.splashscreen.show()`, aż aplikacja została uruchomiona i zdarzenie `deviceready` został zwolniony. Ale ponieważ zazwyczaj opryskać tęcza ma być widoczne przed rozpoczęciem aplikacji, wydaje się sprzeczne z celem ekranu powitalnego. Dostarczanie niektórych konfiguracji w `pliku config.xml` będzie automatycznie `show` splash na ekranie natychmiast po uruchomienie aplikacji i przed pełni rozpoczął i odebrał zdarzenie `deviceready`. Aby uzyskać więcej informacji na robienie tej konfiguracji, zobacz [ikony i ekrany powitalne w aplikacjach](http://cordova.apache.org/docs/en/edge/config_ref_images.md.html). Z tego powodu jest mało prawdopodobne, należy zadzwonić `navigator.splashscreen.show()`, aby wyświetlić ekran powitalny dla uruchamiania aplikacji.