RecyclerView无障碍遍历异常：向左滑动无法跳出无限列表

需求：无障碍服务（如TalkBack）遍历RecyclerView时，当目标项不在屏幕视野内，停止遍历RecyclerView，转而访问外部元素。
现状：向右滑动切换元素时符合预期——无可见项时自动跳转至RecyclerView外的元素；但向左滑动时异常：因列表为无限循环（getItemCount = Int.MAX_VALUE），会持续向左滚动加载循环项，导致无法跳出RecyclerView的无障碍遍历。

复现步骤 #

• 开启TalkBack无障碍服务
• 向左/向右滑动遍历无障碍元素树

代码示例 #

build.gradle #

//enable view binding
buildFeatures {
    viewBinding true
}

activity_main.xml #

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="#00FFFF"
android:importantForAccessibility="yes"
android:focusable="true"
android:orientation="vertical">

    <TextView
        android:id="@+id/titleTextView"
        android:textSize="30sp"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:focusableInTouchMode="true"
        android:importantForAccessibility="yes"
        android:text="TITLE"
        android:layout_gravity="center" />
    
    
    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/recyclerView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:focusableInTouchMode="true"
        android:descendantFocusability="beforeDescendants"
        android:orientation="horizontal"
        android:importantForAccessibility="yes"
        app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"
        tools:listitem="@layout/item_blank" />
    
    <TextView
        android:id="@+id/nextItemTextView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="NEXT ITEM"
        android:focusableInTouchMode="true"
        android:textColor="@color/teal_700"
        android:background="@color/black"
        android:layout_gravity="center"
        android:layout_marginVertical="100dp" />

</LinearLayout>

MainActivity.kt #

class MainActivity : AppCompatActivity() {
    lateinit var binding : ActivityMainBinding
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        binding = ActivityMainBinding.inflate(layoutInflater)
        setContentView(binding.root)
        with(binding) {
            recyclerView.adapter = Adapter()
            val number: Int = Int.MAX_VALUE / 3 / 2
            recyclerView.scrollToPosition(number)
        }
    }
}

class Adapter : RecyclerView.Adapter<Adapter.ViewHolder>() {

    val noOfItems = 3
    private val initialPos = Int.MAX_VALUE / 3 / 2

    class ViewHolder(val binding: ItemBlankBinding) : RecyclerView.ViewHolder(binding.root)

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder {
        return ViewHolder(ItemBlankBinding.inflate(LayoutInflater.from(parent.context),parent, false))
    }

    override fun getItemCount(): Int {
        return Integer.MAX_VALUE;
    }

    override fun onBindViewHolder(holder: ViewHolder, position: Int) {
        val index = position % noOfItems
        with(holder.binding) {
            textView.text = index.toString()
            root.contentDescription = "$index"
            
            // 设置无障碍遍历的边界跳转
            when(position) {
                // 初始位置的项，向左遍历跳转至顶部TITLE
                initialPos -> root.accessibilityTraversalBefore = R.id.titleTextView
                // 初始位置+2的项，向右遍历跳转至底部NEXT ITEM
                initialPos + 2 -> root.accessibilityTraversalAfter = R.id.nextItemTextView
                else -> {
                    root.accessibilityTraversalBefore = View.NO_ID
                    root.accessibilityTraversalAfter = View.NO_ID
                }
            }
        }
    }
}

解决方案说明 #

核心思路是利用Android无障碍API中的accessibilityTraversalBefore和accessibilityTraversalAfter属性，给RecyclerView的特定循环项设置遍历跳转目标：

1. 给布局中的外部可访问元素（顶部TITLE、底部NEXT ITEM）添加唯一ID
2. 在Adapter的onBindViewHolder中，针对循环的边界项（初始位置项、初始位置+2项）设置对应的跳转目标：
   • 初始位置的项（对应index=0）向左滑动时，直接跳转至顶部TITLE
   • 初始位置+2的项（对应index=2）向右滑动时，直接跳转至底部NEXT ITEM
3. 其他项保持默认遍历逻辑，确保RecyclerView内部的正常遍历

这种方式既保留了无限循环的列表功能，又给无障碍服务设置了明确的遍历边界，解决了向左滑动无法跳出RecyclerView的问题。

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