Android：如何让RecyclerView滚动并聚焦到屏幕外元素

核心问题原因 #

直接调用recycler.scrollToPosition(14)报错，是因为RecyclerView采用按需加载ViewHolder的机制，初始化阶段仅创建可见区域的item视图，目标位置的ViewHolder尚未被实例化，后续若依赖该视图操作（比如请求焦点）就会触发索引越界。

可行解决方案 #

方案1：使用LayoutManager的scrollToPositionWithOffset方法 #

该方法会强制触发目标位置item的布局，确保ViewHolder被创建，同时可指定偏移量控制显示位置：

// 假设你的RecyclerView使用LinearLayoutManager
val layoutManager = recyclerView.layoutManager as LinearLayoutManager
// savedPosition为保存的目标索引（比如14），0表示item顶部与RecyclerView顶部对齐
layoutManager.scrollToPositionWithOffset(savedPosition, 0)

// 若需要请求焦点，可在滚动后获取ViewHolder视图
val targetViewHolder = recyclerView.findViewHolderForAdapterPosition(savedPosition)
targetViewHolder?.itemView?.requestFocus()

方案2：监听RecyclerView布局完成事件 #

在RecyclerView完成全局布局后再执行滚动和焦点请求，避免操作未创建的视图：

recyclerView.viewTreeObserver.addOnGlobalLayoutListener(object : ViewTreeObserver.OnGlobalLayoutListener {
    override fun onGlobalLayout() {
        // 必须移除监听，防止重复触发
        recyclerView.viewTreeObserver.removeOnGlobalLayoutListener(this)
        
        // 滚动到目标位置
        recyclerView.scrollToPosition(savedPosition)
        
        // 请求焦点
        val targetView = recyclerView.findViewHolderForAdapterPosition(savedPosition)?.itemView
        targetView?.requestFocus()
    }
})

方案3：在Adapter绑定阶段处理焦点请求 #

在onBindViewHolder中判断当前item是否为目标位置，通过post确保视图已布局完成后请求焦点：

class LanguageAdapter(private val savedPosition: Int, private val recyclerView: RecyclerView) : RecyclerView.Adapter<LanguageAdapter.ViewHolder>() {
    private val dataList = listOf("语言1", "语言2", "...", "语言15")
    
    // ... 其他方法
    
    override fun onBindViewHolder(holder: ViewHolder, position: Int) {
        // 绑定语言数据
        holder.languageTv.text = dataList[position]
        
        if (position == savedPosition) {
            holder.itemView.post {
                // 请求焦点
                holder.itemView.requestFocus()
                // 确保item滚动到可见区域
                val layoutManager = recyclerView.layoutManager as LinearLayoutManager
                layoutManager.scrollToPositionWithOffset(position, 0)
            }
        }
    }
    
    inner class ViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
        val languageTv: TextView = itemView.findViewById(R.id.tv_language)
    }
}

注意事项 #

• 先校验savedPosition的有效性：确保它在0到adapter.itemCount - 1范围内，避免无效索引操作。
• 确保目标item的视图可聚焦：在item布局文件中添加android:focusable="true"和android:focusableInTouchMode="true"属性。
• 若使用GridLayoutManager，同样可调用scrollToPositionWithOffset方法，偏移量规则与布局方向对应。

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