This version of the documentation is outdated!
Click here for the latest released version.
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. Only the value below is supported:
location - set to 'yes' or 'no' to turn the location bar on or off for the InAppBrowser
Supported Platforms
- Android
- iOS
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.3.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>