Langsung ke konten

@capgo/capacitor-inappbrowser

In-app browser native untuk Capacitor dengan managed WebViews, native UI layering, private sessions, proxying, download, popup, dan app messaging.

@capgo/capacitor-inappbrowser memberikan dua jalur browser untuk aplikasi Capacitor: open() untuk pengalaman browser sistem dan openWebView() untuk WebView native terkelola yang bisa diatur ukurannya, disembunyikan, dikirimi pesan, di-script, di-proxy, dan dilapisi Ionic UI oleh app Anda.

Gunakan saat halaman butuh lebih dari sekadar browser eksternal: alur OAuth dan checkout, portal dukungan tersemat, layar pembayaran, video call, portal dokumen, web app interaktif, atau alur apa pun yang butuh kontrol native di sekitar konten web live.

Nama package berubah.
  • Tampilkan UI Ionic atau Capacitor di atas halaman browser live dengan toBack, sendToBack(), bringToFront(), transparentBackground, dan dispatchInputEvent().
  • Buat browser layar parsial, bottom sheet, dan webview picture-in-picture dengan width, height, x, y, dan updateDimensions().
  • Biarkan pengguna tap app Capacitor di luar frame browser berukuran custom di Android dan iOS.
  • Jalankan alur checkout, login, dukungan, atau pergantian akun tanpa penyimpanan situs web yang persisten menggunakan persistWebViewData: false dan clearAllBrowsingData().
  • Jaga beberapa instans browser tetap dimuat dengan hidden, hide(), dan show() sambil mempertahankan status halaman.
  • Sematkan aplikasi web canggih yang memerlukan proxy permintaan, upload file, download, kontrol popup, dukungan Google Pay, _blank penanganan link, dan pesan antar-aplikasi ke halaman.
  • open - Membuka URL di Chrome Custom Tabs di Android atau SFSafariViewController di iOS.
  • openWebView - Membuka WebView native yang dikelola dengan toolbar kustom, ukuran, navigasi native, messaging, scripting, proxy, unduhan, popup, dan kontrol data.
  • sendToBack / bringToFront - Memindahkan browser yang dikelola ke belakang atau di atas WebView host Capacitor.
  • dispatchInputEvent - Meneruskan event klik, sentuh, dan gulir ke browser yang berada di belakang UI aplikasi native.
  • updateDimensions - Mengubah ukuran dan posisi WebView yang dikelola tanpa memuat ulang halaman.
  • hide / show - Menjaga WebView yang dikelola tetap termuat saat presentasi native-nya dihapus atau dipulihkan.
  • postMessage / executeScript - Menghubungkan aplikasi Capacitor dengan JavaScript yang berjalan di dalam halaman yang dikelola.
  • clearAllBrowsingData / persistWebViewData - Mengontrol cookie, cache, storage, IndexedDB, dan persistensi sesi.
  • handleDownloads, aturan proxy, dan event popup - Mendukung portal dokumen, alur upload, halaman pembayaran, dan aplikasi web tertanam.
MetodeDeskripsi
goBackNavigasi mundur dalam riwayat WebView jika memungkinkan.
openBuka url di jendela baru fullscreen; di android menggunakan chrome custom tabs, di ios menggunakan SFSafariViewController.
clearCookiesBersihkan cookies dari url Ketika id dihilangkan, berlaku untuk semua webviews yang terbuka.
clearAllCookiesBersihkan semua cookies Ketika id dihilangkan, berlaku untuk semua webviews yang terbuka.
clearCacheBersihkan cache Ketika id dihilangkan, berlaku untuk semua webviews yang terbuka.
clearAllBrowsingDataMembersihkan cookies, cache, local storage, session storage, IndexedDB, dan data penelusuran lainnya dari default store dan WebViews yang dikelola.
getCookiesAmbil cookies untuk URL tertentu.
closeTutup webview. Ketika id dihilangkan, webview yang aktif akan ditutup.
hideSembunyikan webview tanpa menutupnya. Gunakan show() untuk menampilkannya kembali. Ketika id Jika dihilangkan, menargetkan webview yang aktif.
showTampilkan webview yang sebelumnya disembunyikan. Ketika id Jika dihilangkan, menargetkan webview yang aktif.
sendToBackPindahkan browser native ke belakang host WebView Capacitor agar UI aplikasi dapat muncul di atasnya.
bringToFrontPindahkan browser yang berada di belakang host WebView kembali ke depan.
dispatchInputEventKirim input klik, sentuh, atau gulir ke browser yang dikelola; koordinat relatif terhadap viewport browser.
openWebViewBuka url di webview baru dengan toolbar dan kemampuan yang ditingkatkan, seperti akses kamera, akses file, event listener, injeksi javascript, komunikasi dua arah, dll.
executeScriptSuntikkan code JavaScript ke jendela InAppBrowser. Ketika id dihilangkan, dieksekusi di semua webview yang terbuka.
postMessageKirim event ke webview (in-app browser). Dengarkan di halaman dengan window.addEventListener('messageFromNative', listenerFunc). detail payload harus dapat diserialisasi ke JSON. Ketika id dihilangkan, akan broadcast ke semua webview yang terbuka.
takeScreenshotMengambil screenshot viewport webview saat ini dalam format PNG. Saat id Jika dihilangkan, menargetkan webview yang aktif.
setUrlMengatur URL webview. Saat id Jika dihilangkan, menargetkan webview yang aktif.
addListenerDengarkan perubahan URL, hanya untuk openWebView.
addListenerPantau saat buttonNearDoneClick; payload berisi webview id.
addListenerDengarkan klik tutup hanya untuk openWebView.
addListenerAkan dipicu saat user klik tombol konfirmasi jika disclaimer diperlukan, bekerja dengan openWebView shareDisclaimer dan closeModal.
addListenerDipicu saat webview mengirim event kembali ke app. Gunakan window.mobileApp.postMessage(...) di dalam halaman, dan pastikan payload bersifat JSON-serializable.
addListenerAkan dipicu setiap kali tangkapan layar diambil melalui plugin API, tombol screenshot bawaan, atau bridge JavaScript yang disuntikkan.
addListenerAkan dipicu saat halaman dimuat.
addListenerAkan dipicu saat terjadi error pemuatan halaman.
addListenerAkan dipicu setelah native download handling menyimpan file secara lokal. Aktifkan ini dengan handleDownloads: true saat membuka webview.
addListenerAkan dipicu saat native download handling gagal. Aktifkan ini dengan handleDownloads: true saat membuka webview.
addListenerAkan dipicu setiap kali halaman membuka popup/jendela baru. Gunakan popup id yang dikembalikan dengan executeScript, postMessage, show, hide, dan close.
addListenerDengarkan request yang di-proxy dan didelegasikan oleh native runtime. Sebaiknya gunakan addProxyHandler() daripada memanggil ini secara langsung.
addListenerDengarkan output console JavaScript dari halaman yang dikelola. Aktifkan ini dengan captureConsoleLogs: true saat membuka webview.
handleProxyRequestMetode internal yang digunakan oleh addProxyHandler() untuk mengirim keputusan proxy kembali ke native. Teruskan phase saat membalas manual proxyRequest listener lama.
removeAllListenersHapus semua listener plugin ini.
reloadMuat ulang halaman web saat ini.
updateDimensionsPerbarui dimensi webview. Mengizinkan perubahan ukuran dan posisi webview saat runtime. Saat id Jika dihilangkan, menargetkan webview yang aktif.
setEnabledSafeTopMarginMengatur margin atas aman yang diaktifkan pada webview saat runtime. Ketika id dihapus, menargetkan webview aktif. Di Web, metode ini tidak melakukan apa-apa dan menyelesaikan tanpa mengubah layout.
setEnabledSafeBottomMarginMengatur margin bawah aman yang diaktifkan untuk webview saat runtime. Ketika id dihapus, menargetkan webview aktif. Di Web, metode ini tidak melakukan apa-apa dan menyelesaikan tanpa mengubah layout.
openSecureWindowMembuka jendela OAuth2 yang aman. Di web, kembalikan URL yang dialihkan melalui BroadcastChannel; di mobile, daftarkan URI redirect kustom di konfigurasi aplikasi Anda. Lihat panduan getting-started untuk contoh lengkap HTML, Info.plist, dan AndroidManifest.

Gunakan nilai-nilai ini dengan opsi toolbar saat membuka in-app browser atau WebView.

NilaiPengguna akan menemukan
activityToolbar sederhana dengan kontrol tutup dan bagikan.
compactToolbar sederhana dengan kontrol tutup.
navigationToolbar navigasi lengkap dengan kontrol mundur dan maju.
blankTanpa toolbar.

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

Lanjutkan dari @capgo/capacitor-inappbrowser

Bagian berjudul “Lanjutkan dari @capgo/capacitor-inappbrowser”

Jika Anda menggunakan @capgo/capacitor-inappbrowser untuk merencanakan pekerjaan plugin native, hubungkan dengan Menggunakan @capgo/capacitor-inappbrowser untuk kemampuan native saat menggunakan @capgo/capacitor-inappbrowser, Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin Capacitor oleh Capgo untuk detail implementasi pada Capacitor Plugins oleh Capgo Menambahkan atau Memperbarui Plugin untuk detail implementasi di Menambahkan atau Memperbarui Plugin, dan Alternatif Plugin Ionic Enterprise untuk alur kerja produk dalam Alternatif Plugin Ionic Enterprise.