使用QtVirtualKeyboard时QtWebEngine View(qml)的CJK语言自动补全异常

问题根因 #

这是Qt 5.12版本的已知原生缺陷，核心问题是QtWebEngine和QtVirtualKeyboard的输入方法事件同步逻辑不完整：

• 普通QtTextBox控件的输入方法事件是直接在Qt Quick框架内传递，预编辑文本、候选词状态可以正常同步，所以自动补全功能正常
• QtWebEngineView内部的输入事件需要转发到Chromium内核侧的网页DOM节点，Qt 5.12版本未实现虚拟键盘预编辑状态到WebEngine内核的同步链路，CJK输入时的候选词、自动补全上下文无法传递到网页输入框，因此出现异常
  该问题在基于Qt 5.12开发带虚拟键盘的嵌入式浏览器场景中非常普遍，大量开发者都反馈过同类问题。

可行修复方案 #

方案1：升级Qt版本（优先推荐） #

Qt官方在Qt 5.15.2及更高的LTS版本，以及Qt 6.2+版本中已经完整修复了该链路缺陷，无需修改业务代码，升级Qt版本后重新编译项目即可解决问题。

方案2：Qt 5.12版本下手动修复事件同步逻辑 #

如果受项目约束无法升级Qt版本，可以手动补全输入方法事件的传递链路：

• 自定义C++类继承QQuickWebEngineView，重写inputMethodEvent处理函数，手动将QInputMethodEvent携带的预编辑文本、候选词列表同步到WebEngine当前的焦点输入节点
• 在QML层为WebEngineView绑定inputMethodQuery响应逻辑，主动向虚拟键盘返回当前输入框的文本内容、光标位置等上下文信息，确保虚拟键盘可以正常生成补全候选词
• 关键代码示例：

void CustomWebEngineView::inputMethodEvent(QInputMethodEvent *event) {
    // 先调用父类默认逻辑
    QQuickWebEngineView::inputMethodEvent(event);
    // 手动同步预编辑文本到内核
    if (!event->preeditString().isEmpty()) {
        this->page()->runJavaScript(QString(
            "if(document.activeElement && document.activeElement.tagName.match(/INPUT|TEXTAREA/)) {"
            "  document.activeElement.value = '%1';"
            "}"
        ).arg(event->preeditString()));
    }
}

方案3：简易临时适配 #

如果不需要实时显示预编辑效果，可以监听虚拟键盘的输入完成信号，通过runJavaScript执行DOM操作，直接把最终输入的CJK文本插入到当前激活的网页输入框中，该方案改动最小，可快速验证效果。

内容的提问来源于stack exchange，提问作者Christopher Fair