Skip to content

@capgo/capacitor-inappbrowser

Capacitorのネイティブインアプリブラウザです。管理されたウェブビュー、ネイティブUIレイヤー、プライベートセッション、プロキシ、ダウンロード、ポップアップ、そしてアプリメッセージングをサポートしています。

@capgo/capacitor-inappbrowser gives Capacitor アプリケーションに 2 つのブラウザ パスを提供します: open() システムブラウザのエクスペリエンス用と openWebView() 管理されたネイティブ WebView のエクスペリエンス用で、

アプリがサイズ、非表示、メッセージ、スクリプト、プロキシ、レイヤーと Ionic UI を使用できます。

@__CAPGO_KEEP_0__/inappbrowser から @__CAPGO_KEEP_1__/__CAPGO_KEEP_2__-inappbrowser に名前が変更されました。

パッケージ名が変更されました。

一般的な使用例
  • Present Ionic or Capacitor UI above a live browser page with toBack, sendToBack(), bringToFront(), transparentBackgrounddispatchInputEvent().
  • AndroidおよびiOSで、画面の一部をカバーするブラウザ、下部シート、ピクチャーインピクチャーWebビューをビルドする width, height, x, yupdateDimensions().
  • AndroidおよびiOSで、カスタムサイズのブラウザフレーム外部のCapacitorアプリにタップすることをユーザーに許可する
  • persistWebViewData: false 永続的なウェブサイトストレージを使用せずにチェックアウト、ログイン、サポート、またはアカウント切り替えフローを実行する clearAllBrowsingData().
  • hidden, hide()複数のブラウザインスタンスをロードし、 show()
  • ページの状態を保存しながら _blank 高度なWebアプリを埋め込むことができる。リクエストプロキシング、ファイルアップロード、ダウンロード、ポップアップの制御、Google Payのサポート、

リンクの処理、そしてアプリからページへのメッセージングを必要とするアプリケーションを含む。

Core Capabilities
  • open AndroidまたはiOSでChrome Custom Tabsを開きます。 SFSafariViewController カスタムツールバー、サイズ、ネイティブナビゲーション、メッセージング、スクリプティング、プロキシ、ダウンロード、ポップアップ、データコントロールを備えた管理されたネイティブWebビューを開きます。
  • openWebView ホストWebビューの後ろまたは上に管理されたブラウザを移動します。
  • sendToBack / bringToFront - Moves a managed browser behind or above the Capacitor host WebView.
  • dispatchInputEvent ページを再読み込みせずに管理されたWebビューのサイズと位置を変更します。
  • updateDimensions 管理されたWebビューをロードしたままにしながら、またはそのネイティブプレゼンテーションを復元するときに、ロードを削除します。
  • hide / show __CAPGO_KEEP_0__アプリと管理ページ内で実行中のJavaScriptを接続します。
  • postMessage / executeScript - Connects the Capacitor app with JavaScript running inside the managed page.
  • clearAllBrowsingData / persistWebViewData ドキュメントポータル、アップロードフロー、支払いページ、埋め込まれたWebアプリをサポートします。
  • handleDownloads__CAPGO_KEEP_0__
メソッド説明
goBackWebViewの履歴を戻すことができる場合は戻します。
open新しいウィンドウでフルスクリーンでURLを開きます。AndroidではChromeカスタムタブを使用し、iOSではSFSafariViewControllerを使用します。
clearCookiesURLのクッキーを消去する When id 省略すると、すべての開いているWeb Viewに適用されます。
clearAllCookiesすべてのクッキーを消去する When id 省略すると、すべての開いているWeb Viewに適用されます。
clearCacheキャッシュを消去する When id 省略すると、すべての開いているWeb Viewに適用されます。
clearAllBrowsingDataデフォルトのストアと管理されたWeb Viewからクッキー、キャッシュ、ローカルストレージ、セッションストレージ、IndexedDB、他のブラウジングデータを消去します。
getCookiesURLに特定のCookieを取得します。
closeウェブビューを閉じます。省略すると、現在アクティブなウェブビューが閉じます。 id ウェブビューを非表示にします。show()を使用して元に戻すことができます。省略すると、現在アクティブなウェブビューが対象になります。
hide以前のウェブビューを表示します。省略すると、現在アクティブなウェブビューが対象になります。 id ホストのWebViewの背後にあるネイティブブラウザを移動させて、アプリのUIが上に表示されるようにします。
showホストのWebViewの背後から移動したブラウザを前面に戻します。 id マネージドブラウザにクリック、タッチ、またはスクロール入力を送信します。座標はブラウザのビュー ポートからの相対値です。
sendToBackMoves the native browser behind the Capacitor host WebView so app UI can appear above it.
bringToFrontインアプリブラウザのウィンドウにJavaScriptをインジェクトします。__CAPGO_KEEP_0__
dispatchInputEvent__CAPGO_KEEP_0__
openWebView__CAPGO_KEEP_0__
executeScriptcode id 省略され、すべてのオープンウェブビューで実行されます。
postMessageウェブビュー (インアプリブラウザ) へのイベントを送信します。ページで window.addEventListener('messageFromNative', listenerFunc)detail ペイロードは JSON としてシリアライズ可能でなければなりません。省略されると、すべてのオープンウェブビューにブロードキャストされます。 id 現在のウェブビューのビューポートを PNG スクリーンショットとしてキャプチャします。省略されると、有効なウェブビューをターゲットにします。
takeScreenshotウェブビューの URL を設定します。省略されると、有効なウェブビューをターゲットにします。 id オープンウェブビューでの URL の変更をリスンします。
setUrlオープンウェブビューでの id ウェブビューのURLの変更をリスンします。
addListenerペイロードにはウェブビューが含まれます。
addListenerウェブビュー buttonNearDoneClickウェブビュー id.
addListener開放されたWebビューでクリックのみをリスンします。
addListenerユーザーが確認ボタンをクリックしたときにトリガーされます。ディスクリーマーが必要な場合、openWebViewのshareDisclaimerとcloseModalと一緒に機能します。
addListenerWebビューがイベントをアプリに送信したときに発火します。 window.mobileApp.postMessage(...) ページ内で使用し、ペイロードをJSONシリアライズ可能にします。
addListenerAPIのプラグイン、ネイティブのスクリーンショットボタン、またはインジェクションされたJavaScriptブリッジからスクリーンショットがキャプチャされたときにトリガーされます。
addListenerページが読み込まれたときにトリガーされます。
addListenerページ読み込みエラーのときにトリガーされます。
addListenerネイティブのダウンロードハンドリングがローカルにファイルを保存したときにトリガーされます。 handleDownloads: true openWebViewのときに有効にするには、
addListenerネイティブのダウンロードハンドリングが失敗したときにトリガーされます。 handleDownloads: true openWebViewのときに有効にするには、
addListenerページがポップアップ/新しいウィンドウを開いたときにトリガーされます。返されたポップアップIDを使用してください。 executeScript, postMessage, show, hide, および close.
addListenerプロキシされたリクエストをデリゲートするネイティブランタイムによって委譲されたリクエストをリスンする。 addProxyHandler() __CAPGO_KEEP_0__の代わりに直接呼び出すのではなく。
addListenerマネージドページによって発行されたJavaScriptコンソール出力をリスンする。__CAPGO_KEEP_0__で有効にする。 captureConsoleLogs: true __CAPGO_KEEP_0__で開くときに。
handleProxyRequest__CAPGO_KEEP_0__によってネイティブに送信されるプロキシ決定を送信するために使用される内部メソッド。 addProxyHandler() __CAPGO_KEEP_0__の返答に対して手動でリスナーを呼び出す場合に元の__CAPGO_KEEP_0__を転送する。 phase __CAPGO_KEEP_0__のリスナーをすべて削除する。 proxyRequest 現在のウェブページをリロードする。
removeAllListenersウェブビューのサイズと位置を実行時で変更することを許可するウェブビューの寸法を更新する。
reloadwhen opening the webview.
updateDimensionsto send a proxy decision back to native. id は省略され、現在のウェブビューをターゲットにします。
setEnabledSafeTopMarginウェブビューの有効な安全上部マージンを実行時で設定します。 id は省略され、現在のウェブビューをターゲットにします。ウェブ上では、このメソッドは無効であり、レイアウトを変更せずに解決されます。
setEnabledSafeBottomMarginウェブビューの有効な安全下部マージンを実行時で設定します。 id は省略され、現在のウェブビューをターゲットにします。ウェブ上では、このメソッドは無効であり、レイアウトを変更せずに解決されます。
openSecureWindow安全なOAuth2ウィンドウを開きます。ウェブ上では、リダイレクトされたURLを返します。;モバイルでは、カスタムリダイレクトURIをアプリの構成に登録します。詳細なHTML、Info.plist、AndroidManifestの例については、getting-startedガイドを参照してください。 BroadcastChannel参照値

ツールバーの種類

「ツールバーの種類」のセクション

__CAPGO_KEEP_0__
Valueユーザーは
activity単純なツールバーに閉じると共有のコントロールが含まれています。
compact単純なツールバーに閉じるコントロールが含まれています。
navigationフルナビゲーションツールバーに戻ると進むのコントロールが含まれています。
blankツールバーが表示されていません。

このリファレンスは src/definitions.ts から capacitor-inappbrowser.

@capgo/capacitor-inappbrowserから続けます。

@capgo/capacitor-inappbrowser”の続き”

__CAPGO_KEEP_0__が利用している場合” @capgo/capacitor-inappbrowser” @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-inappbrowser”と連携することで” @capgo/capacitor-inappbrowser”を使用することで” @capgo/capacitor-inappbrowser”のnative capabilityを使用することで” @Capgo/__CAPGO_KEEP_1__-inappbrowser”のディレクトリ” @Capgo/__CAPGO_KEEP_1__-inappbrowser”のディレクトリ内での製品ワークフロー” @Capacitor”が@Capgoによって提供されるプラグイン” for the implementation detail in Capacitor Plugins by Capgo, @__CAPGO_KEEP_0__プラグインの追加または更新”の詳細” @__CAPGO_KEEP_0__プラグインの追加または更新”の詳細 Ionic Enterprise Plugin の代替 Ionic Enterprise Plugin の製品ワークフロー用の代替.