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

Resumen

@capgo/capacitor-inappbrowser da Capacitor aplicaciones dos rutas de navegador: open() para la experiencia del navegador del sistema y openWebView() for a managed native WebView that your app can size, hide, message, script, proxy, and layer with Ionic UI.

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

El nombre del paquete ha cambiado.

Common Use Cases

• Presente la interfaz de Ionic o Capacitor sobre una página de navegador en vivo toBack, sendToBack(), bringToFront(), transparentBackgroundy dispatchInputEvent().
• Construya navegadores de pantalla parcial, hojas de abajo y vistas de imagen-en-imagen con width, height, x, yy updateDimensions().
• Deje que los usuarios toquen la aplicación Capacitor fuera de un marco de navegador personalizado de tamaño en Android e iOS.
• Usar flujos de pago, inicio de sesión, soporte o cambio de cuenta sin almacenamiento persistente de sitio web utilizando persistWebViewData: false y clearAllBrowsingData().
• Mantén varias instancias de navegador cargadas con hidden, hide()y show() Manteniendo el estado de la página.
• Integra aplicaciones web avanzadas que necesitan proxy de solicitudes, subida de archivos, descarga, control de ventanas emergentes, soporte de Google Pay. _blank manejo de enlaces y mensajería de aplicación a página.

Capacidades básicas

• open - Abre una URL en Chrome Custom Tabs en Android o SFSafariViewController - en iOS.
• openWebView - Abre una vista web nativa gestionada con herramienta de navegación personalizada, tamaño, navegación nativa, mensajería, scripting, proxy, descargas, ventanas emergentes y controles de datos.
• sendToBack / bringToFront Mueve un navegador administrado detrás o encima del Capacitor host WebView.
• dispatchInputEvent Reenvía eventos de clic, toque y desplazamiento a un navegador detrás de la interfaz de usuario nativa de la aplicación.
• updateDimensions Cambia el tamaño y la posición de la vista web administrada sin recargar la página.
• hide / show Mantiene cargados los WebViews administrados mientras se eliminan o restauran su presentación nativa.
• postMessage / executeScript - Conecta la aplicación Capacitor con JavaScript que se ejecuta dentro de la página gestionada.
• clearAllBrowsingData / persistWebViewData - Controla cookies, caché, almacenamiento, IndexedDB y persistencia de sesión.
• handleDownloadsdocumentos de soporte para puertas de portal, flujos de carga, páginas de pago y aplicaciones web incorporadas.

Página pública API

Método	Descripción
goBack	Navega hacia atrás en la historia del 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	Borrar cookies de la URL Cuando id omitido, se aplica a todas las ventanas web abiertas.
clearAllCookies	Borrar todas las cookies Cuando id omitido, se aplica a todas las ventanas web abiertas.
clearCache	Borrar caché Cuando id omitido, se aplica a todas las ventanas web abiertas.
clearAllBrowsingData	Borra cookies, caché, almacenamiento local, almacenamiento de sesión, IndexedDB y otros datos de navegación desde el almacén predeterminado y WebViews administrados.
getCookies	Obtenga cookies para una URL específica.
close	Cerrar la vista web. Cuando id se omite, cierra la vista web activa.
hide	Ocultar la vista web sin cerrarla. Utilice show() para traerla de nuevo. Cuando id se omite, se dirige a la vista web activa.
show	Mostrar una vista web previamente oculta. Cuando id se omite, se dirige a la vista web activa.
sendToBack	Mueve el navegador nativo detrás del Capacitor WebView host para que la interfaz de usuario de la aplicación aparezca encima.
bringToFront	Mueve un navegador que estaba detrás de la host WebView nuevamente a la parte delantera.
dispatchInputEvent	Envía eventos de clic, toque o desplazamiento a un navegador gestionado; las coordenadas son relativas a la ventana del navegador.
openWebView	Abra la url en una nueva vista web con barras de herramientas y capacidades mejoradas, como acceso a la cámara, acceso a archivos, escuchar eventos, inyectar javascript, comunicación bidireccional, etc.
executeScript	Inyecta JavaScript code en la ventana de InAppBrowser. Cuando id se omite, se ejecuta en todas las pestañas abiertas.
postMessage	Envía un evento a la pestaña web (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 Si se omite, se transmite a todas las vistas web abiertas.
takeScreenshot	Captura la vista actual de la pestaña web como una captura de pantalla PNG. Cuando id Si se omite, apunta a la vista activa.
setUrl	Establece la URL de la pestaña web. Cuando id Si se omite, apunta a la vista activa.
addListener	Escucha el cambio de URL, solo para pestañas web abiertas.
addListener	Escucha buttonNearDoneClickEl payload contiene la pestaña web id.
addListener	Escuchar 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 dispara cuando el webview envía 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	Will be triggered when page load error.
addListener	Se disparará después de que el manejo de descargas nativas guarde un archivo localmente. Active esto con handleDownloads: true cuando se abre el webview.
addListener	Se disparará cuando el manejo de descargas nativas falla. Active esto con handleDownloads: true cuando se abre el webview.
addListener	Se disparará cada vez que una página abra una ventana emergente/nueva. Utilice el id de ventana emergente devuelto con executeScript, postMessage, show, hide, y close.
addListener	Escuchar solicitudes delegadas por el tiempo de ejecución nativo. Prefiere addProxyHandler() en lugar de llamar a esto directamente.
addListener	Escuchar la salida de la consola de JavaScript emitida por la página gestionada. Habilite esto con captureConsoleLogs: true al abrir la vista web.
handleProxyRequest	Método interno utilizado por addProxyHandler() para enviar una decisión de proxy de vuelta a nativo. Reenvía el original phase al responder a un manual proxyRequest escuchador.
removeAllListeners	Quitar todos los escuchadores para este plugin.
reload	Recargar la página web actual.
updateDimensions	Actualiza las dimensiones de la vista web. Permite cambiar el tamaño y la posición de la vista web en tiempo de ejecución. id se omite, se dirige a la vista activa.
setEnabledSafeTopMargin	Establece la margen superior segura habilitada del navegador en tiempo de ejecución. Cuando id Si se omite, apunta al webview activo. En Web, este método es una operación nula y resuelve sin cambiar la disposición.
setEnabledSafeBottomMargin	Establece la margen inferior segura habilitada del navegador en tiempo de ejecución. Cuando id Si se omite, apunta al webview activo. En Web, este método es una operación nula 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óvil, registra una URI de redirección personalizada en la configuración de la aplicación. Consulte la guía de inicio rápido para obtener el ejemplo completo de HTML, Info.plist y AndroidManifest.

Valores de Referencia

Utilice estos valores con opciones de herramienta al abrir un navegador en aplicación o WebView.

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 navegación completa con controles de atrás y adelante.
blank	No toolbar.

Fuente de Verdad

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

Sigue adelante desde @capgo/capacitor-inappbrowser

Si está utilizando @capgo/capacitor-navegador-en-aplicación para planificar el trabajo de plugin nativo, conecte con Usando @capgo/capacitor-inappbrowser para la capacidad nativa en Usando @capgo/capacitor-inappbrowser, Capgo Directorio de Plugins para el flujo de trabajo del producto en Capgo Directorio de Plugins, Capacitor Plugins por Capgo para el detalle de implementación en Capacitor Plugins por Capgo, 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 Ionic Enterprise Plugin Alternativas.