window.open

Opens a URL in a new InAppBrowser instance, the current browser instance, or the system browser.

var ref = window.open(url, target, options);
  • ref: reference to the InAppBrowser window ([InAppBrowser](inappbrowser.html))
  • url: the URL to load (String). Call encodeURI() on this if you have Unicode characters in your URL.
  • target: the target to load the URL in (String) (Optional, Default: "_self")

    _self - opens in the Cordova WebView if url is in the white-list, else it opens in the InAppBrowser 
    _blank - always open in the InAppBrowser 
    _system - always open in the system web browser 
    
  • options: options for the InAppBrowser (String) (Optional, Default: "location=yes")

    The options string must not contain any blank space, each feature name and value must be separated by a comma. Feature names are case insensitive. Only the value below is supported on all platforms:

    • location - set to 'yes' or 'no' to turn the location bar on or off for the InAppBrowser

    iOS only

    • enableViewportScale - set to 'yes' or 'no' to prevent viewport scaling through a meta tag (defaults to 'no')
    • mediaPlaybackRequiresUserAction - set to 'yes' or 'no' to not allow autoplayed HTML5 video (defaults to 'no')
    • allowInlineMediaPlayback - set to 'yes' or 'no' to allow inline HTML5 media playback, also, the video element in the HTML document must also include the webkit-playsinline attribute (defaults to 'no')
    • keyboardDisplayRequiresUserAction - set to 'yes' or 'no' to open the keyboard when form elements get focus via the JavaScript focus() call (defaults to 'yes')
    • suppressesIncrementalRendering - set to 'yes' or 'no' to wait until all new view content has been received before it is rendered (defaults to 'no')
    • presentationstyle - set to 'pagesheet', 'formsheet' or 'fullscreen' to set the presentation style (defaults to 'fullscreen')
    • transitionstyle - set to 'fliphorizontal', 'crossdissolve' or 'coververtical' to set the transition style (defaults to 'coververtical')

Supported Platforms

  • Android
  • iOS
  • BlackBerry 10
  • Windows Phone 7 + 8

Quick Example

var ref = window.open('http://apache.org', '_blank', 'location=yes');
var ref2 = window.open(encodeURI('http://ja.m.wikipedia.org/wiki/ハングル'), '_blank', 'location=yes');

Full Example

<!DOCTYPE html>
<html>
  <head>
    <title>window.open Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova-2.4.0.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for Cordova to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // Cordova is ready
    //
    function onDeviceReady() {
        // external url
        var ref = window.open(encodeURI('http://apache.org'), '_blank', 'location=yes');
        // relative document
        ref = window.open('next.html', '_self');
    }

    </script>
  </head>
  <body>
  </body>
</html>