@capgo/capacitor-pdf-viewer

underWebView / toBack

Apri con mode: 'underWebView' oppure toBack: true per posizionare il PDF nativo dietro una Capacitor WebView trasparente. nativeUi in questa modalità il default è false, così puoi distribuire il tuo chrome HTML.

Controlli HTML personalizzati

Disegna toolbar, indicatori di pagina e pulsanti in HTML (Ionic, Tailwind o markup semplice). Il layer nativo mantiene scroll, pinch zoom e hit testing dei link di PDFKit / Pdfium.

Routing dei touch

I touch su button, a, controlli form, [data-capgo-pdf-interactive], .custom-toolbar, e .custom-pdf-ui button restano nella WebView. Gli altri tocchi vanno al PDF.

updateLayout()

Riposiziona o ridimensiona il PDF nativo in pixel CSS rispetto al viewport della WebView. Chiamala dopo la rotazione o quando la chrome cambia dimensione.

Tip

underWebView / toBack è solo per iOS e Android. Sul web, usa fullscreen oppure inline. Setup completo: underWebView.

Panoramica

Incorpora la visualizzazione PDF nativa su iOS, Android e web con percorsi, URL, base64, modalità inline, supporto password e presentazione opzionale underWebView per interfacce HTML personalizzate.

Inizia con open() e gli altri metodi principali elencati qui sotto.

Supporto piattaforme

Piattaforma	Supporto	Note
iOS	Sì	PDFKit. underWebView / toBack è supportato. hide() e show() sono accettati solo in underWebView oppure inline modalità.
Android	Sì	Pdfium. underWebView / toBack è supportato. hide() e show() funziona in qualsiasi modalità di apertura.
Web	Parziale	Visualizzatore PDF del browser con URL blob. underWebView / toBack non è disponibile. Usa fullscreen oppure inline. nativeUi: false con mode: 'fullscreen' viene rifiutato.

Funzionalità principali

• open - Apri un PDF da file, percorso, URL o sorgente base64, incluso mode: 'underWebView' oppure toBack: true.
• close - Chiudi il viewer attivo e rimuovi ogni overlay.
• goToPage / nextPage / previousPage - Vai o passa alle pagine con indicizzazione da 1.
• setZoom - Imposta il moltiplicatore di zoom (1 è la scala di adattamento predefinita su nativo).
• hide / show - Nascondi o mostra il layer PDF senza rimuovere il documento.
• updateLayout - Riposiziona o ridimensiona il PDF nativo in underWebView / toBack modalità.

Pubblico API

Metodo	Descrizione
open	Apri un PDF da file, percorso, URL o sorgente base64.
close	Chiudi il viewer attivo e rimuovi eventuali overlay.
goToPage	Vai a un numero di pagina basato su 1.
nextPage	Passa alla pagina successiva, se esiste.
previousPage	Passa alla pagina precedente, se esiste.
setZoom	Imposta il moltiplicatore di zoom. Su web, la risoluzione avviene senza modificare lo zoom del browser.
getPageCount	Legge il numero totale di pagine. Su web, restituisce sempre 1.
getCurrentPage	Legge la pagina corrente (basata su 1). Su web, riflette solo l'ultima pagina impostata programmaticamente.
hide	Nasconde il layer PDF senza scaricare il documento.
show	Mostra il layer PDF dopo hide().
updateLayout	Riposiziona o ridimensiona il PDF nativo quando si usa underWebView / toBack.
getPluginVersion	Ottiene il marcatore di versione dell'implementazione nativa o web.
addListener	Ascolta gli load, pageChange, zoomChange, error, close, e linkTap eventi.

Fonte di verità

Questo riferimento è sincronizzato da src/definitions.ts nella capacitor-pdf-viewer.

Continua con @capgo/capacitor-pdf-viewer

Se stai usando @capgo/capacitor-pdf-viewer nella tua app Capacitor, connettila con Uso di @capgo/capacitor-pdf-viewer per il tutorial SEO e la documentazione del plugin Capgo correlato.