@capgo/capacitor-navegador-de-aplicación

Resumen

@capgo/capacitor-inappbrowser da a las aplicaciones Capacitor dos rutas de navegador: open() para la experiencia del navegador del sistema y openWebView() para un navegador nativo gestionado que su aplicación puede dimensionar, ocultar, enviar mensajes, ejecutar scripts, realizar proxy y superponer con la IU de Ionic.

Utilízalo cuando la página necesite más que un navegador externo simple: flujos de OAuth y pago, portales de soporte incorporados, pantallas de pago, llamadas de video, portales de documentos, aplicaciones web interactivas o cualquier flujo en el que tu aplicación necesite controles nativos alrededor de contenido web en vivo.

El nombre del paquete ha cambiado.

Uso común

• Presenta la interfaz de usuario de Ionic o Capacitor por encima de una página de navegador en vivo con toBack, sendToBack(), bringToFront(), transparentBackground, y dispatchInputEvent().
• Crea navegadores de pantalla parcial, hojas inferiores y vistas de imagen en imagen con width, height, x, y, y updateDimensions().
• Permite a los usuarios tocar la aplicación Capacitor fuera de un marco de navegador personalizado de tamaño en Android e iOS.
• Ejecuta flujos de pago, inicio de sesión, soporte o cambio de cuenta sin almacenamiento de sitio web persistente utilizando persistWebViewData: false y clearAllBrowsingData().
• Mantenga varias instancias de navegador cargadas con hidden, hide(), y show() mientras se preserva el estado de la página.
• Integrar aplicaciones web avanzadas que necesitan proxy de solicitudes, subidas de archivos, descargas, control de ventanas emergentes, soporte de Google Pay, manejo de enlaces y mensajería de aplicación a página. _blank Capacidades básicas

Sección titulada “Capacidades básicas”

• open - Abre un WebView nativo gestionado con barra de herramientas personalizada, tamaño, navegación nativa, mensajería, scripting, proxy, descargas, ventanas emergentes y controles de datos. SFSafariViewController - Mueve un navegador gestionado detrás o encima del __CAPGO_KEEP_0__ WebView host.
• openWebView - Reenvía eventos de clic, toque y desplazamiento a un navegador que está detrás de la interfaz de usuario nativa de la aplicación.
• sendToBack / bringToFront - Moves a managed browser behind or above the Capacitor host WebView.
• dispatchInputEvent - Maneja la apertura de una URL en un navegador gestionado detrás de la interfaz de usuario nativa de la aplicación.
• updateDimensions - Cambia el tamaño y posición de la WebView administrada sin recargar la página.
• hide / show - Mantiene cargadas las WebViews administradas mientras se eliminan o restauran su presentación nativa.
• postMessage / executeScript - Conecta la aplicación Capacitor con el JavaScript que se ejecuta dentro de la página administrada.
• clearAllBrowsingData / persistWebViewData - Controla la persistencia de cookies, caché, almacenamiento, IndexedDB y sesión.
• handleDownloads- Controla la persistencia de cookies, caché, almacenamiento, IndexedDB y sesión, reglas de proxy y eventos de popup - Soporta documentación de puertas, flujos de carga, páginas de pago y aplicaciones web incorporadas.

- Público API

- Método	- Descripción
goBack	- Navega hacia atrás en la historia de la WebView si es posible.
open	- Abre la URL en una ventana nueva en pantalla completa, en Android utiliza Chrome Custom Tabs, en iOS utiliza SFSafariViewController.
clearCookies	- Elimina los cookies de la URL Cuando id se omite, se aplica a todas las pestañas abiertas.
clearAllCookies	Eliminar cookies cuando id se omite, se aplica a todas las pestañas abiertas.
clearCache	Eliminar caché cuando id se omite, se aplica a todas las pestañas abiertas.
clearAllBrowsingData	Elimina cookies, caché, almacenamiento local, almacenamiento de sesión, IndexedDB y otros datos de navegación del almacén predeterminado y de las pestañas administradas.
getCookies	Obtener cookies para una URL específica.
close	Cerrar la pestaña de navegación. Cuando id se omite, cierra la pestaña de navegación activa.
hide	Ocultar la pestaña de navegación sin cerrarla. Utilice show() para traerla de nuevo. Cuando id se omite, se aplica a la pestaña de navegación activa.
show	Muestra una pestaña de navegación previamente oculta. Cuando id se omite, se dirige a la vista activa del navegador web.
sendToBack	Mueve el navegador nativo detrás de la Capacitor WebView del host para que la interfaz de usuario de la aplicación pueda aparecer encima de ella.
bringToFront	Mueve un navegador que estaba detrás de la WebView del host nuevamente a la parte delantera.
dispatchInputEvent	Envía clic, toque o input de desplazamiento a un navegador gestionado; las coordenadas son relativas a la vista del navegador.
openWebView	Abre una URL en una nueva vista del navegador con barras de herramientas y capacidades mejoradas, como acceso a la cámara, acceso a archivos, escucha de eventos, inyección de JavaScript, comunicación bidireccional, etc.
executeScript	Inyecta JavaScript code en la ventana del navegador InAppBrowser. Cuando id se omite, se ejecuta en todas las vistas del navegador web abiertas.
postMessage	Envía un evento a la vista del navegador (navegador en la aplicación). Escucha en la página con window.addEventListener('messageFromNative', listenerFunc)El detail El payload debe ser JSON-serializable. Cuando id se omite, se emite a todas las vistas del navegador abiertas.
takeScreenshot	Captura la vista del navegador actual como una captura de pantalla PNG. Cuando id se omite, se dirige a la vista activa.
setUrl	Establece la URL de la vista. id se omite, se dirige a la vista activa.
addListener	Escucha cambios de URL, solo para openWebView.
addListener	Escucha buttonNearDoneClicksolo cuando se abre la vista web; el payload contiene la vista web id.
addListener	Escucha solo el clic de cierre para openWebView.
addListener	Se disparará cuando el usuario haga clic en el botón de confirmación cuando se requiera un aviso, funciona con openWebView shareDisclaimer y closeModal.
addListener	Se disparará cuando la vista web envíe un evento de vuelta a la aplicación. Utilice window.mobileApp.postMessage(...) en la página, y mantenga el payload serializable en JSON.
addListener	Se disparará cada vez que se capture una captura de pantalla desde el plugin API, el botón de captura de pantalla nativa o el puente de JavaScript inyectado.
addListener	Se disparará cuando se cargue la página.
addListener	Se disparará cuando se produzca un error de carga de página.
addListener	Se disparará después de que el manejo de descargas nativas guarde un archivo localmente. Habilita esto con handleDownloads: true Se disparará cuando se produzca un error en el manejo de descargas nativas. Habilita esto con
addListener	Se disparará cada vez que una página abra una ventana emergente/nueva ventana. Utiliza el ID de ventana emergente devuelto con handleDownloads: true y
addListener	Escucha las solicitudes delegadas por el runtime nativo. Prefiere executeScript, postMessage, show, hideen lugar de llamar directamente a este método. close.
addListener	Escucha la salida del consola de JavaScript emitida por la página gestionada. Habilita esto con addProxyHandler() cuando se abre la vista web.
addListener	Método interno utilizado por captureConsoleLogs: true when opening the webview.
handleProxyRequest	when opening the webview. addProxyHandler() enviar una decisión de proxy hacia nativo. Envía el original phase cuando se responde a un manual proxyRequest escuchador.
removeAllListeners	Eliminar todos los escuchadores para este plugin.
reload	Recargar la página web actual.
updateDimensions	Actualizar las dimensiones de la vista web. Permite cambiar el tamaño y la posición de la vista web en tiempo de ejecución. Cuando id está omitido, se dirige a la vista web activa.
setEnabledSafeTopMargin	Establece el margen superior seguro habilitado de la vista web en tiempo de ejecución. Cuando id está omitido, se dirige a la vista web activa. En Web, este método es una operación sin efecto y resuelve sin cambiar la disposición.
setEnabledSafeBottomMargin	Establece el margen inferior seguro habilitado de la vista web en tiempo de ejecución. Cuando id está omitido, se dirige a la vista web activa. En Web, este método es una operación sin efecto y resuelve sin cambiar la disposición.
openSecureWindow	Abre una ventana de OAuth2 segura. En web, devuelve la URL redirigida a través de un BroadcastChannel; en móviles, registre una URI de redirección personalizada en la configuración de la aplicación. Consulte la guía de inicio rápido para los ejemplos completos de HTML, Info.plist y AndroidManifest.

Valores de Referencia

Use estos valores con opciones de herramienta al abrir un navegador en la aplicación o una vista de navegador.

Tipos de Herramienta

Valor	El usuario encontrará
activity	Barra de herramientas simple con controles de cierre y compartir.
compact	Barra de herramientas simple con un control de cierre.
navigation	Barra de herramientas de navegación completa con controles de atrás y adelante.
blank	Sin barra de herramientas.

Fuente de Verdad

Esta referencia está sincronizada desde src/definitions.ts en capacitor-inappbrowser.

Sigue adelante desde @capgo/capacitor-inappbrowser

Si estás utilizando @capgo/capacitor-inappbrowser para planificar el trabajo de plugin nativo, conecta con Usando @capgo/capacitor-inappbrowser para la capacidad nativa en Usando @capgo/capacitor-inappbrowser, Directorio de Plugins Capgo para el flujo de trabajo del producto en Directorio de Plugins Capgo Plugins de Capgo en Capacitor para el detalle de implementación en Plugins de Capgo en Capacitor Agregar o Actualizar Plugins para el detalle de implementación en Agregar o Actualizar Plugins, y Alternativas de Plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas de Plugins de Ionic Enterprise