@capgo/capacitor-pdf-viewer

underWebView / toBack

Öffnen mit mode: 'underWebView' oder toBack: true um die native PDF hinter einer transparenten Capacitor WebView zu positionieren. nativeUi standardmäßig false in diesem Modus, damit du dein eigenes HTML-Chrome bereitstellen kannst.

Eigene HTML-Steuerungselemente

Zeige Toolbars, Seitenindikatoren und Buttons in HTML an (Ionic, Tailwind oder reines Markup). Die native Ebene behält Scrollen, Pinch-Zoom und Link-Hit-Testing von PDFKit / Pdfium bei.

Touch-Routing

Touches auf button, a, Formularfeldern, [data-capgo-pdf-interactive], .custom-toolbar, und .custom-pdf-ui button bleiben im WebView. Andere Touches gehen an das PDF.

updateLayout()

Positioniert oder skaliert das native PDF in CSS-Pixeln relativ zum WebView-Viewport. Rufen Sie es nach einer Drehung oder wenn sich die Größe Ihrer Chrome-Elemente ändert, auf.

Tipp

underWebView / toBack ist nur für iOS und Android. Im Web verwenden Sie fullscreen oder inline. Komplettes Setup: underWebView.

Übersicht

Integriere natives PDF-Anzeigen auf iOS, Android und Web mit Pfaden, URLs, base64, Inline-Modus, Passwort-Support und optionaler underWebView-Präsentation für benutzerdefinierte HTML-UIs.

Starte mit open() und den anderen unten aufgeführten Core-Methoden.

Plattformunterstützung

Plattform	Support	Notizen
iOS	Ja	PDFKit. underWebView / toBack wird unterstützt. hide() und show() are accepted only in underWebView oder inline mode.
Android	Ja	Pdfium. underWebView / toBack wird unterstützt. hide() und show() funktionieren in jedem offenen Modus.
Web	Teilweise	Browser-PDF-Viewer mit Blob-URLs. underWebView / toBack ist nicht verfügbar. Verwenden Sie fullscreen oder inline. nativeUi: false mit mode: 'fullscreen' wird abgelehnt.

Kernfunktionen

• open - Open a PDF from a file, path, URL, or base64 source, including mode: 'underWebView' oder toBack: true.
• close - Aktiven Viewer schließen und Overlays entfernen.
• goToPage / nextPage / previousPage - Jump or step through 1-based pages.
• setZoom - Setzen Sie den Zoom-Skalierungsfaktor (1 ist die Standard-Größe auf nativer Ebene).
• hide / show - PDF-Ebene ein- oder ausblenden, ohne das Dokument zu entladen.
• updateLayout - Position oder Größe des nativen PDFs ändern underWebView / toBack mode.

Öffentliches API

Methode	Beschreibung
open	PDF aus Datei, Pfad, URL oder base64-Quelle öffnen.
close	Aktiven Viewer schließen und Overlay entfernen.
goToPage	Zu einer 1-basierten Seitennummer springen.
nextPage	Zur nächsten Seite wechseln, sofern vorhanden.
previousPage	Wechselt zur vorherigen Seite, wenn diese existiert.
setZoom	Setzt den Zoom-Skalierungsfaktor. Im Web wird dies aufgelöst, ohne den Browser-Zoom zu ändern.
getPageCount	Liest die Gesamtseitenzahl. Im Web gibt dies immer zurück 1.
getCurrentPage	Liest die aktuelle 1-basierte Seite. Im Web spiegelt dies nur die letzte programmatische Seite wider.
hide	Blendet die PDF-Ebene aus, ohne das Dokument zu entladen.
show	Zeigt die PDF-Ebene nach hide().
updateLayout	Positioniert oder ändert die Größe des nativen PDFs, wenn verwendet underWebView / toBack.
getPluginVersion	Ruft die Versionsmarke der nativen oder Web-Implementierung ab.
addListener	Lauscht auf load, pageChange, zoomChange, error, close, und linkTap Events.

Source of Truth

Diese Referenz wird synchronisiert von src/definitions.ts in einem capacitor-pdf-viewer.

Weiter geht's mit @capgo/capacitor-pdf-viewer

Wenn du es nutzt @capgo/capacitor-pdf-viewer in deiner Capacitor-App, verbinde sie mit Mit @capgo/capacitor-pdf-viewer für das SEO-Tutorial und die zugehörigen Capgo-Plugin-Dokumentationen.