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

Lecteur de PDF Plugin Capacitor

Intégrez la visualisation native de PDF sur iOS, Android et le web avec chemins, URL, 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 PDF Viewer dans Capacitor

Utiliser @capgo/capacitor-pdf-viewer

Affichage PDF natif sur iOS (PDFKit), Android (Pdfium) et le web, avec chemins, URL, base64 et mode inline.

Installer

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

Ce que ce plugin expose

  • open - Ouvrir un PDF depuis un fichier, un chemin, une URL ou une source base64.
  • close - Fermer la visionneuse active et supprimer toute superposition.
  • goToPage - Aller à un numéro de page commençant à 1.
  • setZoom - Définir le facteur de zoom.
  • getPluginVersion - Obtenir 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 qui tourne dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et du JavaScript pur.

Quelle version de Capacitor @capgo/capacitor-pdf-viewer prend-il en charge ?

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

@capgo/capacitor-pdf-viewer est-il gratuit et open source ?

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

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

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez les changements de PDF Viewer sans attendre la validation de l'app

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

Commencez avec Capgo