@capgo/capacitor-pdf-viewer

underWebView / toBack

Abrir con mode: 'underWebView' o toBack: true para colocar el PDF nativo detrás de un Capacitor WebView transparente. nativeUi es false por defecto en este modo para que puedas usar tu propio chrome HTML.

Controles HTML personalizados

Dibuja barras de herramientas, indicadores de página y botones en HTML (Ionic, Tailwind o HTML simple). La capa nativa mantiene el scroll de PDFKit / Pdfium, el zoom con pellizco y la detección de clics en enlaces.

Enrutamiento de toques

Los toques en button, a, controles de formulario, [data-capgo-pdf-interactive], .custom-toolbar, y .custom-pdf-ui button se quedan en el WebView. Los demás toques van al PDF.

updateLayout()

Reposiciona o redimensiona el PDF nativo en píxeles CSS relativos al viewport de la WebView. Llámalo tras una rotación o cuando cambie el tamaño de tu chrome.

Consejo

underWebView / toBack solo para iOS y Android. En web, usa fullscreen o inline. Configuración completa: underWebView.

Resumen

Integra la visualización nativa de PDF en iOS, Android y web con rutas, URLs, base64, modo inline, soporte de contraseñas y una presentación opcional underWebView para UI HTML personalizada.

Comienza con open() y los demás métodos principales detallados abajo.

Soporte de plataformas

Plataforma	Soporte	Notas
iOS	Sí	PDFKit. underWebView / toBack es compatible. hide() y show() solo se aceptan en underWebView o inline modo.
Android	Sí	Pdfium. underWebView / toBack es compatible. hide() y show() funciona en cualquier modo de apertura.
Web	Parcial	Visor de PDF del navegador con URLs de blob. underWebView / toBack no está disponible. Usa fullscreen o inline. nativeUi: false con mode: 'fullscreen' se rechaza.

Funcionalidades principales

• open - Abre un PDF desde un archivo, ruta, URL o fuente base64, incluyendo mode: 'underWebView' o toBack: true.
• close - Cierra el visor activo y elimina cualquier overlay.
• goToPage / nextPage / previousPage - Salta o avanza por páginas numeradas desde 1.
• setZoom - Establece el multiplicador de escala de zoom (1 es la escala de ajuste predeterminada en nativo).
• hide / show - Oculta o muestra la capa del PDF sin liberar el documento.
• updateLayout - Reposicionar o redimensionar el PDF nativo en underWebView / toBack modo.

Público API

Método	Descripción
open	Abre un PDF desde un archivo, ruta, URL o fuente base64.
close	Cierra el visor activo y elimina cualquier overlay.
goToPage	Salta a un número de página basado en 1.
nextPage	Pasa a la siguiente página si existe.
previousPage	Pasa a la página anterior si existe.
setZoom	Establece el multiplicador de zoom. En web se resuelve sin cambiar el zoom del navegador.
getPageCount	Lee el número total de páginas. En web, siempre devuelve 1.
getCurrentPage	Lee la página actual (índice desde 1). En web solo refleja la última página programática.
hide	Oculta la capa PDF sin liberar el documento de memoria.
show	Muestra la capa PDF después de hide().
updateLayout	Reposiciona o redimensiona el PDF nativo al usar underWebView / toBack.
getPluginVersion	Obtiene el marcador de versión de la implementación nativa o web.
addListener	Escucha load, pageChange, zoomChange, error, close, y linkTap eventos.

Fuente de verdad

Esta referencia se sincroniza desde src/definitions.ts en capacitor-pdf-viewer.

Continúa desde @capgo/capacitor-pdf-viewer

Si estás usando @capgo/capacitor-pdf-viewer en tu app de Capacitor, conéctalo con Uso de @capgo/capacitor-pdf-viewer para el tutorial de SEO y la documentación relacionada del plugin Capgo.