Flutter webview_flutter支付完成后无法自动收起键盘求解
问题根因
之前所有操作收不起键盘,核心是搞错了焦点的管辖范围:
FocusScope.of(context).unfocus()仅能对Flutter自身渲染的TextField、表单字段这类组件生效,属于Flutter焦点树层面的操作- 你碰到的输入框是WebView加载的网页元素,焦点完全归原生WebView平台层和网页JS上下文管辖,Flutter的焦点树根本触达不到这部分状态,无论在哪里调用unfocus都不会产生效果
- 原代码在build方法内写焦点操作的逻辑本身也有问题:build方法是纯Widget构建逻辑,会被高频触发,不适合放置修改状态、操作焦点这类带副作用的代码,时机本身就不对
可落地的解决步骤
1. 持有WebViewController实例,通过JS注入直接操控网页端焦点
这是跨安卓、iOS通用的无侵入方案,不需要单独写原生桥接代码:
- 在State类中定义控制器成员变量,替换原无控制器的WebView初始化逻辑:
// 类成员定义 late WebViewController webViewController; bool orderCompleted = false; - 在WebView的
onWebViewCreated回调中完成控制器实例赋值:WebView( initialUrl: widget.url, debuggingEnabled: true, javascriptMode: JavascriptMode.unrestricted, javascriptChannels: jsChannels, // 新增控制器赋值 onWebViewCreated: (controller) { webViewController = controller; }, onWebResourceError: (error) { print("==> Web Resource Error <=="); print(error); }, ) - 移除build方法里的无效失焦代码,修改
MobileOrderReceived消息回调逻辑:
收到订单完成通知后,先触发状态更新,等当前帧渲染完成后,注入JS代码让网页内的输入元素主动失焦,触发系统收起键盘:JavascriptChannel( name: "MobileOrderReceived", onMessageReceived: (JavascriptMessage receiver) async { print("Order Completed => ${receiver.message}"); // 原有保存订单历史的逻辑完全保留 setState(() { orderCompleted = true; }); // 等帧渲染完成再执行JS注入,避免上下文未就绪导致失效 WidgetsBinding.instance.addPostFrameCallback((_) { webViewController.runJavaScript(''' // 遍历所有输入类元素主动失焦 document.querySelectorAll('input, textarea, select, [contenteditable="true"]').forEach(el => el.blur()); // 兜底让当前激活元素失焦 if (document.activeElement) document.activeElement.blur(); // 兼容iOS端逻辑,主动触发窗口失焦收起键盘 window.blur(); '''); }); } )
2. 安卓端兜底优化
如果JS注入后仍偶发键盘不收起,一般是安卓原生WebView的焦点残留问题:
可以在JS失焦操作后,通过webview_flutter的平台通道能力,调用安卓原生的InputMethodManager.hideSoftInputFromWindow()接口,传入WebView的窗口Token主动收键盘,不需要复杂的原生桥接逻辑。
注意事项
- 不要在消息回调收到通知后立刻执行JS注入操作,此时WebView可能还在加载收据页面、JS上下文未完全就绪,必须通过
addPostFrameCallback等帧渲染完成后再执行,避免操作失效 - 不要收到支付完成消息后立刻跳转离开WebView页面,要留足键盘收起的动画时间,避免出现生硬的体验跳转
内容的提问来源于stack exchange,提问作者daddygames
相关产品推荐
相关产品推荐

