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
6.4 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. このプラグインが表示され、アプリケーションの起動中にスプラッシュ スクリーンを非表示にします。
  22. ## インストール
  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. ## サポートされているプラットフォーム
  28. * アマゾン火 OS
  29. * アンドロイド
  30. * ブラックベリー 10
  31. * iOS
  32. * Windows Phone 7 と 8
  33. * Windows 8
  34. * Windows
  35. * ブラウザー
  36. ## メソッド
  37. * splashscreen.show
  38. * splashscreen.hide
  39. ### Android の癖
  40. あなたの`config.xml`内の次の設定を追加する必要があります。
  41. <preference name="SplashScreen" value="foo" />
  42. <preference name="SplashScreenDelay" value="10000" />
  43. <preference name="SplashMaintainAspectRatio" value="true|false" />
  44. Foo ができれば 9 パッチファイル splashscreen ファイルの名前です。 解像度/xml ディレクトリの適切なフォルダーの下に splashcreen ファイルを追加することを確認します。 2 番目のパラメーターは、スプラッシュ ・ スクリーンがの表示時間 (ミリ秒単位) を表します。 デフォルトでは 3000 ミリ秒です。 詳細については、[アイコンとスプラッシュ画面](http://cordova.apache.org/docs/en/edge/config_ref_images.md.html) を参照してください。
  45. "SplashMaintainAspectRatio"の設定はオプションです。 True の場合、スプラッシュ画面描画に設定画面を埋めるために拡大されませんが、代わりに単に「カバー」画面では、CSS のような場合「背景-サイズ: カバー」. これは、たとえば風景またはテキストが含まれている場合、任意の方法でスプラッシュ画面画像が歪むことができない非常に便利です。 この設定は、画面と異なる縦横比で安全にトリミングすることができます大規模なマージン (安全な地域) の画像に適しています。
  46. 縦長と横長の異なるドロウアブルを指定できるように、プラグインは向きを変更するたびにスプラッシュ ドロウアブルをリロードします。
  47. ### ブラウザーの癖
  48. あなたの`config.xml`で次の設定を使用できます。
  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 の癖
  58. * `FadeSplashScreen`(ブール値、既定で [ `true`): スプラッシュ画面がフェードインとフェードアウトの表示状態が変更されたときすることを防ぐために`false`に設定します。
  59. <preference name="FadeSplashScreen" value="false"/>
  60. * `FadeSplashScreenDuration`(float, デフォルトは`2`): スプラッシュ画面の秒数のフェードを実行する効果を指定します。
  61. <preference name="FadeSplashScreenDuration" value="4"/>
  62. * `ShowSplashScreenSpinner`(ブール値、既定で [ `true`): スプラッシュ スクリーン スピナーを非表示にするを`false`に設定します。
  63. <preference name="ShowSplashScreenSpinner" value="false"/>
  64. ## splashscreen.hide
  65. スプラッシュ スクリーンを閉じます。
  66. navigator.splashscreen.hide();
  67. ### ブラックベリー 10、WP8、iOS の気まぐれ
  68. `config.xml` ファイルの `AutoHideSplashScreen` の設定は `false` である必要があります。 遅延を 2 秒間スプラッシュ スクリーンを非表示に `deviceready` イベント ハンドラーで、次のようタイマーを追加します。
  69. setTimeout(function() {
  70. navigator.splashscreen.hide();
  71. }, 2000);
  72. ## splashscreen.show
  73. スプラッシュ画面が表示されます。
  74. navigator.splashscreen.show();
  75. アプリが開始され、`deviceready` イベントが発生するまで、アプリケーションは `navigator.splashscreen.show()` を呼び出すことはできません。 しかし、以来、通常スプラッシュ画面アプリ開始前に表示するものですと思われる、スプラッシュ スクリーンの目的の敗北します。 `config.xml` にいくつかの構成を提供するは自動的に `表示` スプラッシュ画面、アプリを起動後すぐに、それが完全に起動し、`deviceready` イベントを受信する前に。 詳細についてはこの構成を行うには、[アイコンとスプラッシュ画面](http://cordova.apache.org/docs/en/edge/config_ref_images.md.html) を参照してください。 この理由のためにアプリ起動時のスプラッシュ スクリーンを確認 `navigator.splashscreen.show()` をコールする必要がある可能性が高いです。