Linux下CEF SendKeyEvent发送Ctrl+A出现空DOM键值问题

在Linux环境下使用无窗口/OSR模式的CEF框架，搭配SDL2输入桥接器，尝试通过CefBrowserHost::SendKeyEvent向聚焦的编辑器发送原生Ctrl+A快捷键（不采用JavaScript选中方案）。

当前实现按以下顺序发送事件：

• Ctrl按下
• A按下
• A抬起
• Ctrl抬起

对应的代码实现：

void App::SendCtrlA() {
    if (!client_ || !client_->GetBrowser() || !client_->GetBrowser()->GetHost())
        return;

    CefRefPtr<CefBrowserHost> host = client_->GetBrowser()->GetHost();
    CefKeyEvent ev;
    memset(&ev, 0, sizeof(ev));

    ev.type = KEYEVENT_RAWKEYDOWN;
    ev.windows_key_code = 17;
    ev.native_key_code = 17;
    ev.modifiers = EVENTFLAG_CONTROL_DOWN;
    ev.focus_on_editable_field = true;
    host->SendKeyEvent(ev);

    memset(&ev, 0, sizeof(ev));
    ev.type = KEYEVENT_RAWKEYDOWN;
    ev.windows_key_code = 65;
    ev.native_key_code = 65;
    ev.modifiers = EVENTFLAG_CONTROL_DOWN;
    ev.character = 1;
    ev.unmodified_character = 'a';
    ev.focus_on_editable_field = true;
    host->SendKeyEvent(ev);

    memset(&ev, 0, sizeof(ev));
    ev.type = KEYEVENT_KEYUP;
    ev.windows_key_code = 65;
    ev.native_key_code = 65;
    ev.modifiers = EVENTFLAG_CONTROL_DOWN;
    ev.focus_on_editable_field = true;
    host->SendKeyEvent(ev);

    memset(&ev, 0, sizeof(ev));
    ev.type = KEYEVENT_KEYUP;
    ev.windows_key_code = 17;
    ev.native_key_code = 17;
    ev.focus_on_editable_field = true;
    host->SendKeyEvent(ev);
}

页面添加的JS日志代码：

document.addEventListener('keydown', function(e){
  console.log(
    '[GSNDBG] kd'
    + ' key=' + JSON.stringify(e.key)
    + ' code=' + JSON.stringify(e.code)
    + ' ctrl=' + e.ctrlKey
    + ' shift=' + e.shiftKey
    + ' alt=' + e.altKey
    + ' meta=' + e.metaKey
    + ' keyCode=' + e.keyCode
    + ' which=' + e.which
    + ' target=' + (e.target && e.target.tagName)
  );
}, true);

观察到的日志结果：

[GSNDBG] kd key="\u0000" code="" ctrl=false shift=false alt=false meta=false keyCode=0 which=0 target=DIV

现存问题：

• 事件已传递至页面
• DOM KeyboardEvent内容为空
• ctrlKey为false
• Ctrl+A未触发全选操作

疑问：

1. 在Linux环境下，如何正确填充CefKeyEvent以实现Ctrl+A这类快捷键？
2. native_key_code和event.type应如何设置？
3. 是否有标准或推荐方案将SDL2按键数据转换为有效的CEF/Chromium快捷键事件？

1. Linux下正确填充CefKeyEvent实现Ctrl+A的方法 #

Linux下CEF的CefKeyEvent不能直接使用Windows虚拟键码，需基于X11键码和Chromium的事件逻辑调整：

• Ctrl键需使用X11键码：左Ctrl为0xffe3，右Ctrl为0xffe4，而非Windows的17。
• 完整事件序列需包含KEYEVENT_CHAR事件，Chromium依赖该事件识别控制字符类快捷键。
• 全程保持modifiers字段的正确性，A按键事件需携带EVENTFLAG_CONTROL_DOWN标识。

修正后的Ctrl+A事件序列：

1. Ctrl按下（KEYEVENT_RAWKEYDOWN）
2. A按下（KEYEVENT_RAWKEYDOWN）
3. Ctrl+A字符事件（KEYEVENT_CHAR，对应ASCII 1）
4. A抬起（KEYEVENT_KEYUP）
5. Ctrl抬起（KEYEVENT_KEYUP）

示例代码片段：

// 左Ctrl按下
CefKeyEvent ev;
memset(&ev, 0, sizeof(ev));
ev.type = KEYEVENT_RAWKEYDOWN;
ev.windows_key_code = VK_CONTROL;
ev.native_key_code = 0xffe3; // X11左Ctrl键码
ev.modifiers = EVENTFLAG_CONTROL_DOWN;
ev.focus_on_editable_field = true;
host->SendKeyEvent(ev);

// A按下
memset(&ev, 0, sizeof(ev));
ev.type = KEYEVENT_RAWKEYDOWN;
ev.windows_key_code = 'A';
ev.native_key_code = 0x61; // X11 'a'键码
ev.modifiers = EVENTFLAG_CONTROL_DOWN;
ev.focus_on_editable_field = true;
host->SendKeyEvent(ev);

// Ctrl+A字符事件
memset(&ev, 0, sizeof(ev));
ev.type = KEYEVENT_CHAR;
ev.character = 1; // Ctrl+A对应的ASCII控制字符
ev.unmodified_character = 'a';
ev.modifiers = EVENTFLAG_CONTROL_DOWN;
ev.focus_on_editable_field = true;
host->SendKeyEvent(ev);

// A抬起
memset(&ev, 0, sizeof(ev));
ev.type = KEYEVENT_KEYUP;
ev.windows_key_code = 'A';
ev.native_key_code = 0x61;
ev.modifiers = EVENTFLAG_CONTROL_DOWN;
ev.focus_on_editable_field = true;
host->SendKeyEvent(ev);

// Ctrl抬起
memset(&ev, 0, sizeof(ev));
ev.type = KEYEVENT_KEYUP;
ev.windows_key_code = VK_CONTROL;
ev.native_key_code = 0xffe3;
ev.focus_on_editable_field = true;
host->SendKeyEvent(ev);

2. native_key_code和event.type的正确设置 #

• native_key_code：必须填写X11标准键码（可参考<X11/keysym.h>），比如左Ctrl为0xffe3，A键为0x61（对应键盘物理键位，大小写由Shift修饰符控制）。
• event.type：
  • KEYEVENT_RAWKEYDOWN：发送按键按下的原始事件，是Chromium识别快捷键状态的基础。
  • KEYEVENT_CHAR：发送字符或控制码事件，Ctrl+A这类快捷键必须发送对应ASCII控制码才能被正确识别。
  • KEYEVENT_KEYUP：发送按键抬起事件，需与KEYEVENT_RAWKEYDOWN配对。

注意：KEYEVENT_CHAR事件不可省略，这是Linux下CEF处理文本输入和快捷键的关键。

3. SDL2按键数据转CEF事件的标准方案 #

SDL2在Linux下直接对接X11，可通过以下逻辑转换按键数据：

1. 键码映射：SDL的SDL_Keysym::sym字段对应X11键码，可直接赋值给CefKeyEvent::native_key_code；同时将SDL键码映射为CEF的Windows虚拟键码（如SDLK_LCTRL→VK_CONTROL）。
2. 修饰符映射：将SDL的SDL_GetModState()结果转换为CEF的EVENTFLAG_*常量：
   • SDL_KMOD_CTRL → EVENTFLAG_CONTROL_DOWN
   • SDL_KMOD_SHIFT → EVENTFLAG_SHIFT_DOWN
   • SDL_KMOD_ALT → EVENTFLAG_ALT_DOWN
3. 事件类型对应：
   • SDL_KEYDOWN → 先发送KEYEVENT_RAWKEYDOWN，若为可打印/控制字符，再发送KEYEVENT_CHAR。
   • SDL_KEYUP → 发送KEYEVENT_KEYUP。

示例转换逻辑：

void ConvertSDLKeyToCEF(const SDL_Event& sdl_event, CefRefPtr<CefBrowserHost> host) {
    CefKeyEvent cef_event;
    memset(&cef_event, 0, sizeof(cef_event));
    cef_event.focus_on_editable_field = true;

    // 转换修饰符
    Uint16 sdl_mod = SDL_GetModState();
    if (sdl_mod & SDL_KMOD_CTRL) cef_event.modifiers |= EVENTFLAG_CONTROL_DOWN;
    if (sdl_mod & SDL_KMOD_SHIFT) cef_event.modifiers |= EVENTFLAG_SHIFT_DOWN;
    if (sdl_mod & SDL_KMOD_ALT) cef_event.modifiers |= EVENTFLAG_ALT_DOWN;

    // 转换键码
    cef_event.native_key_code = sdl_event.key.keysym.sym;
    switch(sdl_event.key.keysym.sym) {
        case SDLK_LCTRL: case SDLK_RCTRL:
            cef_event.windows_key_code = VK_CONTROL;
            break;
        case SDLK_a: case SDLK_A:
            cef_event.windows_key_code = 'A';
            break;
        // 其他按键映射
    }

    // 转换事件类型并发送
    if (sdl_event.type == SDL_KEYDOWN) {
        cef_event.type = KEYEVENT_RAWKEYDOWN;
        host->SendKeyEvent(cef_event);

        // 发送字符事件
        if (sdl_event.key.keysym.unicode != 0) {
            CefKeyEvent char_event = cef_event;
            char_event.type = KEYEVENT_CHAR;
            char_event.character = sdl_event.key.keysym.unicode;
            // 处理Ctrl+字母类控制字符
            if (char_event.character >= 1 && char_event.character <= 26) {
                char_event.unmodified_character = 'a' + char_event.character - 1;
            }
            host->SendKeyEvent(char_event);
        }
    } else if (sdl_event.type == SDL_KEYUP) {
        cef_event.type = KEYEVENT_KEYUP;
        host->SendKeyEvent(cef_event);
    }
}

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