Inappbrowser

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