水平RecyclerView长按Dpad右键焦点异常跳转至外部视图问题求助

核心问题原因 #

长按Dpad右键时，系统默认的焦点寻路逻辑会优先扫描全局可聚焦控件，而非局限在RecyclerView内部，导致焦点从首个Item跳到了上方的Button。我们需要强制拦截长按事件，让焦点始终留在RecyclerView内部。

具体实现方案 #

1. 自定义RecyclerView拦截按键事件 #

创建自定义RecyclerView类，重写长按按键处理方法，强制将焦点移动到内部下一个Item：

class FocusLockedRecyclerView(context: Context, attrs: AttributeSet?) : RecyclerView(context, attrs) {
    override fun onKeyLongPress(keyCode: Int, event: KeyEvent): Boolean {
        // 只处理Dpad右键的长按事件
        if (keyCode == KeyEvent.KEYCODE_DPAD_RIGHT) {
            val layoutManager = layoutManager as LinearLayoutManager
            val currentPos = layoutManager.findFirstVisibleItemPosition()
            val totalItems = adapter?.itemCount ?: 0
            
            // 若当前不是最后一个Item，强制跳转焦点到下一个
            if (currentPos < totalItems - 1) {
                layoutManager.scrollToPosition(currentPos + 1)
                findViewHolderForAdapterPosition(currentPos + 1)?.itemView?.requestFocus()
                return true
            }
        }
        return super.onKeyLongPress(keyCode, event)
    }

    override fun onKeyDown(keyCode: Int, event: KeyEvent): Boolean {
        // 提前拦截长按触发的按键事件，避免走系统默认逻辑
        if (keyCode == KeyEvent.KEYCODE_DPAD_RIGHT && event.isLongPress) {
            return onKeyLongPress(keyCode, event)
        }
        return super.onKeyDown(keyCode, event)
    }
}

2. 布局中替换为自定义RecyclerView #

把原布局里的标准RecyclerView替换成上面的自定义类：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <Button
        android:id="@+id/top_button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="顶部按钮"/>

    <com.your.package.name.FocusLockedRecyclerView
        android:id="@+id/horizontal_rv"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal"/>

</LinearLayout>

3. 确保RecyclerView的Item可聚焦 #

在Item布局中添加焦点相关属性，保证每个Item能正常获取和持有焦点：

<TextView xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:focusable="true"
    android:focusableInTouchMode="true"
    android:padding="16dp"/>

适配说明 #

• 如果使用GridLayoutManager，只需将代码中的LinearLayoutManager替换为GridLayoutManager，调整焦点移动的位置计算逻辑即可。
• 该方案仅拦截Dpad右键的长按事件，不会影响其他按键的正常焦点行为。

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