@capgo/capacitor-pdf-viewer

Intégrez la lecture PDF native sur iOS, Android et le web avec des chemins, des URL, du base64, le mode inline, la prise en charge des mots de passe et une interface HTML personnalisée via underWebView

Commencer underWebView GitHub

underWebView / toBack

Ouvrez avec mode: 'underWebView' ou toBack: true pour placer le PDF natif derrière une WebView Capacitor transparente. nativeUi vaut false par défaut dans ce mode, pour que vous puissiez livrer votre propre habillage HTML.

Contrôles HTML personnalisés

Dessinez des barres d’outils, des indicateurs de page et des boutons en HTML (Ionic, Tailwind ou balisage simple). La couche native conserve le défilement, le zoom par pincement et la détection des clics sur les liens de PDFKit / Pdfium.

Routage tactile

Les appuis sur button, a, les contrôles de formulaire, [data-capgo-pdf-interactive], .custom-toolbar, et .custom-pdf-ui button rester dans le WebView. Les autres touches sont transmises au PDF.

updateLayout()

Repositionner ou redimensionner le PDF natif en pixels CSS par rapport à la viewport du WebView. À appeler après une rotation ou lorsque la taille de votre chrome change.

Aperçu

Intégrez la lecture PDF native sur iOS, Android et le web, avec des chemins, des URL, du base64, un mode inline, la prise en charge des mots de passe et une présentation optionnelle underWebView pour une interface HTML personnalisée.

Commencez par open() et les autres méthodes principales listées ci-dessous.

Support des plateformes

Plateforme	Support	Notes
iOS	Oui	PDFKit. `underWebView` / `toBack` est pris en charge. `hide()` et `show()` ne sont acceptés que dans `underWebView` ou `inline` mode.
Android	Oui	Pdfium. `underWebView` / `toBack` est pris en charge. `hide()` et `show()` fonctionnent dans n'importe quel mode ouvert.
Le Web	Partielle	Visionneuse PDF du navigateur avec des URL blob. `underWebView` / `toBack` n'est pas disponible. Utilisez `fullscreen` ou `inline`. `nativeUi: false` par `mode: 'fullscreen'` est rejeté.

Fonctionnalités clés

open - Ouvrir un PDF depuis un fichier, un chemin, une URL ou une source base64, y compris mode: 'underWebView' ou toBack: true.
close - Fermer la visionneuse active et supprimer toute superposition.
goToPage / nextPage / previousPage - Jump or step through 1-based pages.
setZoom - Définir le multiplicateur de zoom (1 est l’échelle d’ajustement par défaut sur natif).
hide / show - Masquer ou afficher la couche PDF sans décharger le document.
updateLayout - Repositionner ou redimensionner le PDF natif en underWebView / toBack mode.

API public

Méthode	Description
`open`	Ouvrir un PDF depuis un fichier, un chemin, une URL ou une source base64.
`close`	Fermer le visionneuse active et supprimer tout superposition.
`goToPage`	Aller à un numéro de page basé sur 1.
`nextPage`	Passer à la page suivante si elle existe.
`previousPage`	Passer à la page précédente si elle existe.
`setZoom`	Définit le multiplicateur de zoom. Sur le web, cela se résout sans modifier le zoom du navigateur.
`getPageCount`	Lit le nombre total de pages. Sur le web, cela renvoie toujours `1`.
`getCurrentPage`	Lit la page courante (indexation à partir de 1). Sur le web, cela reflète uniquement la dernière page définie par le code.
`hide`	Masque la couche PDF sans décharger le document.
`show`	Affiche la couche PDF après `hide()`.
`updateLayout`	Repositionne ou redimensionne le PDF natif lors de l’utilisation de `underWebView` / `toBack`.
`getPluginVersion`	Récupère le marqueur de version de l’implémentation native ou web.
`addListener`	Écoutez `load`, `pageChange`, `zoomChange`, `error`, `close`, et `linkTap` des événements.

Source de vérité

Cette référence est synchronisée depuis src/definitions.ts dans capacitor-pdf-viewer.

Continuer depuis @capgo/capacitor-pdf-viewer

Si vous utilisez @capgo/capacitor-pdf-viewer dans votre application Capacitor, connectez-l’avec Utiliser @capgo/capacitor-pdf-viewer pour le tutoriel SEO et la documentation associée du plugin Capgo.