如何为Android WebView添加自定义无障碍操作以跳转至底部按钮

问题原因 #

WebView的无障碍节点树由其加载的HTML内容生成，每个HTML元素对应独立的AccessibilityNodeInfo。当TalkBack焦点落在WebView内部元素上时，触发的是这些内部节点的无障碍事件，而非WebView本身的节点事件。直接给WebView设置AccessibilityDelegate，仅对WebView作为整体的节点生效，无法覆盖内部HTML元素节点，因此自定义操作不会显示。

解决方案 #

方案一：为WebView内部内容添加无障碍跳转入口（推荐） #

该方案保留WebView内部内容的正常导航，同时提供跳转入口：

1. 修改加载的HTML内容，添加隐藏的无障碍跳转链接，可放在内容开头或结尾（也可多处添加）：

<html>
    <h1>This is a webview</h1>
    <body>
        <!-- 隐藏的无障碍跳转链接，仅TalkBack可识别 -->
        <a href="action://jump-to-footer" aria-label="跳转到底部按钮" style="position:absolute; width:1px; height:1px; overflow:hidden;">跳转到底部按钮</a>
        
        <p>This is a paragraph inside web view</p>
        <p>This is another paragraph inside web view</p>
        
        <!-- 可在内容结尾再添加一个跳转链接 -->
        <a href="action://jump-to-footer" aria-label="跳转到底部按钮" style="position:absolute; width:1px; height:1px; overflow:hidden;">跳转到底部按钮</a>
    </body>
</html>

2. 在Android端拦截自定义URL，触发聚焦底部按钮的逻辑：

binding.webView.webViewClient = object : WebViewClient() {
    override fun shouldOverrideUrlLoading(view: WebView?, url: String?): Boolean {
        url?.takeIf { it == "action://jump-to-footer" }?.let {
            binding.btnFooter.apply {
                requestFocus()
                sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_FOCUSED)
            }
            return true
        }
        return super.shouldOverrideUrlLoading(view, url)
    }
}

用户在WebView内导航时，TalkBack会识别到隐藏的跳转链接，触发后直接跳转到底部按钮。

方案二：将WebView作为单个无障碍节点（适合简化场景） #

如果不需要用户逐元素导航WebView内部内容，可将WebView设置为单个无障碍节点，此时原有的CustomFocusAccessibilityDelegate即可生效：

binding.webView.settings.apply {
    // 关闭WebView内部的无障碍元素拆分
    accessibilityEnabled = false
}

binding.webView.accessibilityDelegate = CustomFocusAccessibilityDelegate {
    binding.btnFooter.apply {
        requestFocus()
        sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_FOCUSED)
    }
}

注意：此方法会让TalkBack将WebView视为单个可滚动的文本块，用户无法导航内部的段落、标题等元素。

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