Salta al contenuto principale
@capgo/capacitor-pdf-viewer File & Storage Open source

Visualizzatore PDF Plugin Capacitor

Integra la visualizzazione nativa dei PDF su iOS, Android e web con path, URL, base64, modalità inline e supporto password

Installa

bun add @capgo/capacitor-pdf-viewer bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-pdf-viewer
  • pnpm add @capgo/capacitor-pdf-viewer
  • yarn add @capgo/capacitor-pdf-viewer

Guida

Come usare PDF Viewer in Capacitor

Uso di @capgo/capacitor-pdf-viewer

Visualizzazione PDF nativa su iOS (PDFKit), Android (Pdfium) e web con path, URL, base64 e modalità inline.

Installa

bun add @capgo/capacitor-pdf-viewer
bunx cap sync

Cosa espone questo plugin

  • open - Apri un PDF da un file, un percorso, un URL o una sorgente base64.
  • close - Chiudi il viewer attivo e rimuovi ogni overlay.
  • goToPage - Vai a un numero di pagina (partendo da 1).
  • setZoom - Imposta il moltiplicatore della scala di zoom.
  • getPluginVersion - Ottieni il marcatore di versione dell'implementazione nativa o web.
  • addListener - Ascolta gli eventi load, pageChange, error, close e linkTap.

Esempio d'uso

open

import { PdfViewer } from '@capgo/capacitor-pdf-viewer';

await PdfViewer.addListener('pageChange', ({ page, pageCount }) => {
  console.log(`Page ${page} of ${pageCount}`);
});

const { pageCount } = await PdfViewer.open({
  source: 'https://example.com/manual.pdf',
  mode: 'fullscreen',
  scrollMode: 'continuous',
  page: 1,
});

console.log(`Opened ${pageCount} pages`);

close

import { PdfViewer } from '@capgo/capacitor-pdf-viewer';

await PdfViewer.close();

Riferimento completo

FAQ

FAQ del plugin PDF Viewer

Come installo il plugin PDF Viewer in un'app Capacitor?

Esegui "bun add @capgo/capacitor-pdf-viewer" (oppure "npm install @capgo/capacitor-pdf-viewer"), poi esegui "bunx cap sync" affinché i progetti iOS e Android rilevino il code nativo. Importalo da "@capgo/capacitor-pdf-viewer" nel code della tua app.

@capgo/capacitor-pdf-viewer funziona con React, Vue e Angular?

Sì. PDF Viewer è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che gira all'interno di Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-pdf-viewer?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-pdf-viewer è gratuito e open source?

Sì. Il code sorgente è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-pdf-viewer/ e il pacchetto è gratuito da installare da npm. Sono benvenuti bug report e pull request.

Posso aggiornare code che usa PDF Viewer senza una revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Rilascia le modifiche a PDF Viewer senza attendere la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo