Flutter中WebView嵌入Container时如何实现自适应内容尺寸
Flutter WebView 跟随HTML内容自动调整尺寸实现方案
实现原理
WebView是独立的原生渲染组件,和Flutter的布局引擎相互隔离,无法直接通过不设置固定宽高的方式让组件自动撑满HTML内容尺寸。必须通过双向通信实现尺寸同步:
- 宽度适配:移除原代码中写死的屏幕占比宽度,让WebView宽度自动跟随外层Card、Container的布局约束自适应
- 高度同步:向WebView注入自定义JS逻辑,在HTML完全渲染后读取DOM的实际总高度,通过JS通信通道把高度值传回Flutter侧,动态更新外层Container的高度约束
完整代码改造步骤
1. 引入依赖
在pubspec.yaml中添加官方维护的WebView组件依赖:
dependencies: webview_flutter: ^4.7.0
2. 定义动态高度状态
由于需要动态更新容器高度,需将WebView高度值定义为StatefulWidget的状态变量,设置兜底初始值避免加载阶段出现空白:
// 存储WebView实际HTML内容的高度 double _webViewHeight = 120;
3. 替换原有固定尺寸的Container实现
删除原代码中写死的屏幕占比宽高约束,重构WebView的配置逻辑,匹配「Card卡片→Container容器→WebView」的层级结构:
// 该Container直接嵌套在Card组件内部 Container( // 不设置固定宽度,自动适配父级布局约束 height: _webViewHeight, // 高度绑定动态计算的实际内容值 clipBehavior: Clip.hardEdge, // 裁切溢出内容,避免卡片上出现渲染溢出 child: WebViewWidget( controller: WebViewController() ..setJavaScriptMode(JavaScriptMode.unrestricted) // 注册JS与Flutter通信的通道 ..addJavaScriptChannel( 'ContentHeightChannel', onMessageReceived: (message) { // 解析JS传回的高度值,更新状态触发UI重建 double? contentHeight = double.tryParse(message.message); if (contentHeight != null && contentHeight > 0) { setState(() { // 额外加16px边距,避免底部内容被裁切 _webViewHeight = contentHeight + 16; }); } }, ) // 加载自定义HTML内容 ..loadRequest( Uri.dataFromString( htmlContent, // 你需要加载的HTML字符串 mimeType: "text/html", encoding: Encoding.getByName('utf-8'), ), ) // 页面加载完成后注入高度监听逻辑 ..setOnLoadStop((controller) { controller.runJavaScript(''' function reportHeight() { // 读取DOM实际渲染总高度 let totalHeight = document.body.scrollHeight; // 隐藏横向滚动条,宽度和父容器对齐 document.body.style.overflowX = 'hidden'; // 通过通道把高度值传回Flutter ContentHeightChannel.postMessage(totalHeight.toString()); } // 初次加载完成立刻上报一次高度 reportHeight(); // 监听DOM元素动态变化(图片加载完成、折叠面板展开、文本换行等),实时同步高度 new ResizeObserver(reportHeight).observe(document.body); '''); }), ), )
常见踩坑处理
- 图片异步加载导致高度不准:注入的
ResizeObserver会持续监听DOM的尺寸变化,不管是图片加载完成、动态元素渲染,都会实时触发高度上报,不会出现初始计算高度和实际内容不匹配、留大片空白的问题 - 内容底部被裁切:接收JS传回的高度值时预留的16px安全边距,可根据实际UI的内边距需求调整,避免WebView底部紧贴卡片边缘
- 不同样式HTML尺寸适配:因为高度完全由DOM实际渲染值决定,不管HTML是短文本、长文章还是带图片的富文本内容,都能自动调整到刚好匹配的高度,不需要为每段HTML单独写死容器尺寸
内容的提问来源于stack exchange,提问作者Claudio Silva
相关产品推荐
相关产品推荐

