Слияние кода завершено, страница обновится автоматически
Этот плагин необходим для работы со страницами запуска. Он отображает и скрывает страницу запуска во время запуска приложения.
Отчеты о проблемах этого плагина можно отправлять на [трекере ошибок Apache Cordova][Apache Cordova issue tracker].
// npm hosted (новый) id
cordova plugin add cordova-plugin-splashscreen
// вы также можете установить непосредственно из этого репозитория
cordova plugin add https://github.com/apache/cordova-plugin-splashscreen.git
В основном файле config.xml (не в одном из platforms), добавьте элементы конфигурации, как указано ниже.
Обратите внимание, что значение атрибута "src" относится к корневому каталогу проекта, а не к каталогу www. Вы можете называть исходное изображение любым образом. Внутреннее имя в приложении определяется Cordova.
<platform name="android">
<!-- вы можете использовать любую плотность, которая существует в проекте Android -->
<splash src="res/screen/android/splash-land-hdpi.png" density="land-hdpi"/>
<splash src="res/screen/android/splash-land-ldpi.png" density="land-ldpi"/>
<splash src="res/screen/android/splash-land-mdpi.png" density="land-mdpi"/>
<splash src="res/screen/android/splash-land-xhdpi.png" density="land-xhdpi"/>
<splash src="res/screen/android/splash-port-hdpi.png" density="port-hdpi"/>
<splash src="res/screen/android/splash-port-ldpi.png" density="port-ldpi"/>
<splash src="res/screen/android/splash-port-mdpi.png" density="port-mdpi"/>
<splash src="res/screen/android/splash-port-xhdpi.png" density="port-xhdpi"/>
</platform>
<platform name="ios">
<!-- изображения определяются шириной и высотой. Далее поддерживаются следующие размеры -->
<splash src="res/screen/ios/Default~iphone.png" width="320" height="480"/>
<splash src="res/screen/ios/Default@2x~iphone.png" width="640" height="960"/>
<splash src="res/screen/ios/Default-Portrait~ipad.png" width="768" height="1024"/>
<splash src="res/screen/ios/Default-Portrait@2x~ipad.png" width="1536" height="2048"/>
<splash src="res/screen/ios/Default-Landscape~ipad.png" width="1024" height="768"/>
<splash src="res/screen/ios/Default-Landscape@2x~ipad.png" width="2048" height="1536"/>
<splash src="res/screen/ios/Default-568h@2x~iphone.png" width="640" height="1136"/>
<splash src="res/screen/ios/Default-667h.png" width="750" height="1334"/>
<splash src="res/screen/ios/Default-736h.png" width="1242" height="2208"/>
<splash src="res/screen/ios/Default-Landscape-736h.png" width="2208" height="1242"/>
</platform>
<platform name="windows">
<!-- изображения определяются шириной и высотой. Далее поддерживаются следующие размеры -->
<splash src="res/screen/windows/splashscreen.png" width="620" height="300"/>
<splash src="res/screen/windows/splashscreenphone.png" width="1152" height="1920"/>
</platform>
<platform name="blackberry10">
<!-- Добавьте элемент rim:splash для каждой плотности и локали, которую вы хотите поддерживать -->
<!-- http://developer.blackberry.com/html5/documentation/rim_splash_element.html -->
<rim:splash src="res/screen/blackberry/splashscreen.png"/>
</platform>
<preference name="SplashScreenDelay" value="10000" />
true). Указывает, следует ли автоматически скрывать страницу запуска или нет. Страница запуска скрывается после времени, указанного в настройке SplashScreenDelay. <preference name="AutoHideSplashScreen" value="true" />
3000). Время в миллисекундах, которое требуется перед тем, как автоматически скрыть страницу запуска. <preference name="SplashScreenDelay" value="3000" />
В вашем файле config.xml необходимо добавить следующие настройки:
<preference name="SplashScreenDelay" value="3000" />
<preference name="SplashMaintainAspectRatio" value="true|false" />
<preference name="SplashShowOnlyFirstTime" value="true|false" />
Первая настройка представляет собой количество времени в миллисекундах, которое страница запуска будет показываться. По умолчанию — 3000 мс.
Настройка SplashMaintainAspectRatio является необязательной. При значении true изображение страницы запуска не растягивается для заполнения экрана, но вместо этого просто "закрывает" его, как CSS свойство "background-size: cover". Это очень полезно, когда изображение страницы запуска не может быть искажено никаким способом (например, содержит пейзаж или текст). Лучше всего использовать эту настройку вместе с изображением, имеющим безопасные области с различными соотношениями сторон.
Плагин перезагружает изображение страницы запуска при изменении ориентации, поэтому вы можете указать различные изображения для горизонтальной и вертикальной ориентаций.
SplashShowOnlyFirstTime настройка также является необязательной, значение по умолчанию — true. Когда она установлена в true, страница запуска появляется только при первом запуске приложения. Однако, если вы планируете использовать navigator.app.exitApp() для выхода из приложения и принудительного отображения страницы запуска при следующем запуске, то эта настройка должна быть установлена в false (это также применимо к случаю выхода из приложения через кнопку "назад").
Вы можете использовать следующие предпочтения в вашем config.xml:
<platform name="browser">
<preference name="SplashScreen" value="/images/browser/splashscreen.jpg" /> <!-- Default is "/img/logo.png" -->
<preference name="SplashScreenDelay" value="3000" /> <!-- Default is "3000" -->
<preference name="SplashScreenBackgroundColor" value="green" /> <!-- Default is "#464646" -->
<preference name="ShowSplashScreen" value="false" /> <!-- Default is "true" -->
<preference name="SplashScreenWidth" value="600" /> <!-- Default is "170" -->
<preference name="SplashScreenHeight" value="300" /> <!-- Default is "200" -->
</platform>
Внимание: Значение SplashScreen должно быть абсолютным путём, чтобы работать в подстраницах. Значение SplashScreen используется только для платформы браузера. Для других платформ значение игнорируется.
В iOS страница запуска называется "Launch Image". Эти изображения обязательны.
FadeSplashScreen (логическое значение, по умолчанию true): установите значение false, чтобы предотвратить плавное появление и исчезновение страницы запуска.
<preference name="FadeSplashScreen" value="false"/>
FadeSplashScreenDuration (число, по умолчанию 3000): задайте продолжительность плавного появления и исчезновения страницы запуска (в миллисекундах). <preference name="FadeSplashScreenDuration" value="3000"/>
Обратите внимание, что ранее значение было секундами, а не миллисекундами, поэтому значения меньше 30 всё ещё будут восприниматься как секунды (рассмотрите это как устаревший патч, который будет удалён в будущих версиях).
Внимание: FadeSplashScreenDuration включается в SplashScreenDelay, например, если в config.xml определены <preference name="SplashScreenDelay" value="3000" /> и <preference name="FadeSplashScreenDuration" value="1000"/>:
Установка значения FadeSplashScreen в false технически означает, что длительность плавного появления и исчезновения равна 0, поэтому общая задержка запуска остаётся 3 секунды.
Внимание: Это справедливо только для запуска приложения — при вызове методов show и hide в коде необходимо учитывать время плавного появления и исчезновения:
navigator.splashscreen.show();
window.setTimeout(function () {
navigator.splashscreen.hide();
}, splashDuration - fadeDuration);
ShowSplashScreenSpinner (логическое значение, по умолчанию true): установите значение false, чтобы скрыть спиннер страницы запуска. <preference name="ShowSplashScreenSpinner" value="false"/>
Скрывает страницу запуска.
navigator.splashscreen.hide();
Настройка AutoHideSplashScreen в файле config.xml должна быть установлена в false. Чтобы задержать скрытие страницы запуска на две секунды, добавьте следующий таймер в обработчик события deviceready:
setTimeout(function() {
navigator.splashscreen.hide();
}, 2000);
Отображает страницу запуска.
navigator.splashscreen.show();
Ваше приложение не может вызвать navigator.splashscreen.show() до тех пор, пока приложение не запустится и событие deviceready не произойдет. Однако, поскольку обычно страница запуска должна быть видна до того, как приложение полностью запустится, это кажется противоречием цели страницы запуска. Предоставление некоторых настроек в config.xml позволяет автоматически немедленно отобразить страницу запуска и скрыть её до события deviceready. Именно поэтому вам, скорее всего, не потребуется вызывать navigator.splashscreen.show() для отображения страницы запуска при запуске приложения.[Трекер проблем Apache Cordova]: https://issues.apache.org/jira/issues/?jql=project%20%3D%20CB%20AND%20status%20in%20%28Open%2C%20%22In%20Progress%22%2C%20Reopened%29%20AND%20resolution%20%3D%20Unresolved%20AND%20component%20%3D%20%22Plugin%20Splashscreen%22%20ORDER%20BY%20priority%20DESC%2C%20summary%20ASC%2C%20updatedDate%20DESC
Вы можете оставить комментарий после Вход в систему
Неприемлемый контент может быть отображен здесь и не будет показан на странице. Вы можете проверить и изменить его с помощью соответствующей функции редактирования.
Если вы подтверждаете, что содержание не содержит непристойной лексики/перенаправления на рекламу/насилия/вульгарной порнографии/нарушений/пиратства/ложного/незначительного или незаконного контента, связанного с национальными законами и предписаниями, вы можете нажать «Отправить» для подачи апелляции, и мы обработаем ее как можно скорее.
Опубликовать ( 0 )