sheldonbaker / phonegap-childbrowser-plugin-ios

The ChildBrowser allows you to display external webpages within your PhoneGap application.

• For back support reference:
  https://github.com/phonegap/phonegap-plugins/tree/master/iPhone/ChildBrowser

A simple use case would be:

• Users can follow links/buttons to view web content without leaving your app.
• Display web pages/images/videos/pdfs in the ChildBrowser.

This command creates a popup browser that is shown in front of your app, when the user presses the DONE button they are simply returned to your app ( actually they never left ).

The ChildBrowser has buttons for refreshing, navigating back + forwards, as well as the option to open in Safari.

Icons are located in the ChildBrowser.bundle and can be customized. Added Retina [email protected] image support to fix small icons in the webview toolbar when displayed on Retina devices.

• Added Temporary Scope (self executing) per Cordova Plugin Upgrade Guide.

• add Key ChildBrowserCommand and Value ChildBrowserCommand to the Cordova.plist in your application xcode project.

Here is a sample command to open Google in a ChildBrowser :

cordova.exec("ChildBrowserCommand.showWebPage", "http://www.google.com" );

###Sample use:

function onDeviceReady() {

	    var root = this;
	    cb = window.plugins.childBrowser;

	    if(cb != null) {
		cb.onLocationChange = function(loc){ root.locChanged(loc); };
		cb.onClose = function(){root.onCloseBrowser(); };
		cb.onOpenExternal = function(){root.onOpenExternal(); };
		cb.showWebPage("http://google.com");

	    }
	}

	function onCloseBrowser() {
	    console.log("onCloseBrowser!");
	}

	function locChanged(loc) {
	    console.log("locChanged!");
	}

	function onOpenExternal() {
	    alert("onOpenExternal!");
	}