Aller au contenu principal
@capgo/capacitor-pdf-viewer Fichiers & stockage Open source

Lecteur de PDF Plugin Capacitor

Intégrez la lecture PDF native sur iOS, Android et le web avec support des chemins, URLs, base64, mode inline et mots de passe

Installer

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

Guide

Comment utiliser le PDF Viewer dans Capacitor

Utiliser @capgo/capacitor-pdf-viewer

Lecture PDF native sur iOS (PDFKit), Android (Pdfium) et le web avec chemins, URLs, base64 et mode inline.

Installer

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

Fonctionnalités du plugin

  • open - Ouvrir un PDF depuis un fichier, un chemin, une URL ou une source base64.
  • close - Fermer le viewer actif et supprimer l'overlay.
  • goToPage - Aller à un numéro de page (index commençant à 1).
  • setZoom - Définir le multiplicateur de zoom.
  • getPluginVersion - Récupérer le marqueur de version de l'implémentation native ou web.
  • addListener - Écouter les événements load, pageChange, error, close et linkTap.

Exemple d'utilisation

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();

Référence complète

FAQ

FAQ du plugin PDF Viewer

Comment installer le plugin PDF Viewer dans une application Capacitor ?

Exécutez "bun add @capgo/capacitor-pdf-viewer" (ou "npm install @capgo/capacitor-pdf-viewer"), puis lancez "bunx cap sync" pour que les projets iOS et Android prennent en compte le code natif. Importez-le depuis "@capgo/capacitor-pdf-viewer" dans votre code.

Est-ce que @capgo/capacitor-pdf-viewer fonctionne avec React, Vue et Angular ?

Oui. PDF Viewer est un package Capacitor, il fonctionne donc avec n'importe quel framework web tournant sous Capacitor, y compris Ionic, React, Vue, Angular, Svelte et le JavaScript pur.

Quelle version de Capacitor est supportée par @capgo/capacitor-pdf-viewer ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à votre version majeure de Capacitor (par exemple, le plugin v8 avec Capacitor 8). Le tableau de compatibilité dans le README de GitHub liste les versions maintenues.

Est-ce que @capgo/capacitor-pdf-viewer est gratuit et open source ?

Oui. Le code source de code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-pdf-viewer/ et le package est gratuit à installer via npm. Les rapports de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code utilisant PDF Viewer sans passer par une revue de l'App Store ?

L'installation ou la mise à niveau du plugin modifie le code natif, ce qui nécessite un nouveau build pour le store. Après cela, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être déployés instantanément via les live updates de Capgo.

Déployez les changements du PDF Viewer sans attendre la validation des stores

Une fois le plugin intégré à votre build de store, Capgo live updates déploient vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencer avec Capgo