Este plugin permite la visualización de una web en un navegador cuando se llama a la función window.open(), o cuando se abre un enlace compuesto por <a target="_blank">.

org.apache.cordova.inappbrowser

var ref = window.open('http://apache.org', '_blank', 'location=yes');

NOTA: La ventana InAppBrowser se comporta como un navegador web estandar, y no puede acceder a las API de Cordova.

Instalación

cordova plugin add org.apache.cordova.inappbrowser

window.open

Abre una URL en una nueva instancia , instancia de navegador actual, o el navegador del sistema.

var ref = window.open(url, target, options);

• ref: Referencia a la ventana  InAppBrowser. (InAppBrowser)
• url: La URL a cargar (String).
• target: Dónde se cargara la URL, un parámetro opcional que por defecto está a _self. (String)
  • _self: Abre en una WebView de Cordova si la URL está en la lista blanca, en cualquier caso lo abre en la InAppBrowser.
  • _blank: Abre en InAppBrowser.
  • _system: Abre el navegador del sistema.
• options: Opcional, por defecto a: location=yes. (String)

Todas las plataformas soportan el valor:

• location: Se ajusta a yes o no para activar/desactivar la barra de  InAppBrowser.

Plataformas soportadas

• Amazon Fire OS
• Android
• BlackBerry 10
• iOS
• Windows Phone 7 y 8

InAppBrowser

Es el objeto devuelto por la llamada a window.open.

Métodos

addEventListener

Añade un escuchador para un evento de InAppBrowser.

ref.addEventListener(eventname, callback);

• ref: Hace referencia a la ventana InAppBrowser (InAppBrowser)
• eventname: El evento a escuchar(String)
  • loadstart: Se ejecuta cuando InAppBrowser comienza a cargar la URL.
  • loadstop: Se ejecuta cuando InAppBrowser termina de cargar la URL.
  • loaderror: Se ejecuta cuando InAppBrowser encuentra un error al cargar una  URL.
  • exit: Se ejecuta cuando InAppBrowser se cierra.
• callback: es la función que se ejecuta cuando se ejecuta el evento. A la función se le pasa un objeto InAppBrowserEvent como parámetro.

Plataformas soportadas

• Amazon Fire OS
• Android
• iOS
• Windows Phone 7 y 8

removeEventListener

Elimina el escuchador de un evento desde el InAppBrowser.

ref.removeEventListener(eventname, callback);

Plataformas soportadas

• Amazon Fire OS
• Android
• iOS
• Windows Phone 7 y 8

close

Cierra la ventanta InAppBrowser.

ref.close();

Plataformas soportadas

• Amazon Fire OS
• Android
• iOS
• Windows Phone 7 y 8

show

Muestra una ventana InAppBrowser que estaba oculta. Esta llamada no tendría efecto si el InAppBrowser ya estuviera visible.

ref.show();

Plataformas soportadas

• Amazon Fire OS
• Android
• iOS

executeScript

Inyecta código JavaScript a la ventana InAppBrowser.

ref.executeScript(details, callback);

• injectDetails: detalla el script a ejecutar, especificado por un file o code. (Object)
  • file: URL del script a inyectar.
  • code: Texto del script a inyectar.

Plataformas soportadas

• Amazon Fire OS
• Android
• iOS

insertCSS

Inyecta CSS a la ventana InAppBrowser.

ref.insertCSS(details, callback);

• injectDetails: detalla el script a ejecutar, especificado por un file o code. (Object)
  • file: URL de la hoja de estilo a inyectar.
  • code: Texto de la hoja de estilo a inyectar.

Plataformas soportadas

• Amazon Fire OS
• Android
• iOS