iOS Configuration

The config.xml file controls an app's basic settings that apply across each application and CordovaWebView instance. This section details preferences that only apply to iOS builds. See The config.xml File for information on global configuration options.

• EnableViewportScale (boolean, defaults to false): Set to true to use a viewport meta tag to either disable or restrict the range of user scaling.

  <preference name="EnableViewportScale" value="true"/>
  

• MediaPlaybackRequiresUserAction (boolean, defaults to false): Set to true to prevent HTML5 videos from playing automatically with the autoplay attribute. Does not apply when calling play() on a video object.

  <preference name="MediaPlaybackRequiresUserAction" value="true"/>
  

• AllowInlineMediaPlayback (boolean, defaults to false): Set to true to allow HTML5 media playback to appear inline within the screen layout, using browser-supplied controls rather than native controls. For this to work, add the webkit-playsinline attribute to any <video> elements.

  <preference name="AllowInlineMediaPlayback" value="true"/>
  

• BackupWebStorage (string, either none, local, or the default cloud): Set to cloud to allow web storage data to backup via iCloud. Set to local to allow only local backups via iTunes sync. Set to none prevent web storage backups.

  <preference name="BackupWebStorage" value="local"/>
  

• TopActivityIndicator (string, defaults to gray): Controls the appearance of the small spinning icon in the status bar that indicates significant processor activity. Valid values are whiteLarge, white, and gray.

  <preference name="TopActivityIndicator" value="white"/>
  

• FadeSplashScreen (boolean, defaults to true): Set to false to prevent the splash screen from fading in and out when its display state changes.

  <preference name="FadeSplashScreen" value="false"/>
  

• FadeSplashScreenDuration (float, defaults to 2): Specifies the number of seconds for the splash screen fade effect to execute.

  <preference name="FadeSplashScreenDuration" value="4"/>
  

• ShowSplashScreenSpinner (boolean, defaults to true): Set to false to hide the splash-screen spinner.

  <preference name="ShowSplashScreenSpinner" value="false"/>
  

• KeyboardDisplayRequiresUserAction (boolean, defaults to true): Set to false to allow the keyboard to appear when calling focus() on form inputs.

  <preference name="KeyboardDisplayRequiresUserAction" value="false"/>
  

• SuppressesIncrementalRendering (boolean, defaults to false): Set to true to wait until all content has been received before it renders to the screen.

  <preference name="SuppressesIncrementalRendering" value="true"/>
  

• KeyboardShrinksView (boolean, defaults to false): Set to true to scale down the webview when the keyboard appears, overriding the default beavior that shrinks the viewport vertically. This matches the default behaviour for Android apps.

  <preference name="KeyboardShrinksView" value="true"/>