@capgo/capacitor-inappbrowser

Ringkasan

@capgo/capacitor-inappbrowser memberikan aplikasi Capacitor dua jalur browser: open() untuk pengalaman browser sistem dan openWebView() untuk WebView native yang diatur yang dapat diukur, disembunyikan, dikirimkan pesan, diskrrip, di-proxy, dan dilapis dengan UI Ionic.

Gunakan fitur ini ketika halaman memerlukan lebih dari sekadar browser eksternal sederhana: alur OAuth dan pembayaran, portal dukungan terintegrasi, layar pembayaran, panggilan video, portal dokumen, aplikasi web interaktif, atau alur mana pun di mana aplikasi Anda memerlukan kontrol native di sekitar konten web yang hidup.

Nama paket telah berubah.

Penggunaan Umum

• Tampilkan UI Ionic atau Capacitor di atas halaman browser yang hidup dengan toBack, sendToBack(), bringToFront(), transparentBackground, dan dispatchInputEvent().
• Buat browser layar setengah, sheet bawah, dan tampilan web dalam gambar dengan width, height, x, y, dan updateDimensions().
• Biarkan pengguna mengetuk aplikasi Capacitor di luar frame browser ukuran kustom pada Android dan iOS.
• Jalankan alur pembayaran, login, dukungan, atau alur perubahan akun tanpa penyimpanan situs web yang persisten menggunakan persistWebViewData: false dan clearAllBrowsingData().
• Teruskan beberapa instance browser yang dimuat dengan hidden, hide(), dan show() serta menjaga keadaan halaman.
• Integrasikan aplikasi web canggih yang memerlukan proxy permintaan, unggahan file, download, pengontrol popup, dukungan Google Pay, pengelolaan link, dan pesan aplikasi ke halaman. _blank Kemampuan Utama

Bagian berjudul “Kemampuan Utama”

• open - Membuka WebView native yang diatur dengan toolbar kustom, ukuran, navigasi native, pesan, skrip, proxy, download, popup, dan kontrol data. SFSafariViewController - Menggeser browser yang diatur ke belakang atau di atas WebView host __CAPGO_KEEP_0__.
• openWebView - Mengalihkan peristiwa klik, sentuh, dan gulir ke browser yang berada di belakang UI aplikasi native.
• sendToBack / bringToFront - Moves a managed browser behind or above the Capacitor host WebView.
• dispatchInputEvent Section titled “Core Capabilities”
• updateDimensions - Mengubah ukuran dan posisi WebView yang diatur tanpa memuat ulang halaman.
• hide / show - Menyimpan WebViews yang diatur yang telah dimuat sementara menghapus atau mengembalikan presentasi aslinya.
• postMessage / executeScript - Menghubungkan aplikasi Capacitor dengan JavaScript yang berjalan di dalam halaman yang diatur.
• clearAllBrowsingData / persistWebViewData - Mengontrol cookie, cache, penyimpanan, IndexedDB, dan persistensi sesi.
• handleDownloads- Pengaturan proxy, dan event popup - Mendukung portal dokumen, aliran unggah, halaman pembayaran, dan aplikasi web terintegrasi.

- Aplikasi API yang terbuka.

- Metode	- Deskripsi
goBack	- Membalikkan sejarah di WebView jika memungkinkan.
open	- Membuka URL di jendela baru penuh layar, di android menggunakan chrome custom tabs, di ios menggunakan SFSafariViewController.
clearCookies	- Membersihkan cookie URL ketika id ditiadakan, berlaku untuk semua webview yang terbuka.
clearAllCookies	Hapus semua cookie Ketika id ditiadakan, berlaku untuk semua webview yang terbuka.
clearCache	Hapus cache Ketika id ditiadakan, berlaku untuk semua webview yang terbuka.
clearAllBrowsingData	Menghapus cookie, cache, penyimpanan lokal, penyimpanan sesi, IndexedDB, dan data browsing lainnya dari penyimpanan default dan WebView yang diatur.
getCookies	Dapatkan cookie untuk URL tertentu.
close	Tutup webview. Ketika id ditiadakan, menutup webview aktif.
hide	Sembunyikan webview tanpa menutupnya. Gunakan show() untuk mengembalikannya. Ketika id ditiadakan, mengarahkan pada webview aktif.
show	Tampilkan kembali webview yang sebelumnya disembunyikan. Ketika id dijitakkan, mengarahkan ke webview aktif.
sendToBack	Menggeser browser native di belakang Capacitor host WebView agar UI aplikasi dapat muncul di atasnya.
bringToFront	Menggeser browser yang berada di belakang host WebView ke depan.
dispatchInputEvent	Mengirimkan input klik, sentuh, atau scroll ke browser yang diatur; koordinat relatif terhadap viewport browser.
openWebView	Membuka URL di webview baru dengan toolbar dan kemampuan yang ditingkatkan, seperti akses kamera, akses file, mendengarkan event, menginjeksi JavaScript, komunikasi dua arah, dll.
executeScript	Menginjeksi JavaScript code ke jendela InAppBrowser. Ketika id dijitakkan, dieksekusi di semua webview terbuka.
postMessage	Mengirimkan event ke webview (browser dalam aplikasi). Dengarkan di halaman dengan window.addEventListener('messageFromNative', listenerFunc)payload harus dapat diserialisasi ke JSON. Ketika detail dijitakkan, memancarkan ke semua webview terbuka. id Mengambil tangkapan layar webview saat ini sebagai screenshot PNG. Ketika
takeScreenshot	__CAPGO_KEEP_0__ id ditinggalkan, mengarahkan ke webview aktif.
setUrl	Mengatur URL webview. Ketika id ditinggalkan, mengarahkan ke webview aktif.
addListener	Tunggu perubahan URL, hanya untuk openWebView.
addListener	Tunggu buttonNearDoneClick ; isi payload berisi webview id.
addListener	Tunggu hanya klik close untuk openWebView.
addListener	Akan diaktifkan ketika pengguna mengklik tombol konfirmasi ketika disclaimer diperlukan, bekerja dengan openWebView shareDisclaimer dan closeModal.
addListener	Dipicu ketika webview mengirimkan event kembali ke aplikasi. Gunakan window.mobileApp.postMessage(...) di halaman, dan jaga isi payload dapat di serialisasi ke JSON.
addListener	Akan diaktifkan ketika screenshot diambil dari plugin API, tombol screenshot native, atau jembatan JavaScript yang diinjeksikan.
addListener	Akan diaktifkan ketika halaman dimuat.
addListener	Akan diaktifkan ketika terjadi kesalahan muat halaman.
addListener	Akan diaktifkan setelah pengelolaan download native menyimpan file secara lokal. Aktifkan fitur ini dengan handleDownloads: true ketika membuka webview.
addListener	Akan diaktifkan ketika pengelolaan download native gagal. Aktifkan fitur ini dengan handleDownloads: true ketika membuka webview.
addListener	Akan diaktifkan setiap kali halaman membuka popup/jendela baru. Gunakan id popup yang dikembalikan dengan executeScript, postMessage, show, hide, dan close.
addListener	Tetapkan untuk memantau permintaan yang diwakilkan oleh runtime native. Lebih baik addProxyHandler() dibandingkan dengan memanggilnya secara langsung.
addListener	Tetapkan untuk mendengarkan keluaran konsol JavaScript yang dihasilkan oleh halaman yang dielola. Aktifkan fitur ini dengan captureConsoleLogs: true ketika membuka webview.
handleProxyRequest	Metode internal yang digunakan oleh addProxyHandler() Mengirimkan keputusan proxy kembali ke asli. Kirimkan asli. phase Mengirimkan keputusan proxy kembali ke asli ketika menjawab manual. proxyRequest Menggunakan pemangku jawab.
removeAllListeners	Menghapus semua pemangku jawab untuk plugin ini.
reload	Mengisi ulang halaman web saat ini.
updateDimensions	Mengupdate dimensi dari webview. Memungkinkan mengubah ukuran dan posisi webview pada waktu runtime. Ketika id Mengatur margin atas yang aman yang diaktifkan dari webview pada waktu runtime. Ketika
setEnabledSafeTopMargin	Mengatur margin bawah yang aman yang diaktifkan dari webview pada waktu runtime. Ketika id Mengatur margin atas yang aman yang diaktifkan dari webview pada waktu runtime. Ketika
setEnabledSafeBottomMargin	Membuka jendela OAuth2 yang aman. Pada web, kembalikan URL yang diarahkan melalui id __CAPGO_KEEP_0__
openSecureWindow	__CAPGO_KEEP_1__ BroadcastChanneldi ponsel, daftarkan URI pengalihan kustom di konfigurasi aplikasi Anda. Lihat panduan getting-started untuk contoh HTML, Info.plist, dan AndroidManifest yang lengkap.

Nilai Referensi

Pakai nilai-nilai ini bersamaan dengan opsi toolbar ketika membuka browser dalam aplikasi atau WebView.

Jenis Toolbar

Nilai	Pengguna akan menemukan
activity	Toolbar sederhana dengan kontrol tutup dan berbagi.
compact	Toolbar sederhana dengan kontrol tutup.
navigation	Toolbar navigasi lengkap dengan kontrol mundur dan maju.
blank	Tidak ada toolbar.

Sumber Kebenaran

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

Teruskan dari @capgo/capacitor-inappbrowser

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