Android Talkback结合RecyclerView实现标题导航异常问题咨询

问题根源 #

你猜的没错——就是RecyclerView的视图回收机制导致的。RecyclerView只会保留当前屏幕可见（或预加载少量）的item视图，不在可视范围内的item会被回收并从视图层级中移除。而Talkback的标题导航依赖于当前存在于视图树中的View，那些被回收的标题视图因为不在视图树里，自然无法被Talkback检测到，才会出现导航不稳定的情况。ViewCompat.setAccessibilityHeading这个API本身和RecyclerView没有兼容性问题，只是它的作用范围仅限当前存活的视图。

解决思路与具体实现 #

要让Talkback能识别所有标题（包括未在屏幕显示的），需要绕过RecyclerView的视图回收限制，通过自定义辅助功能节点来暴露所有标题信息：

1. 自定义RecyclerView的AccessibilityDelegate
   给RecyclerView设置自定义的AccessibilityDelegate，重写getAccessibilityNodeProvider方法，自己构建包含所有标题的辅助功能节点树。示例代码大致如下：

   recyclerView.accessibilityDelegate = object : View.AccessibilityDelegate() {
       override fun getAccessibilityNodeProvider(host: View?): AccessibilityNodeProvider? {
           return object : AccessibilityNodeProvider() {
               override fun createAccessibilityNodeInfo(nodeId: Int): AccessibilityNodeInfo? {
                   // 处理根节点（RecyclerView本身）
                   if (nodeId == AccessibilityNodeInfo.ROOT_NODE_ID) {
                       val rootInfo = AccessibilityNodeInfo.obtain(host)
                       rootInfo.className = RecyclerView::class.java.name
                       rootInfo.setParent(host)
                       // 遍历数据源，为每个标题添加子节点
                       dataList.forEachIndexed { index, item ->
                           if (item.isTitle) {
                               val titleNode = AccessibilityNodeInfo.obtain(host)
                               titleNode.className = TextView::class.java.name
                               titleNode.text = item.titleText
                               titleNode.isHeading = true
                               // 设置节点ID，用于后续导航回调
                               titleNode.id = index + 1
                               // 添加到根节点的子节点中
                               rootInfo.addChild(host, titleNode.id)
                               titleNode.recycle()
                           }
                       }
                       return rootInfo
                   }
                   // 处理标题节点的点击/导航逻辑
                   val targetPosition = nodeId - 1
                   val item = dataList[targetPosition]
                   if (item.isTitle) {
                       val nodeInfo = AccessibilityNodeInfo.obtain(host)
                       nodeInfo.text = item.titleText
                       nodeInfo.isHeading = true
                       // 设置滚动到该位置的动作
                       nodeInfo.addAction(AccessibilityNodeInfo.ACTION_FOCUS)
                       nodeInfo.addAction(AccessibilityNodeInfo.ACTION_SCROLL_TO_POSITION)
                       return nodeInfo
                   }
                   return super.createAccessibilityNodeInfo(nodeId)
               }
   
               override fun performAction(nodeId: Int, action: Int, arguments: Bundle?): Boolean {
                   val targetPosition = nodeId - 1
                   if (action == AccessibilityNodeInfo.ACTION_FOCUS || action == AccessibilityNodeInfo.ACTION_SCROLL_TO_POSITION) {
                       // 滚动到目标标题位置
                       recyclerView.layoutManager?.scrollToPosition(targetPosition)
                       // 滚动后延迟聚焦到标题视图
                       recyclerView.post {
                           val titleView = recyclerView.findViewHolderForAdapterPosition(targetPosition)?.itemView?.findViewById<TextView>(R.id.title)
                           titleView?.requestFocus()
                       }
                       return true
                   }
                   return super.performAction(nodeId, action, arguments)
               }
           }
       }
   }
   

2. 配合数据源同步更新节点信息
   当RecyclerView的数据源发生变化（比如下拉刷新、加载更多）时，需要调用recyclerView.sendAccessibilityEvent(AccessibilityEvent.TYPE_WINDOW_CONTENT_CHANGED)，通知Talkback更新辅助功能节点，避免出现无效或缺失的标题节点。

3. 优化导航体验
   滚动到目标标题后，确保标题视图处于屏幕的合适位置（比如顶部），可以使用layoutManager.scrollToPositionWithOffset(targetPosition, 0)代替scrollToPosition，提升Talkback用户的导航体验。

额外提示 #

• 测试时要覆盖不同的Talkback版本，部分旧版本的辅助功能框架对虚拟节点的支持可能有限。
• 不要在标题视图的onBindViewHolder中重复调用ViewCompat.setAccessibilityHeading，避免不必要的性能开销，只需要绑定一次即可。

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