CB-11179 Extend the windows-splashscreen docs
Documented a way to disable splashscreen
This commit is contained in:
parent
80b01049c8
commit
1eac08c558
14
README.md
14
README.md
@ -47,6 +47,8 @@ Report issues with this plugin on the [Apache Cordova issue tracker][Apache Cord
|
|||||||
- Windows (`cordova-windows` version >= 4.4.0 is required)
|
- Windows (`cordova-windows` version >= 4.4.0 is required)
|
||||||
- Browser
|
- Browser
|
||||||
|
|
||||||
|
__Note__: Extended splashscreen does not require the plugin on Windows (as opposed to Android and iOS) in case you don't use the plugin API, i.e. programmatic hide/show.
|
||||||
|
|
||||||
## Example Configuration
|
## Example Configuration
|
||||||
In the top-level `config.xml` file (not the one in `platforms`), add configuration elements like those specified here.
|
In the top-level `config.xml` file (not the one in `platforms`), add configuration elements like those specified here.
|
||||||
|
|
||||||
@ -117,13 +119,13 @@ projectRoot
|
|||||||
|
|
||||||
#### config.xml
|
#### config.xml
|
||||||
|
|
||||||
- __AutoHideSplashScreen__ (boolean, default to `true`). Indicates whether to hide splash screen automatically or not. Splash screen hidden after amount of time specified in the `SplashScreenDelay` preference.
|
- `AutoHideSplashScreen` (boolean, default to `true`). Indicates whether to hide splash screen automatically or not. Splash screen hidden after amount of time specified in the `SplashScreenDelay` preference.
|
||||||
|
|
||||||
```xml
|
```xml
|
||||||
<preference name="AutoHideSplashScreen" value="true" />
|
<preference name="AutoHideSplashScreen" value="true" />
|
||||||
```
|
```
|
||||||
|
|
||||||
- __SplashScreenDelay__ (number, default to 3000). Amount of time in milliseconds to wait before automatically hide splash screen.
|
- `SplashScreenDelay` (number, default to 3000). Amount of time in milliseconds to wait before automatically hide splash screen.
|
||||||
|
|
||||||
```xml
|
```xml
|
||||||
<preference name="SplashScreenDelay" value="3000" />
|
<preference name="SplashScreenDelay" value="3000" />
|
||||||
@ -131,6 +133,13 @@ projectRoot
|
|||||||
|
|
||||||
Note also that this value used to be seconds, and not milliseconds, so values less than 30 will still be treated as seconds. ( Consider this a deprecated patch that will disapear in some future version. )
|
Note also that this value used to be seconds, and not milliseconds, so values less than 30 will still be treated as seconds. ( Consider this a deprecated patch that will disapear in some future version. )
|
||||||
|
|
||||||
|
To disable the splashscreen add the following preference to `config.xml`:
|
||||||
|
```xml
|
||||||
|
<preference name="SplashScreenDelay" value="0"/>
|
||||||
|
```
|
||||||
|
|
||||||
|
**iOS Quirk**: to disable the splashscreen on `ios` platform you should also add `<preference name="FadeSplashScreenDuration" value="0"/>` to `config.xml`.
|
||||||
|
|
||||||
- `FadeSplashScreen` (boolean, defaults to `true`): Set to `false` to
|
- `FadeSplashScreen` (boolean, defaults to `true`): Set to `false` to
|
||||||
prevent the splash screen from fading in and out when its display
|
prevent the splash screen from fading in and out when its display
|
||||||
state changes.
|
state changes.
|
||||||
@ -222,7 +231,6 @@ __Note__: `SplashScreen` value should be absolute in order to work in a sub-page
|
|||||||
<preference name="SplashScreenBackgroundColor" value="0xFFFFFFFF"/>
|
<preference name="SplashScreenBackgroundColor" value="0xFFFFFFFF"/>
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
## Methods
|
## Methods
|
||||||
|
|
||||||
- splashscreen.show
|
- splashscreen.show
|
||||||
|
Loading…
x
Reference in New Issue
Block a user