@capgo/capacitor-pdf-viewer

underWebView / toBack

Buka dengan mode: 'underWebView' atau toBack: true untuk menempatkan PDF native di belakang Capacitor WebView transparan. nativeUi default-nya false dalam mode ini agar Anda bisa menyediakan HTML chrome sendiri.

Kontrol HTML kustom

Gambar toolbar, indikator halaman, dan tombol dalam HTML (Ionic, Tailwind, atau markup polos). Lapisan native tetap menangani scroll PDFKit / Pdfium, pinch zoom, dan hit testing tautan.

Rute sentuhan

Sentuhan pada button, a, kontrol formulir, [data-capgo-pdf-interactive], .custom-toolbar, dan .custom-pdf-ui button tetap di dalam WebView. Sentuhan lainnya diteruskan ke PDF.

updateLayout()

Mengubah posisi atau ukuran PDF native dalam piksel CSS relatif terhadap viewport WebView. Panggil setelah rotasi atau saat ukuran chrome Anda berubah.

Tips

underWebView / toBack hanya untuk iOS dan Android. Di web, gunakan fullscreen atau inline. Setup lengkap: underWebView.

Ikhtisar

Sematkan tampilan PDF native di iOS, Android, dan web dengan path, URL, base64, mode inline, dukungan kata sandi, dan presentasi underWebView opsional untuk UI HTML kustom.

Mulai dengan open() dan metode inti lainnya yang tercantum di bawah ini.

Dukungan platform

Platform	Dukungan	Catatan
iOS	Ya	PDFKit. underWebView / toBack is supported. hide() dan show() hanya diterima dalam underWebView atau inline mode.
Android	Ya	Pdfium. underWebView / toBack is supported. hide() dan show() berfungsi dalam mode terbuka apa pun.
Web	Parsial	Penampil PDF browser dengan URL blob. underWebView / toBack tidak tersedia. Gunakan fullscreen atau inline. nativeUi: false dengan mode: 'fullscreen' is rejected.

Kemampuan Utama

• open - Buka PDF dari file, path, URL, atau sumber base64, termasuk mode: 'underWebView' atau toBack: true.
• close - Tutup viewer yang aktif dan hapus semua overlay.
• goToPage / nextPage / previousPage - Lompat atau geser halaman berbasis 1.
• setZoom - Atur pengali skala zoom (1 adalah skala fit default di native).
• hide / show - Sembunyikan atau tampilkan layer PDF tanpa memuat ulang dokumen.
• updateLayout - Ubah posisi atau ukuran PDF native di underWebView / toBack mode.

API Publik

Metode	Deskripsi
open	Buka PDF dari file, path, URL, atau sumber base64.
close	Tutup viewer aktif dan hapus overlay apa pun.
goToPage	Lompat ke nomor halaman berbasis 1.
nextPage	Pindah ke halaman berikutnya jika ada.
previousPage	Pindah ke halaman sebelumnya jika ada.
setZoom	Atur pengali skala zoom. Di web, ini resolve tanpa mengubah zoom browser.
getPageCount	Baca jumlah total halaman. Di web, ini selalu mengembalikan 1.
getCurrentPage	Baca halaman saat ini (berbasis 1). Di web, ini hanya mencerminkan halaman programatik terakhir.
hide	Sembunyikan layer PDF tanpa meng-unload dokumen.
show	Tampilkan layer PDF setelah hide().
updateLayout	Ubah posisi atau ukuran PDF native saat menggunakan underWebView / toBack.
getPluginVersion	Dapatkan penanda versi implementasi native atau web.
addListener	Pantau saat load, pageChange, zoomChange, error, close, dan linkTap event.

Sumber Kebenaran

Referensi ini disinkronkan dari src/definitions.ts di capacitor-pdf-viewer.

Lanjutkan dari @capgo/capacitor-pdf-viewer

Jika Anda menggunakan @capgo/capacitor-pdf-viewer di aplikasi Capacitor Anda, hubungkan dengan Menggunakan @capgo/capacitor-pdf-viewer untuk tutorial SEO dan dokumentasi plugin Capgo terkait.