WebEngineView输入焦点检测及跨iframe WebChannel适配问题

我在QML WebEngineView应用中嵌入了自定义QML虚拟键盘，放弃插件式虚拟键盘（如QVirtualKeyboard或依赖Qt私有头的替代方案）是因为这类方案在多设备上问题频发。目前通过QGuiApplication::focusObject()调用postEvent的方式工作正常，但核心问题是如何准确触发虚拟键盘的显示时机。

当前实现方案 #

目前用WebChannel结合全局焦点事件监听实现：

QML代码部分 #

QtObject {
    id: qmlKeyboard
    WebChannel.id: "qmlKeyboard"

    function show(type) {
           keyboard.visible = true
    }
}
WebEngineScript {
    id: keyboardScript
    name: "qt_vkscript"
    injectionPoint: WebEngineScript.DocumentReady
    sourceUrl: "qrc:///vkscript.js"
    worldId: WebEngineScript.MainWorld
    runOnSubframes: true // 未生效
}

WebEngineScript {
    id: webChannelScript
    name: "QWebChannel"
    sourceUrl: "qrc:///qtwebchannel/qwebchannel.js"
    injectionPoint: WebEngineScript.DocumentCreation
    worldId: WebEngineScript.MainWorld
    runOnSubframes: true
}

注入的JS代码（vkscript.js） #

new QWebChannel(qt.webChannelTransport, function(channel) {
    window.qmlKeyboard = channel.objects.qmlKeyboard;
    document.addEventListener('focus', function(e) {
        // 无关逻辑已省略
        qmlKeyboard.show();
    }, true);
    document.addEventListener('blur', function(){qmlKeyboard.hide();}, true);
});

现有问题 #

该方案在主页面正常，但iframe中完全失效：开启runOnSubframes: true后，JS报错qt is not defined，因为子帧中qt.webChannelTransport不存在——即便已经注入了qwebchannel.js。尝试切换不同worldId也无法解决，已禁用Qt Quick编译器，怀疑是Qt自身问题。

已尝试的无效方法 #

• 用focusChanged：仅能检测整个WebView组件的焦点变化，无法感知页面内输入框的焦点切换；
• 安装事件过滤器监听QInputMethodQueryEvent：未获取到可用的触发信号；
• 研究QInputMethod：未找到能直接检测输入请求的接口；
• 查阅相关资料：最终指向私有APIQPlatformInputContext，但依赖私有头会导致版本兼容问题，不可行。

方案一：修复WebChannel在iframe中的工作问题 #

子帧无法访问qt.webChannelTransport是因为该对象仅存在于主帧的全局上下文。可以通过以下方式让子帧共享主帧的WebChannel连接：

1. 修改注入的JS代码，让主帧把WebChannel实例暴露给所有子帧：

// 主帧中执行的代码
new QWebChannel(qt.webChannelTransport, function(channel) {
    window.qmlKeyboard = channel.objects.qmlKeyboard;
    
    // 监听iframe加载，将主帧的qmlKeyboard对象传递给子帧
    window.addEventListener('load', function() {
        const iframes = document.querySelectorAll('iframe');
        iframes.forEach(iframe => {
            try {
                iframe.contentWindow.qmlKeyboard = window.qmlKeyboard;
                // 为子帧绑定焦点事件
                iframe.contentDocument.addEventListener('focus', function(e) {
                    qmlKeyboard.show();
                }, true);
                iframe.contentDocument.addEventListener('blur', function() {
                    qmlKeyboard.hide();
                }, true);
            } catch(e) {
                // 跨域iframe会有安全限制，此处忽略
            }
        });
    });

    // 主帧自身的焦点监听
    document.addEventListener('focus', function(e) {
        qmlKeyboard.show();
    }, true);
    document.addEventListener('blur', function(){qmlKeyboard.hide();}, true);
});

2. 调整WebEngineScript的注入时机：
   将keyboardScript的injectionPoint改为WebEngineScript.Deferred，确保在页面完全加载后再执行iframe绑定逻辑；同时去掉子帧的WebChannel注入，避免重复加载导致冲突：

WebEngineScript {
    id: keyboardScript
    name: "qt_vkscript"
    injectionPoint: WebEngineScript.Deferred
    sourceUrl: "qrc:///vkscript.js"
    worldId: WebEngineScript.MainWorld
    runOnSubframes: false // 仅在主帧执行，手动处理子帧
}

WebEngineScript {
    id: webChannelScript
    name: "QWebChannel"
    sourceUrl: "qrc:///qtwebchannel/qwebchannel.js"
    injectionPoint: WebEngineScript.DocumentCreation
    worldId: WebEngineScript.MainWorld
    runOnSubframes: false // 仅在主帧加载
}

注意：该方案仅适用于同域iframe，跨域iframe受浏览器同源策略限制无法访问主帧上下文，这种情况需要用方案二。

方案二：无需WebChannel，通过Qt原生API检测输入请求 #

利用QInputMethod的信号和WebEngineView的输入事件拦截，无需依赖WebChannel：

1. 在C++层为QWebEnginePage安装事件过滤器，监听输入相关事件：

#include <QWebEnginePage>
#include <QEvent>
#include <QInputMethod>

class WebPageInputFilter : public QObject
{
    Q_OBJECT
protected:
    bool eventFilter(QObject *obj, QEvent *event) override {
        if (event->type() == QEvent::InputMethodQuery) {
            QInputMethodQueryEvent *imeEvent = static_cast<QInputMethodQueryEvent*>(event);
            // 当输入框需要输入法时，触发键盘显示
            if (imeEvent->queries().contains(Qt::ImEnabled)) {
                emit requestShowKeyboard();
            }
        } else if (event->type() == QEvent::FocusOut) {
            emit requestHideKeyboard();
        }
        return QObject::eventFilter(obj, event);
    }
signals:
    void requestShowKeyboard();
    void requestHideKeyboard();
};

2. 在QML中注册该类并绑定到WebEngineView：

WebEngineView {
    id: webView
    Component.onCompleted: {
        const inputFilter = new WebPageInputFilter();
        webView.page.installEventFilter(inputFilter);
        inputFilter.requestShowKeyboard.connect(() => { keyboard.visible = true; });
        inputFilter.requestHideKeyboard.connect(() => { keyboard.visible = false; });
    }
}

优势：无需依赖WebChannel，不受iframe跨域限制，完全通过Qt原生事件检测输入请求，避免私有API依赖。

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