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

文件、Asset 和 HTML

await controller.loadFile('/Users/me/Documents/page.html');
平台行为
Android通过 file URL 加载,AndroidLoadFileParams 可附加 headers。
iOS/macOSWebKit 本地文件加载,WebKitLoadFileParams 控制可读范围。
Windows把文件目录映射为内部 HTTPS virtual host。
Linux通过 WebKitGTK 加载绝对路径。
OHOS启用 file access 后加载 file URL。
Web不支持。浏览器不允许 hosted app 读取任意本地文件。
await (controller.platform as AndroidWebViewController).loadFileWithParams(
AndroidLoadFileParams(
absoluteFilePath: '/sdcard/Download/page.html',
headers: const <String, String>{'X-Source': 'app'},
),
);
await (controller.platform as WebKitWebViewController).loadFileWithParams(
WebKitLoadFileParams(
absoluteFilePath: '/Users/me/site/index.html',
readAccessPath: '/Users/me/site',
),
);

readAccessPath 必须覆盖 HTML 引用的图片、脚本和样式。

flutter:
assets:
- assets/help/index.html
await controller.loadFlutterAsset('assets/help/index.html');

Windows 会把 asset 目录映射到内部 HTTPS host;Web 会解析为生成后的 assets/ 路径。

await controller.loadHtmlString(
'<html><body><a href="details.html">Details</a></body></html>',
baseUrl: 'https://docs.example.com/help/',
);

有相对链接时应提供 baseUrl。

await controller.loadRequest(
Uri.parse('https://api.example.com/form'),
method: LoadRequestMethod.post,
headers: const <String, String>{'Content-Type': 'application/json'},
body: Uint8List.fromList(utf8.encode('{"ok":true}')),
);
平台说明
AndroidPOST + 自定义 headers 不支持。
OHOSPOST + 自定义 headers 不支持,会抛 UnsupportedError。
Web非简单请求通过 fetch,需要服务端 CORS 允许。
Windows/Linux/iOS/macOS支持 method、headers 和 body。

不支持的平台可用 app HTTP client 手动请求,再用 loadHtmlString 加载响应 HTML;但这不等价于浏览器原生导航,cookie、redirect、service worker 等语义会不同。