Экран-заставка

Отображает и скрывает экран-заставку приложения.

Методы

• splashscreen.show
• splashscreen.hide

Доступ к функции

Начиная с версии 3.0 Кордова реализует интерфейсы API уровень устройства как плагины. Использование CLI plugin команды, описанные в интерфейс командной строки, чтобы добавить или удалить эту функцию для проекта:

    $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-splashscreen.git
    $ cordova plugin rm org.apache.cordova.core.splashscreen

Эти команды применяются для всех целевых платформ, но изменить параметры конфигурации платформы, описанные ниже:

• Android (вapp/res/xml/config.xml)

  <feature name="SplashScreen">
      <param name="android-package" value="org.apache.cordova.SplashScreen" />
  </feature>
  

• iOS (вconfig.xml)

  <feature name="SplashScreen">
      <param name="ios-package" value="CDVSplashScreen" />
  </feature>
  

Некоторые платформы могут поддерживать эту функцию без необходимости специальной настройки. Смотрите поддержку платформы обзор.

Установка

Андроид

1. Скопировать изображение экрана-заставки в Android-проект res/drawable каталог. Размер для каждого изображения должны быть:

2. девочки (xhdpi): по крайней мере 960 × 720

3. большой (hdpi): по крайней мере 640 × 480
4. Средний (mdpi): по крайней мере 470 × 320

5. малые (ldpi): по крайней мере 426 × 320

   Следует использовать 9-патч изображение для экрана-заставки.

6. В onCreate метод класса, который расширяет DroidGap , добавьте следующие две строки:

   super.setIntegerProperty("splashscreen", R.drawable.splash);
   super.loadUrl(Config.getStartUrl(), 10000);
   

   Первая строка задает изображение для отображения в виде splashscreen. Если имя изображения ничего не splash.png , вам необходимо изменить эту строку. Вторая строка является нормальной super.loadUrl линию, но он имеет второй параметр, который указывает значение времени ожидания для экрана-заставки. В этом примере экран-заставка отображается 10 секунд. Чтобы закрыть экран-заставка после этого приложение получает deviceready событий, вызов navigator.splashscreen.hide() метод.

iOS

Скопируйте ваши изображения экрана заставки в iOS проект Resources/splash каталог. Добавьте только изображения для устройств, которые вы хотите поддерживать, такие как iPad или iPhone. Размер каждого изображения должны быть:

• Default-568h@2x~iphone.png (640x1136 pixels)
• Default-Landscape@2x~ipad.png (2048x1496 pixels)
• Default-Landscape~ipad.png (1024x748 pixels)
• Default-Portrait@2x~ipad.png (1536x2008 pixels)
• Default-Portrait~ipad.png (768x1004 pixels)
• Default@2x~iphone.png (640x960 pixels)
• Default~iphone.png (320x480 pixels)

---

splashscreen.show

Отображает экран-заставку.

navigator.splashscreen.show();

Описание

Этот метод отображает экран-заставку приложения.

Поддерживаемые платформы

• Андроид
• Ежевика 10
• iOS
• Windows Phone 7 и 8
• ОС Windows 8

Быстрый пример

navigator.splashscreen.show();

Полный пример

<!DOCTYPE html>
<html>
  <head>
    <title>Splashscreen Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available
    //
    function onDeviceReady() {
        navigator.splashscreen.show();
    }

    </script>
  </head>
  <body>
    <h1>Example</h1>
  </body>
</html>

---

splashscreen.hide

Закройте экран-заставка.

navigator.splashscreen.hide();

Описание

Этот метод закрывает экран-заставку приложения.

Поддерживаемые платформы

• Андроид
• Ежевика 10
• iOS
• Windows Phone 7 и 8
• ОС Windows 8

Быстрый пример

navigator.splashscreen.hide();

Полный пример

<!DOCTYPE html>
<html>
  <head>
    <title>Splashscreen Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available
    //
    function onDeviceReady() {
        navigator.splashscreen.hide();
    }

    </script>
  </head>
  <body>
    <h1>Example</h1>
  </body>
</html>

iOS галтель

config.xmlФайла AutoHideSplashScreen должен быть false . Для задержки скрытия заставки на две секунды, добавить таймер например следующее в deviceready обработчик событий:

    setTimeout(function() {
        navigator.splashscreen.hide();
    }, 2000);