跳转到内容
WebView AllWebView All
这是 1.2.x 版本的文档,最新接口请切换至 latest。

iOS 和 macOS

iOS 和 macOS 由 webview_flutter_wkwebview ^3.25.0 提供。

项值
平台包webview_flutter_wkwebview
ControllerWebKitWebViewController
WidgetWebKitWebViewWidget
DelegateWebKitNavigationDelegate
Cookie managerWebKitWebViewCookieManager
引擎WKWebView
最低 iOS13.0+
最低 macOS10.15+
final params = WebKitWebViewControllerCreationParams(
allowsInlineMediaPlayback: true,
mediaTypesRequiringUserAction: const <PlaybackMediaTypes>{},
limitsNavigationsToAppBoundDomains: false,
javaScriptCanOpenWindowsAutomatically: true,
);
参数作用
mediaTypesRequiringUserAction哪些媒体类型需要用户手势。
allowsInlineMediaPlayback允许 HTML5 视频内联播放。
limitsNavigationsToAppBoundDomains启用 App-Bound Domains。
javaScriptCanOpenWindowsAutomatically控制 JS 自动打开窗口。
API作用
setAllowsBackForwardNavigationGestures启用滑动前进/后退。
setAllowsLinkPreview控制 link preview。
setOnCanGoBackChange监听 canGoBack 变化。
setInspectable启用 WebKit inspect。
loadFileWithParams(WebKitLoadFileParams)加载本地文件并设置可读范围。
await (controller.platform as WebKitWebViewController).loadFileWithParams(
WebKitLoadFileParams(
absoluteFilePath: '/Users/me/site/index.html',
readAccessPath: '/Users/me/site',
),
);

readAccessPath 必须覆盖 HTML 引用的本地资源。

macOS 与 iOS 共用 Dart 包,但部分 UIKit 风格属性在 macOS 没有 bridge:

区域限制
scroll view部分 scroll view 方法未实现。
background/opaquemacOS 上 setBackgroundColor 会由主 wrapper 忽略,并在终端打印日志。
link preview取决于系统支持。

其他 Apple 平台专用调用仍应做好平台判断和 UnimplementedError 处理。