ネイティブ API 対応表
advanced_webview の公開 Dart API と、それが内部で使うネイティブの Android / iOS API の対応表です。 挙動やプラットフォーム差を Android・Apple の公式ドキュメントで調べるときや、機能がどちらの OS で使えるかを 確認するときに使います。 ↗ が付いたネイティブのクラス名は、公式ドキュメントへのリンクです。
| 状態 | 意味 |
|---|---|
| 対応 | その OS で動作します。 |
| 一部対応 | 注記のとおり差異があります。 |
| 作成時のみ | ネイティブビューの作成時に読まれ、updateSettings では無視されます。 |
| 非対応 | その OS では効果がありません。 |
ライフサイクルとウィジェット
AdvancedWebViewControllerネイティブ WebView を 1 つ作成して所有します。
AdvancedWebViewController.webViewId ネイティブ側へのすべての呼び出しで WebView を識別する ID です。
Dart のみ
AdvancedWebViewController.ready ネイティブ WebView の作成完了で完了する Future です。
Dart のみ
AdvancedWebViewController.isDisposed dispose() が呼ばれたかどうかです。
Dart のみ
AdvancedWebViewController.dispose ネイティブ WebView を破棄します。
AdvancedWebViewコントローラが所有する WebView をプラットフォームビューとして表示します。
AdvancedWebView.controller 表示する WebView を持つコントローラです。ネイティブのファクトリが webViewId で探します。
Dart のみ
AdvancedWebView.gestureRecognizers Flutter の AndroidView / UiKitView にそのまま渡されます。
Dart のみ
AdvancedWebView.viewType 両 OS の AdvancedWebViewFactory が登録するプラットフォームビューの種別です。
Dart のみ
読み込みと履歴
AdvancedWebViewController.loadUrl URL を読み込みます。リクエストヘッダも指定できます。
AdvancedWebViewController.loadHtmlString HTML 文字列を読み込みます。base URL も指定できます。
AdvancedWebViewController.loadRequest メソッド(GET または POST)、ヘッダー、POST の body を指定して URL を読み込みます。
Android 一部対応POST は application/x-www-form-urlencoded で送り、カスタムヘッダーは付けられません。ヘッダーを渡すと unsupported を投げます。
WebViewHttpMethodloadRequest の HTTP メソッド(get または post)です。
AdvancedWebViewController.loadFlutterAsset pubspec.yaml に宣言した Flutter アセットを読み込みます。
Android 対応https://appassets.androidplatform.net/assets/ から配信するため allowFileAccess は不要です。存在しないアセットは 404 として読み込まれます。
iOS 対応ページはアセットのあるフォルダを読み取れます。存在しないアセットは not-found を投げます。
AdvancedWebViewController.loadFile 端末上のファイルを絶対パスで読み込みます。
Android 一部対応AndroidWebViewSettings.allowFileAccess が必要で、無効の場合は file-access-disabled を投げます。
iOS 対応ページはファイルのあるフォルダを読み取れます。存在しないファイルは not-found を投げます。
AdvancedWebViewController.stopLoading 読み込みを中止します。
AdvancedWebViewController.goForward 履歴を 1 つ進みます。
AdvancedWebViewController.canGoBack 戻れる履歴があるかどうかです。
AdvancedWebViewController.canGoForward 進める履歴があるかどうかです。
AdvancedWebViewController.takeScreenshot WebView の表示領域を PNG として取得します。
AdvancedWebViewController.createPdf 現在のページを PDF にレンダリングし、そのバイト列を返します。
Android 対応
WebView.createPrintDocumentAdapter(String) PrintDocumentAdapter.onLayout(PrintAttributes, PrintAttributes, CancellationSignal, PrintDocumentAdapter.LayoutResultCallback, Bundle) PrintDocumentAdapter.onWrite(PageRange[], ParcelFileDescriptor, CancellationSignal, PrintDocumentAdapter.WriteResultCallback)
ページの印刷用スタイルで A4 ページにレイアウトし、一時ファイルに書き出します。コールバックのコンストラクタがパッケージプライベートなため、補助クラスは android.print パッケージにあります。AdvancedWebViewController.findText ページ内のテキストを検索してハイライトします。同じクエリを繰り返すと次/前の一致に移動します。
Android 対応
iOS 一部対応WebKit は一致の有無しか返さないため、matchCount はページのテキスト中のクエリ数(callAsyncJavaScript)、activeMatchIndex は検索方向に沿って数えます。どちらも best-effort です。
AdvancedWebViewController.clearMatches findText が付けたハイライトを消します。
iOS 対応window.getSelection().removeAllRanges() で選択を解除します。
AdvancedWebViewController.printPage 現在のページのシステム印刷ダイアログを開きます。
Android 対応
WebView.createPrintDocumentAdapter(String) PrintManager.print(String, PrintDocumentAdapter, PrintAttributes)
プラットフォームビューが表示されている Activity が必要です。AdvancedWebViewController.saveState 戻る/進む履歴とスクロール位置を、中身が不透明なバイト列として保存します。
AdvancedWebViewController.restoreState saveState のバイト列を復元します。読めない場合は false を返します。
AdvancedWebViewController.scrollTo ページを論理ピクセル単位の絶対位置へスクロールします(アニメーションなし)。
AdvancedWebViewController.scrollBy ページを論理ピクセル単位の相対量でスクロールします(アニメーションなし)。
AdvancedWebViewController.pause WebView を別の画面が覆っている間などに、ページのバックグラウンドでの動作を一時停止します。
AdvancedWebViewController.resume pause を元に戻します。
AdvancedWebViewController.pauseTimers アプリ内のすべての WebView のレイアウト、パース、JavaScript タイマーを一時停止します。
iOS 非対応WKWebView に相当する API はなく、何も起こりません。
AdvancedWebViewController.resumeTimers pauseTimers を元に戻します。
iOS 非対応WKWebView に相当する API はなく、何も起こりません。
AdvancedWebViewController.zoomBy ページのズーム倍率に係数を掛けます。
Android 対応係数は WebView が受け付ける 0.01〜100 の範囲に丸められます。supportZoom と builtInZoomControls が必要です。
iOS 対応スクロールビューがページのズーム範囲内に収めます。WKWebView.pageZoom は textZoom 用に使われています。
AdvancedWebViewController.setZoomScale ページのズーム倍率を設定します。
Android 対応WebView に絶対値で設定する API はないため、現在の倍率に対する目標倍率の比で zoomBy を呼びます。
AdvancedWebViewController.getZoomScale 現在のズーム倍率(CSS ピクセルあたりの論理ピクセル数)を返します。
AdvancedWebViewController.scrollPosition 現在のスクロール位置を論理ピクセルで返します。
FindResult検索語が見つかったかどうか。Android では一致数と現在の位置も含みます。
JavaScript
AdvancedWebViewController.hitTest 指定位置のリンクと画像を document.elementFromPoint で調べます。
WebViewHitTestResulthitTest が見つけたリンクと画像の URL です。
WebViewHitTestTypehitTest がリンク・画像・両方・どちらでもないのどれを見つけたかを表します。
AdvancedWebViewController.runJavaScript JavaScript を実行し、結果は無視します。
AdvancedWebViewController.runJavaScriptReturningResult JavaScript を実行し、結果を JSON からデコードして返します。
iOS 対応結果をネイティブ側で JSON にエンコードします。undefined と null は null になります。
AdvancedWebViewController.javaScriptChannels ページから window.<name>.postMessage(String) で呼べる名前付きチャネルです。
Android 対応作成時に登録します。インターフェースオブジェクトが postMessage を直接公開します。
iOS 対応Android と揃えるため、ドキュメント開始時のユーザースクリプトで window.<name>.postMessage を定義します。
AdvancedWebViewController.javaScriptHandlers ページから window.advanced_webview.callHandler(name, ...args) で呼べる名前付きハンドラです。Dart の戻り値がページ側の Promise の結果になります。
Android 対応WEB_MESSAGE_LISTENER と DOCUMENT_START_SCRIPT が必要です。ドキュメント開始時のシムが Web メッセージを Promise に変換し、返信は呼び出したフレームに届きます。
iOS 対応
WKUserContentController.addScriptMessageHandler(_:contentWorld:name:) WKScriptMessageHandlerWithReplyWKUserScript
reply ハンドラが Promise を解決します。ドキュメント開始時のユーザースクリプトが window.advanced_webview を定義します。AdvancedWebViewController.javaScriptHandlerObjectName callHandler を公開するグローバル(window.<name>)の名前です。既定値は advanced_webview です。
イベントとナビゲーション
AdvancedWebViewController.onFindResult 検索の進捗を通知します。現在の一致の位置、これまでの一致数、カウントが完了したかどうかです。
Android 対応WebView がカウントする間、更新のたびに呼ばれます。最後の更新まで isDone は false です。
iOS 一部対応findText の呼び出しごとに最終の更新が1回(isDone は常に true)届きます。WebKit は一致数と位置を返さないため、どちらも best-effort です。
AdvancedWebViewController.onPageStarted ページの読み込みが始まりました。
AdvancedWebViewController.onPageFinished ページの読み込みが完了しました。
AdvancedWebViewController.onProgress 読み込みの進捗(0〜100)です。
AdvancedWebViewController.onFaviconChanged 各ページの読み込み完了後に、そのファビコンの URL を通知します。
Android 対応WebChromeClient.onReceivedIcon が渡すのはデコード済みのビットマップで URL ではないため、iOS と揃えるようにページの link rel=icon を読み取ります。
iOS 対応WebKit には公開のファビコン API がないため、ページの link rel=icon を読み取ります。
AdvancedWebViewController.onRenderProcessGone Web コンテンツを描画するプロセスがクラッシュした、またはシステムに終了されました。
Android 対応アプリが終了しないようプラグインが true を返します。その後この WebView は使えないため、コントローラーを dispose して作り直してください。RenderProcessGone.didCrash は RenderProcessGoneDetail.didCrash() の値です。
iOS 対応reload を呼ぶまでビューは空白のままです。WebKit はクラッシュかどうかを伝えないため、RenderProcessGone.didCrash は null です。
AdvancedWebViewController.onEnterFullscreen ページ(動画などの要素)が全画面表示に入りました。
Android 対応プラグインがそのビューで Activity のウィンドウを覆い、システムバーを隠し、戻る操作で全画面を終了します。画面の向きは変更しません。Activity がない場合は要求を拒否します。
iOS 対応WebKit が独自の全画面ビューを表示します。プラグインは fullscreenState を KVO で監視し、要素の全画面 API を有効にします。
AdvancedWebViewController.onExitFullscreen ページが全画面表示を終了しました。
AdvancedWebViewController.onTitleChanged ページのタイトルが変わりました。
AdvancedWebViewController.onLongPress ユーザーがページを長押ししました。タッチ位置を論理ピクセルで通知します。
AdvancedWebViewController.onConsoleMessage ページが console.debug / log / info / warn / error を呼び出しました。
iOS 対応ユーザースクリプトが全フレームで console.debug / log / info / warn / error をラップし、スクリプトメッセージハンドラーへ送ります。WebKit はソース URL と行番号を報告しません。
WebViewConsoleMessageconsole 呼び出しのレベル・テキスト・(Android のみ)ソース位置です。
iOS 対応ユーザースクリプトが全フレームで console.debug / log / info / warn / error をラップし、スクリプトメッセージハンドラーへ送ります。WebKit はソース URL と行番号を報告しません。
WebViewConsoleMessageLevelメッセージを出した console メソッド(debug / log / info / warning / error)を表します。
iOS 対応ユーザースクリプトが全フレームで console.debug / log / info / warn / error をラップし、スクリプトメッセージハンドラーへ送ります。WebKit はソース URL と行番号を報告しません。
AdvancedWebViewController.onScrollChanged ページがスクロールしました。新しい位置を論理ピクセルで通知します。
AdvancedWebViewController.onWebResourceError 読み込みに失敗しました。
Android 対応サブリソースの失敗も通知します(isMainFrame は false)。
iOS 一部対応
WKNavigationDelegate.webView(_:didFail:withError:) WKNavigationDelegate.webView(_:didFailProvisionalNavigation:withError:)
メインフレームの失敗のみ通知します。キャンセルされた遷移(NSURLErrorCancelled)は通知しません。PermissionRequestページが要求しているオリジンとリソースです。
PermissionResourceカメラ、マイク、または位置情報です。
PermissionDecision権限リクエストを許可するか拒否するかです。
AdvancedWebViewController.onHttpError サーバーが 400 以上の HTTP ステータスを返しました。
Android 対応サブリソースも通知します(isMainFrame は false)。
iOS 一部対応メインページと iframe のみです。WebKit はサブリソースのステータスを公開しません。
HttpErrorHTTP エラー応答の URL、ステータスコード、フレームです。
RenderProcessGone描画プロセスの終了時に、クラッシュだったか(didCrash)を表します。
iOS 対応WebKit は伝えないため、didCrash は null です。
WebResourceErrorネイティブ WebView が報告する読み込みエラーです。
Android 対応errorCode は WebViewClient.ERROR_* の値です。
AdvancedWebViewController.onPermissionRequest ページにカメラ・マイク・位置情報の使用を許可するかを決めます。コールバックがない場合はすべて拒否します。
Android 対応
WebChromeClient.onPermissionRequest(PermissionRequest) WebChromeClient.onGeolocationPermissionsShowPrompt(String, GeolocationPermissions.Callback)
Dart が許可した後、プラグインが Android の実行時権限(CAMERA、RECORD_AUDIO、ACCESS_FINE_LOCATION)も要求し、ユーザーが拒否した場合は拒否します。保護メディアと MIDI は常に拒否します。iOS 一部対応カメラとマイクのみです。WebKit には位置情報用のデリゲートがなく、WebKit 自身がユーザーに確認するため、位置情報ではコールバックは呼ばれません。
AdvancedWebViewController.onJsDialog JavaScript の alert・confirm・prompt ダイアログに応答します。コールバックがない場合はプラットフォームの標準ダイアログを表示します。
Android 対応
WebChromeClient.onJsAlert(WebView, String, String, JsResult) WebChromeClient.onJsConfirm(WebView, String, String, JsResult) WebChromeClient.onJsPrompt(WebView, String, String, String, JsPromptResult)
コールバックがない場合は false を返し、システム WebView が標準のダイアログを表示します。iOS 対応
WKUIDelegate.webView(_:runJavaScriptAlertPanelWithMessage:initiatedByFrame:completionHandler:) WKUIDelegate.webView(_:runJavaScriptConfirmPanelWithMessage:initiatedByFrame:completionHandler:) WKUIDelegate.webView(_:runJavaScriptTextInputPanelWithPrompt:defaultText:initiatedByFrame:completionHandler:)
このデリゲートがないと WebKit はダイアログを黙って閉じるため、コールバックがない場合はプラグインが UIAlertController を表示します。JsDialogRequestJavaScript ダイアログの種類、メッセージ、ページの URL、初期値です。
JsDialogResponseJavaScript ダイアログへの応答です。許可(prompt の入力テキスト付き)または拒否を表します。
AdvancedWebViewController.onInterceptRequest interceptSchemes のスキームへのリクエストに、Dart で用意したデータで応答します。応答しない場合はそのまま通します。
Android 対応http や https を含むすべてのスキームで使えます。WebView は IO スレッドで呼び出して同期的な答えを求めるため、そのスレッドが(最大10秒)待つ間にメインスレッドが Dart に問い合わせます。null、エラー、タイムアウトの場合はネットワークから読み込みます。
iOS 一部対応
WKURLSchemeHandler.webView(_:start:) WKURLSchemeHandler.webView(_:stop:) WKWebViewConfiguration.setURLSchemeHandler(_:forURLScheme:)
カスタムスキームのみです。WebKit は http、https、file、data などの組み込みスキームをアプリが処理することを許さない(WKWebView.handlesURLScheme)ため、それらは無視されます。カスタムスキームにはフォールバック先のネットワークがないため、null やエラーのときはリクエストが失敗します。AdvancedWebViewController.interceptSchemes リクエストが onInterceptRequest に渡される URL スキームです。
iOS 一部対応WebView の生成時に登録されます。組み込みスキームは除外されます。
InterceptedRequestインターセプトしたリクエストの URL、メソッド、ヘッダ、メインフレームかどうかです。ボディは取得できません。
Android 対応
InterceptResponseアプリが用意した応答です。ボディのバイト列、MIME タイプ、ステータス、ヘッダを持ちます。
Android 対応WebResourceResponse はリダイレクト用のステータス(300〜399)に対応していません。その場合はリクエストをそのまま通します。
AdvancedWebViewController.onDownloadStart ページがダウンロードを始めたときに呼ばれます。WebView はファイルを保存しません。
Android 対応ファイル名は常に URL と Content-Disposition から推測します。
iOS 対応
WKNavigationDelegate.webView(_:decidePolicyFor:decisionHandler:) WKNavigationResponse.canShowMIMEType WKNavigationAction.shouldPerformDownload
添付ファイルと表示できない種類はレスポンスで、download リンクはアクションで検出し、遷移をキャンセルします。download リンクではファイル名が null になることがあります。DownloadRequestダウンロードの URL、ファイル名、MIME タイプ、サイズです。
AdvancedWebViewController.onSslError 証明書の問題にどう対処するかを決めます。コールバックがない場合は読み込みを拒否します。
Android 対応
iOS 対応
WKNavigationDelegate.webView(_:didReceive:completionHandler:) SecTrustEvaluateWithError(_:_:) URLCredential(trust:)
システム自身の信頼性評価が失敗した後にだけ呼ばれます。AdvancedWebViewController.onHttpAuthRequest HTTP Basic / Digest / NTLM 認証の認証情報を渡します。null を返すとキャンセルします。
Android 対応
WebViewClient.onReceivedHttpAuthRequest(WebView, HttpAuthHandler, String, String) HttpAuthHandler.proceed(String, String) HttpAuthHandler.cancel()
コールバックがない場合はリクエストをキャンセルします。iOS 対応
WKNavigationDelegate.webView(_:didReceive:completionHandler:) URLCredential(user:password:persistence:)
コールバックがない場合はシステムの既定処理になり、リクエストは失敗します。プロキシ認証はシステムに任せます。AdvancedWebViewController.onClientCertRequest サーバーからのクライアント証明書(相互 TLS)の要求に、PKCS#12 の証明書で応答するか、キャンセルするか、証明書なしで続行します。
Android 対応
WebViewClient.onReceivedClientCertRequest(WebView, ClientCertRequest) ClientCertRequest.proceed(PrivateKey, X509Certificate[]) ClientCertRequest.cancel() ClientCertRequest.ignore() KeyStore.getInstance(String)
コールバックがない場合はリクエストをキャンセルします。WebView は応答をそのホストとポートについて WebView の存続中記憶します。PKCS#12 は PKCS12 の KeyStore で読み込みます。iOS 対応
WKNavigationDelegate.webView(_:didReceive:completionHandler:) SecPKCS12ImportURLCredential(identity:certificates:persistence:)
ignore はシステムの既定処理になります。コールバックがない場合もシステムの既定処理です。レルムは URLProtectionSpace.realm です。ClientCertRequestクライアント証明書要求のホスト、ポート、(iOS のみ)レルムです。
ClientCertAction証明書で続行するか、リクエストをキャンセルするか、証明書なしで続行するかです。
Android 対応
ClientCertResponseクライアント証明書要求への応答です。PKCS#12 ファイルとそのパスワードで続行、キャンセル、または無視のいずれかです。
Android 対応
SslError証明書の問題の URL、ホスト、説明です。
SslErrorDecision証明書の問題があっても続行するか、読み込みをキャンセルするかです。
HttpAuthRequest認証要求のホストとレルムです。
HttpAuthCredentials認証要求に対するユーザー名とパスワードです。
AdvancedWebViewController.onNewWindow ページが新しいウィンドウ(window.open、target="_blank")を要求したときに呼ばれます。
Android 対応
WebChromeClient.onCreateWindow(WebView, boolean, boolean, Message) WebSettings.setSupportMultipleWindows(boolean)
URL は一時的な WebView から取得し、すぐ破棄します。コールバックがない場合はマルチウィンドウを無効のままにし、同じ WebView で読み込みます。iOS 対応常に nil を返します。コールバックがない場合は同じ WKWebView で読み込みます。
設定
WebViewSettingsWebView ごとの不変な設定です。
AdvancedWebViewController.settings 最後に適用した設定です。
Dart のみ
AdvancedWebViewController.updateSettings 動作中の WebView に新しい設定を適用します。
iOS 一部対応作成時のみの設定は無視されます。各設定の項目を参照してください。
WebViewSettings.android Android 専用の設定(AndroidWebViewSettings)です。iOS では無視されます。
iOS 非対応iOS には該当しません。
WebViewSettings.ios iOS 専用の設定(IOSWebViewSettings)です。Android では無視されます。
Android 非対応Android には該当しません。
WebViewSettings.javaScriptEnabled ページ内の JavaScript を有効にします。
WebViewSettings.mediaPlaybackRequiresUserGesture メディア再生の開始にユーザー操作を必須にします。
IOSWebViewSettings.allowsInlineMediaPlayback 動画を全画面ではなくインラインで再生します。
Android 非対応Android は常にインライン再生です。
AndroidWebViewSettings.supportZoom ピンチズームを許可します。
iOS 非対応ズームはページの viewport meta タグで決まります。
AndroidWebViewSettings.builtInZoomControls 組み込みズーム機構のジェスチャー(ピンチ・ダブルタップ)を有効にします。Android では supportZoom と併せて必要です。
iOS 非対応ズームはページの viewport meta タグで決まります。
AndroidWebViewSettings.displayZoomControls 画面上の + / - ズームボタンを表示します(既定は非表示)。
iOS 非対応iOS に画面上のズームボタンはありません。
WebViewSettings.transparentBackground WebView の背景を透明にします。
AndroidWebViewSettings.passkeysEnabled Web コンテンツで WebAuthn / パスキーを有効にします(Android)。
Android 対応
WebViewFeature.isFeatureSupported(WEB_AUTHENTICATION) WebSettingsCompat.setWebAuthenticationSupport(WEB_AUTHENTICATION_SUPPORT_FOR_APP) WebSettingsCompat.setWebAuthenticationSupport(WEB_AUTHENTICATION_SUPPORT_NONE)
サイトのドメインに Digital Asset Links の設定が必要です。更新時は有効なら FOR_APP、無効なら NONE を設定します。インストール済みの WebView が WebAuthn に対応していない場合は無視されます。iOS 非対応アプリがサイトのドメインの Associated Domains(webcredentials)entitlement を持っていれば、WKWebView でパスキーが使えます。
WebViewSettings.inspectable Safari Web Inspector または chrome://inspect でページを調査できるようにします。
Android 対応プロセス全体に効きます。アプリ内のすべての WebView が対象で、最後に設定した値が有効になります。
WebViewSettings.textZoom 文字サイズをパーセントで指定します(100 が標準)。
WebViewCacheModeWebViewSettings.cacheMode に指定できる値です。
Android 対応
AndroidWebViewSettings.domStorageEnabled ページが localStorage / sessionStorage を使えるようにします(Android)。
iOS 非対応WKWebView は常に DOM ストレージを許可します。
AndroidWebViewSettings.allowFileAccess WebView が file:// URL にアクセスできるようにします(Android、既定は無効)。
iOS 非対応iOS に同等の切り替えはありません。
AndroidWebViewSettings.allowContentAccess WebView が content:// URL を読み込めるようにします(Android、既定は無効)。
iOS 非対応iOS に同等の設定はありません。
AndroidWebViewSettings.mixedContentMode HTTPS ページ上の HTTP コンテンツの扱いを決めます(Android、既定は遮断)。
iOS 非対応WebKit は混在コンテンツを遮断し、設定はありません。
WebViewMixedContentModeWebViewSettings.mixedContentMode に指定できる値です。
Android 対応
iOS 非対応iOS には該当しません。
WebViewContentModeIOSWebViewSettings.contentMode に指定できる値です。
Android 非対応Android には該当しません。
AndroidWebViewSettings.geolocationEnabled ページが navigator.geolocation を使えるようにします(Android、既定は有効)。
iOS 非対応iOS には切り替えがなく、位置情報へのアクセスはシステムの権限で決まります。
AndroidWebViewSettings.safeBrowsingEnabled ページを Google の危険なサイトの一覧と照合します(Android、既定は有効)。
iOS 非対応iOS には切り替えがなく、WebKit の不正なウェブサイトの警告は常に有効です。
AndroidWebViewSettings.algorithmicDarkeningAllowed アプリのテーマがダークの間、ダークテーマに対応していないページを暗くできるようにします(Android、既定は無効)。
Android 対応ALGORITHMIC_DARKENING に対応した WebView が必要です。非対応の場合は何も起こりません。
iOS 非対応iOS には該当する設定がありません。prefers-color-scheme を変えるには IOSWebViewSettings.userInterfaceStyle を使います。
IOSWebViewSettings.userInterfaceStyle ライト/ダークの外観を固定し、ページの prefers-color-scheme を決めます(iOS)。
Android 非対応Android には該当する設定がありません。AndroidWebViewSettings.algorithmicDarkeningAllowed を参照してください。
WebViewUserInterfaceStyleIOSWebViewSettings.userInterfaceStyle に指定できる値です。
Android 非対応Android には該当しません。
IOSWebViewSettings.incognito Cookie・キャッシュ・ストレージをメモリ上だけに保持します(iOS)。
Android 非対応Android の WebView は Cookie・キャッシュ・ストレージをアプリ全体で共有するため、WebView ごとに分離できません。
iOS 作成時のみWebView の生成時に適用されます。後から変更しても反映されません。
IOSWebViewSettings.applicationNameForUserAgent 既定の User-Agent を置き換えずに、末尾へ文字列を追加します(iOS)。
Android 非対応Android には該当する設定がありません。全体を置き換えるには WebViewSettings.userAgent を使います。
iOS 作成時のみWebView の生成時に適用されます。後から変更しても反映されません。WebViewSettings.userAgent を設定している間は無視されます。
IOSWebViewSettings.contentMode サイトのモバイル版・デスクトップ版のどちらを要求するかを選びます(recommended / mobile / desktop、iOS)。
Android 非対応Android には該当する設定がありません。デスクトップ版を要求するには WebViewSettings.userAgent を使います。
IOSWebViewSettings.allowsLinkPreview リンクを長押ししたときのプレビューを表示するかどうかを切り替えます(iOS)。
Android 非対応Android には該当する設定がありません。
WebViewSettings.cacheMode 読み込み時の HTTP キャッシュの使い方(normal / preferCache / cacheOnly / noCache)。
Android 対応
WebViewSettings.javaScriptCanOpenWindowsAutomatically ユーザー操作なしでスクリプトから window.open を呼べるようにします。
WebViewSettings.scrollbarsVisible スクロールバー(Android)/スクロールインジケータ(iOS)を表示します。
WebViewSettings.overScrollEnabled コンテンツの端を越えたスクロールを許可します(Android はストレッチ、iOS はバウンス)。
WebViewSettings.pullToRefreshEnabled ページ上端から引き下げたときにページを再読み込みします。
Android 対応プラットフォームビューは WebView を含む SwipeRefreshLayout です。
WebViewSettings.minimumFontSize WebView が表示する最小のフォントサイズ。null ならプラットフォームの既定値です。
WebViewSettings.userAgent User-Agent を上書きします。null ならプラットフォームの既定値を使います。
Cookie
AdvancedWebViewController.clearWebsiteData HTTP キャッシュ、localStorage / sessionStorage、IndexedDB を削除します。Cookie は含みません。
Android 一部対応localStorage と IndexedDB は個別に削除できず、どちらを選んでもアプリの DOM ストレージをすべて削除します。
WebsiteDataType削除するデータの種類(キャッシュ、localStorage、IndexedDB)です。
Android 一部対応localStorage と indexedDb はどちらも WebStorage.deleteAllData() に対応し、DOM ストレージをすべて削除します。
ユーザースクリプト
UserScriptWebView が読み込むすべてのページに注入される JavaScript です。
Android 対応document-start スクリプトは全フレームで動くため、メインフレームのみ・document-end 指定はプラグインがソースをラップして実現します。
UserScriptInjectionTimeページ読み込み中にユーザースクリプトが実行されるタイミングです。
Android 対応atDocumentEnd は DOMContentLoaded を待ちます。
AdvancedWebViewController.addUserScript 以降に読み込むページ向けにユーザースクリプトを登録します。
Android 対応DOCUMENT_START_SCRIPT 対応の WebView が必要です。
AdvancedWebViewController.removeAllUserScripts 登録済みのユーザースクリプトをすべて削除します。
AdvancedWebViewController.userScripts コンストラクタ引数: 最初の読み込み前に登録されるスクリプトです。
アプリ内ブラウザ
AdvancedInAppBrowserFlutter UI の上に表示する、ツールバー付きの全画面ブラウザです。AdvancedWebViewController と同じ方法で作成した WebView を表示するため、読み込み・JavaScript・ページイベントは同じネイティブ API を使います。
Android 対応プラグインの manifest に登録した専用の InAppBrowserActivity を使います。戻るボタンはまずページ履歴を戻ります。ホストの Activity が必要です。
iOS 対応
UIViewController.present(_:animated:completion:) UIViewController.dismiss(animated:completion:) UINavigationController
フォアグラウンドのシーンの最前面の view controller からフルスクリーンのモーダルで表示します。InAppBrowserOptionsツールバーの色・タイトル・URL 表示・ナビゲーションボタン・閉じるボタンのラベルと、ブラウザ内 WebView の設定です。
iOS 対応色は UINavigationBarAppearance で設定し、ボタンは下部のツールバーに置きます。
AdvancedSystemBrowserシステム標準のブラウザ UI(Chrome Custom Tabs、SFSafariViewController)でページを開きます。ユーザーの Cookie やパスキーが使えるため、埋め込み WebView で行うべきでないサインインなどに向いています。
Android 一部対応Custom Tabs に対応したブラウザがない場合は通常のブラウザで開きます。Custom Tabs は閉じたことを通知しないため、onClosed はアプリがフォアグラウンドに戻ったときに呼ばれます(ベストエフォート)。
iOS 対応フォアグラウンドのシーンの最前面の view controller からモーダルで表示します。常に利用できます。
SystemBrowserOptionsシステムブラウザのツールバーの色です。