config.xml
The
config.xml
file is a settings file controlling various settings of Cordova.
Below are available elements and preferences you may need to configure:
Attribute | Type | Default Value | Description |
version | String | 1.0.0 | A version number which is visible to users |
Example
<widget id="com.example.helloworld" version="0.0.1">
...
</widget>
Attribute | Type | Default Value | Description |
src | String | indext.html | The <content> element defines the app's starting page in the top-level web assets directory. You can change the starting page by changing the value of the src attribute to your preferred URL. |
Example
<?xml version="1.0" encoding="UTF-8"?>
<widget xmlns="http://www.w3.org/ns/widgets" id="com.example.helloworld" version="1.0.0">
...
<content src="https://monaca.io/" />
</widget>
Attribute | Type | Default Value | Description |
origin | String | * | Controls access to specific network domains. If set to * , you can access all domains from your app. |
Example
...
<access origin="*" />
...
The
<preference>
tag sets various options as pairs of name/value attributes. Each preference's name is case-insensitive. Many preferences are unique to specific platforms, as listed at the top of this page. The following sections detail preferences that apply to more than one platform.Preference Name | Type | Default Value | Description |
DisallowOverScroll | Boolean | false | Set to true if you want to disable the rubber-band scrolling for WebView. |
EnableViewportScale | Boolean | false | Set to true to prevent viewport scaling through a <meta> tag. |
AutoHideSplashScreen | Boolean | true | Set to false to control the splashscreen when it’s hidden through a JavaScript API. |
BackupWebStorage | String | cloud | There are 3 valid values:
|
UIWebViewDecelerationSpeed | String | normal | Controls the deceleration speed of momentum scrolling. There are 2 valid values:
|
Orientation * | String | default | (Cordova 5.2 or Higher) There are 4 valid values:
|
Example
...
<preference name="DisallowOverscroll" value="false" />
<preference name="EnableViewportScale" value="false" />
<preference name="AutoHideSplashScreen" value="true" />
<preference name="BackupWebStorage" value="cloud" />
<preference name="UIWebViewDecelerationSpeed" value="normal" />
<preference name="Orientation" value="portrait" />
...
*: There are two use ways to configure
Orientation
preference:- 1.Global Settings:<widget>....<preference name="orientation" value="default"/>....</widget>
It is also possible to apply the setting for all devices at once; however, you can only use
default
, landscape
and portrait
value. all
is not possible for Global Settings. 2. Platform Specific Settings:
<widget>
...
<platform name="ios">
<preference name="orientation" value="default"/>
</platform>
...
</widget>
For Android/Windows,
default
means all directions, but in iOS only portrait will be applied.Last modified 2yr ago