Skip to content

設定 ​

WebViewSettings は不変オブジェクトです。コンストラクタで渡すか、後から updateSettings で置き換えます。

dart
final controller = AdvancedWebViewController(
  settings: const WebViewSettings(userAgent: 'MyApp/1.0'),
);

await controller.updateSettings(const WebViewSettings(javaScriptEnabled: false));

片方の OS にしかないオプションは AndroidWebViewSettings と IOSWebViewSettings にあり、android: と ios: で渡します。もう一方の OS では無視されるので、同じ WebViewSettings を両方で使えます。

dart
const WebViewSettings(
  android: AndroidWebViewSettings(passkeysEnabled: true),
  ios: IOSWebViewSettings(allowsInlineMediaPlayback: true),
);
設定既定値AndroidiOS
javaScriptEnabledtrue対応対応
mediaPlaybackRequiresUserGesturetrue対応生成時のみ
transparentBackgroundfalse対応対応
inspectablefalse対応(プロセス全体)対応
textZoom100文字のみページ全体
cacheModenormal対応loadUrl のみ
javaScriptCanOpenWindowsAutomaticallytrue対応対応
scrollbarsVisibletrue対応対応
overScrollEnabledtrue対応対応
pullToRefreshEnabledfalse対応対応(overScrollEnabled が必要)
minimumFontSizenull(プラットフォーム既定)対応対応
userAgentnull(プラットフォーム既定)対応対応

Android 専用の設定 ​

WebViewSettings.android に渡します。iOS ではすべて無視されます。

設定既定値AndroidiOS
supportZoomtrue対応無視
builtInZoomControlstrue対応(ピンチ・ダブルタップ。supportZoom が必要)無視
displayZoomControlsfalse対応(画面上の + / - ボタン)無視
passkeysEnabledfalse対応無視(下記参照)
domStorageEnabledtrue対応無視(常に有効)
allowFileAccessfalse対応無視
allowContentAccessfalse対応無視
mixedContentModeneverAllow対応無視(WebKit が遮断)
geolocationEnabledtrue対応無視(OS が判断)
thirdPartyCookiesEnabledfalse対応無視(WebKit が判断)
safeBrowsingEnabledtrue対応(Android 8.0 以降)無視(常に有効)
algorithmicDarkeningAllowedfalse対応(アプリのテーマがダークであることが必要)無視(userInterfaceStyle を参照)

iOS 専用の設定 ​

WebViewSettings.ios に渡します。Android ではすべて無視されます。

設定既定値AndroidiOS
allowsInlineMediaPlaybackfalse無視生成時のみ
allowsBackForwardNavigationGesturesfalse無視対応
incognitofalse無視生成時のみ
applicationNameForUserAgentnull無視生成時のみ
contentModerecommended無視対応
allowsLinkPreviewtrue無視対応
userInterfaceStyleunspecified無視対応(light / dark で prefers-color-scheme を固定)

「生成時のみ」の設定はネイティブビューの生成時に適用され、そのプラットフォームでは updateSettings で変更しても無視されます。

ダークモード ​

ページは prefers-color-scheme に従います。iOS では IOSWebViewSettings.userInterfaceStyle(light / dark)でその WebView の外観を固定でき、ダークテーマに対応したページはシステム設定にかかわらず切り替わります。既定の unspecified は アプリに従います。Android では AndroidWebViewSettings.algorithmicDarkeningAllowed を有効にすると、ダークテーマのない ページを WebView が暗くします。暗くなるのはアプリのテーマがダークのとき(例: DayNight テーマでシステムがダークモード)に 限られ、ページ自身が color-scheme: dark を指定している場合は変更せず、この機能に対応しない WebView では何も起こりません。 どちらも既定では無効のため、既存アプリの見た目は変わりません。

Android のセキュリティ設定 ​

AndroidWebViewSettings の allowFileAccess・allowContentAccess・mixedContentMode の既定値は制限的な側です。ページはローカルファイルや content:// プロバイダーを読めず、HTTPS ページ上の HTTP コンテンツは遮断されます。緩めるのは自分が管理する コンテンツに限ってください。mixedContentMode: alwaysAllow はネットワーク上の攻撃者に安全なページを改ざんされる 恐れがあります。iOS には同等の設定がありません(WebKit が混在コンテンツを遮断し、ファイルアクセスの切り替えもありません)。 domStorageEnabled は従来どおり既定で有効です。

パスキー(WebAuthn) ​

パスキーは、ドメインがアプリと関連付けられたサイトでのみ使えます。

  • Android: passkeysEnabled: true を指定し、/.well-known/assetlinks.json に delegate_permission/common.get_login_creds、パッケージ名、署名証明書の SHA-256 を記載します。 androidx.webkit 1.12 以上と WebAuthn 対応の WebView が必要で、非対応なら設定は無視されます。
  • iOS(16 以上): 設定は不要です。Associated Domains capability に webcredentials:example.com を追加し、/.well-known/apple-app-site-association にアプリ ID を記載します。
  • 外部 IdP(Google など)のパスキーと mediation: "conditional" は WebView 内では使えません。

各設定が使うネイティブ API はネイティブ API 対応表を参照してください。

Android の WebAuthn 対応 WebView では、updateSettings でパスキーを有効・無効に切り替えられます。

MIT License で公開しています。