Menggunakan @capgo/capacitor-inappbrowser
@capgo/capacitor-inappbrowser membuka konten web eksternal dari aplikasi Capacitor. Gunakan open() untuk tampilan browser platform, atau openWebView() saat aplikasi Anda membutuhkan WebView native terkelola dengan ukuran kustom, toolbar, pesan, script, download, proxy, kontrol popup, penyimpanan privat, atau Ionic UI di atas halaman.
Instal
npm install @capgo/capacitor-inappbrowser
npx cap sync
Apa yang Diekspos Plugin Ini
- Alur browser sistem dengan Chrome Custom Tabs di Android dan
SFSafariViewControllerdi iOS. - WebView yang dikelola, dapat diukur, disembunyikan, ditampilkan, dipindahkan ke belakang aplikasi Capacitor, dan dikembalikan ke depan.
- Penerusan klik, sentuh, dan gulir dengan
dispatchInputEvent()ketika UI aplikasi berada di atas browser. - Browser layar parsial di mana sentuhan di luar bingkai WebView native diteruskan ke aplikasi Capacitor di Android dan iOS.
- Pembersihan cookie, cache, dan data penelusuran lengkap dengan
persistWebViewData,clearCookies,clearAllCookies,clearCache, danclearAllBrowsingData. - Komunikasi aplikasi-ke-halaman dengan
postMessage(), komunikasi halaman-ke-aplikasi denganwindow.mobileApp.postMessage(...), dan script injection denganexecuteScript(). - Penanganan download, aturan proxy native-first, kontrol popup, dukungan Google Pay,
_blankpenanganan link, dan instance browser preloadable yang tersembunyi.
Kasus Penggunaan Umum
Letakkan UI App di Atas Browser Live
import { InAppBrowser } from '@capgo/capacitor-inappbrowser';
const { id } = await InAppBrowser.openWebView({
url: 'https://example.com/checkout',
toBack: true,
transparentBackground: true,
});
await InAppBrowser.dispatchInputEvent({
id,
type: 'click',
x: 160,
y: 420,
});
await InAppBrowser.bringToFront({ id });
Gunakan ini untuk overlay checkout, alur pembayaran berbasis browser, alur panduan dukungan, atau fitur apa pun di mana kontrol Ionic harus tetap di atas konten web live.
Jaga App Tetap Dapat Diklik di Sekitar Browser Sheet
const { id } = await InAppBrowser.openWebView({
url: 'https://example.com/offers',
height: window.innerHeight - 200,
y: 0,
});
await InAppBrowser.updateDimensions({ id, height: window.innerHeight });
Browser dengan ukuran kustom hanya menangkap sentuhan di dalam bingkainya. Area app yang terlihat lainnya tetap dapat disentuh di Android dan iOS.
Hindari Sesi Web yang Persisten
const { id } = await InAppBrowser.openWebView({
url: 'https://example.com/login',
persistWebViewData: false,
});
await InAppBrowser.clearAllBrowsingData();
await InAppBrowser.close({ id });
Gunakan ini untuk pengalihan akun, pengujian checkout, impersonasi dukungan, atau alur autentikasi di mana cookie, cache, local storage, dan IndexedDB tidak boleh bertahan lebih lama dari yang diperlukan.
Preload dan Ganti Beberapa WebView
const first = await InAppBrowser.openWebView({ url: 'https://example.com/a', hidden: true });
const second = await InAppBrowser.openWebView({ url: 'https://example.com/b', hidden: true });
await InAppBrowser.show({ id: first.id });
await InAppBrowser.hide({ id: first.id });
await InAppBrowser.show({ id: second.id });
Instance tersembunyi menjaga state mereka tetap tersedia sambil menghindari overlay native yang menghalangi sentuhan app.
Sematkan Web App Lanjutan
const { id } = await InAppBrowser.openWebView({
url: 'https://example.com/portal',
handleDownloads: true,
openBlankTargetInWebView: true,
hiddenPopupWindow: true,
outboundProxyRules: [
{
urlRegex: '^https://example\\.com/api/',
action: 'delegateToJs',
},
],
});
await InAppBrowser.postMessage({
id,
detail: { source: 'app', action: 'refresh' },
});
Gunakan pola ini untuk portal dokumen, alur upload, meja dukungan, panggilan video, halaman Google Pay, atau web app interaktif yang membutuhkan kontrol aplikasi native tanpa keluar dari shell aplikasi.
Referensi Lengkap
- GitHub: https://github.com/Cap-go/capacitor-inappbrowser/
- Docs: /docs/plugins/inappbrowser/
Lanjutkan dari Menggunakan @capgo/capacitor-inappbrowser
Jika Anda menggunakan Menggunakan @capgo/capacitor-inappbrowser untuk merencanakan pekerjaan plugin native, hubungkan dengan @capgo/capacitor-inappbrowser untuk detail implementasi di @capgo/capacitor-inappbrowser, Panduan Memulai untuk detail implementasi di Getting Started, Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin Capacitor oleh Capgo untuk detail implementasi di Plugin Capacitor oleh Capgo, dan Menambahkan atau Memperbarui Plugin untuk detail implementasi di bagian Menambahkan atau Memperbarui Plugin.