Android TV开启TalkBack时WebView自定义键盘导航处理方案

一、调整WebView基础配置 #

确保WebView具备焦点获取和事件处理能力，解决TalkBack接管焦点导致的事件丢失问题：

• 强制WebView获取焦点：

  webView.setFocusable(true);
  webView.setFocusableInTouchMode(true);
  webView.requestFocus();
  

• 开启JavaScript支持（Web应用处理导航的必备配置）：

  webView.getSettings().setJavaScriptEnabled(true);
  

二、在Android层拦截并传递按键事件 #

TalkBack会优先接管系统按键事件，需在Activity/Fragment层级拦截导航类按键，手动传递给WebView：

@Override
public boolean dispatchKeyEvent(KeyEvent event) {
    // 仅处理按键按下动作
    if (event.getAction() != KeyEvent.ACTION_DOWN) {
        return super.dispatchKeyEvent(event);
    }

    // 拦截核心导航按键
    int keyCode = event.getKeyCode();
    if (keyCode == KeyEvent.KEYCODE_DPAD_UP ||
        keyCode == KeyEvent.KEYCODE_DPAD_DOWN ||
        keyCode == KeyEvent.KEYCODE_DPAD_LEFT ||
        keyCode == KeyEvent.KEYCODE_DPAD_RIGHT ||
        keyCode == KeyEvent.KEYCODE_ENTER) {
        
        // 优先让WebView处理事件，返回true表示已消费该事件
        if (webView.dispatchKeyEvent(event)) {
            return true;
        }
    }
    return super.dispatchKeyEvent(event);
}

三、Web端适配：阻止默认无障碍行为+强化事件监听 #

在Web页面中，通过JS拦截按键并阻止系统默认处理，确保自定义导航逻辑优先执行：

1. 给可导航元素设置正确的无障碍属性（兼顾TalkBack朗读和自定义导航）：

<div tabindex="0" role="button" aria-label="首页按钮" class="nav-item">首页</div>

2. 监听keydown事件并阻止默认行为：

document.addEventListener('keydown', function(e) {
    switch(e.keyCode) {
        case 38: // 上方向键
            customNavigateUp();
            e.preventDefault(); // 阻止TalkBack的默认导航行为
            break;
        case 40: // 下方向键
            customNavigateDown();
            e.preventDefault();
            break;
        case 37: // 左方向键
            customNavigateLeft();
            e.preventDefault();
            break;
        case 39: // 右方向键
            customNavigateRight();
            e.preventDefault();
            break;
        case 13: // 确认键
            customConfirm();
            e.preventDefault();
            break;
    }
});

四、优化WebView无障碍代理（可选） #

如果上述方案仍有问题，可通过自定义无障碍代理，确保按键事件能穿透到WebView：

webView.setAccessibilityDelegate(new View.AccessibilityDelegate() {
    @Override
    public boolean dispatchKeyEvent(View host, KeyEvent event) {
        // 优先让WebView处理按键
        if (host instanceof WebView && ((WebView) host).dispatchKeyEvent(event)) {
            return true;
        }
        return super.dispatchKeyEvent(host, event);
    }
});

测试注意事项 #

• 开启TalkBack后，先确认WebView已获取焦点（可通过系统焦点边框判断）
• 逐个测试导航按键，验证自定义逻辑是否生效，同时确保TalkBack对元素的朗读功能正常

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