You need to enable JavaScript to run this app. Flutter webview_flutter支付完成后无法自动收起键盘求解
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.12 20:06:04