RecyclerView SnapHelper实现选中与未选中Item背景切换问题

我来帮你搞定这个问题——你之前遇到的IllegalStateException和直接修改子View无效的情况，核心原因是没正确结合RecyclerView的复用机制和Adapter状态管理来处理选中状态。下面给你一步步的解决方案：

为什么之前的方法会出问题？ #

• 直接用全局变量snappedPosition+notifyItemChanged：如果在RecyclerView正在布局（比如滚动过程中）调用更新方法，会触发非法状态异常，因为RecyclerView不允许在布局阶段修改数据。
• 滚动监听里直接改子View：RecyclerView的View复用机制会让你修改的View被其他Item复用，导致背景色混乱，滚出屏幕的Item再回来时状态不对。

正确的实现步骤 #

1. 让Adapter内部维护选中状态 #

不要用全局变量，把选中位置交给Adapter管理，这样能保证状态和UI绑定的一致性：

class HorizontalItemAdapter : RecyclerView.Adapter<HorizontalItemAdapter.ItemViewHolder>() {
    // 初始选中第0项
    private var selectedPosition = 0

    // 提供更新选中位置的方法，同时更新旧/新位置的UI
    fun updateSelectedPosition(newPos: Int) {
        val oldPos = selectedPosition
        selectedPosition = newPos
        // 通知旧位置和新位置刷新UI，避免状态残留
        notifyItemChanged(oldPos)
        notifyItemChanged(newPos)
    }

    inner class ItemViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView)

    override fun onBindViewHolder(holder: ItemViewHolder, position: Int) {
        // 绑定View时直接根据选中状态设置背景色
        val bgColor = if (position == selectedPosition) {
            ContextCompat.getColor(holder.itemView.context, R.color.selected_background)
        } else {
            ContextCompat.getColor(holder.itemView.context, R.color.normal_background)
        }
        holder.itemView.setBackgroundColor(bgColor)

        // 其他Item内容绑定逻辑...
    }

    override fun getItemCount(): Int {
        // 返回你的Item数量
        return yourItemList.size
    }

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ItemViewHolder {
        val view = LayoutInflater.from(parent.context).inflate(R.layout.item_horizontal, parent, false)
        return ItemViewHolder(view)
    }
}

2. 结合SnapHelper和滚动监听获取居中位置 #

通过LinearSnapHelper的findSnapPosition方法，在滚动停止时准确获取当前居中的Item位置，然后通知Adapter更新：

// 初始化RecyclerView和SnapHelper
val recyclerView = findViewById<RecyclerView>(R.id.rv_horizontal)
val layoutManager = LinearLayoutManager(this, LinearLayoutManager.HORIZONTAL, false)
recyclerView.layoutManager = layoutManager
val adapter = HorizontalItemAdapter()
recyclerView.adapter = adapter

val snapHelper = LinearSnapHelper()
snapHelper.attachToRecyclerView(recyclerView)

// 添加滚动监听，仅在滚动停止时更新选中状态
recyclerView.addOnScrollListener(object : RecyclerView.OnScrollListener() {
    override fun onScrollStateChanged(recyclerView: RecyclerView, newState: Int) {
        super.onScrollStateChanged(recyclerView, newState)
        // 滚动停止时才处理，避免频繁更新导致异常
        if (newState == RecyclerView.SCROLL_STATE_IDLE) {
            val currentSnapPos = snapHelper.findSnapPosition(recyclerView.layoutManager)
            if (currentSnapPos != RecyclerView.NO_POSITION && currentSnapPos != adapter.selectedPosition) {
                adapter.updateSelectedPosition(currentSnapPos)
            }
        }
    }
})

3. 进阶：用SnapHelper的回调简化监听（可选） #

如果你用的是AndroidX RecyclerView 1.2.0及以上版本，可以直接用OnSnapPositionChangeListener来监听居中位置变化，代码更简洁：

snapHelper.setOnSnapPositionChangeListener(object : SnapHelper.OnSnapPositionChangeListener {
    override fun onSnapPositionChange(position: Int) {
        if (position != RecyclerView.NO_POSITION && position != adapter.selectedPosition) {
            adapter.updateSelectedPosition(position)
        }
    }
})

关键注意事项 #

• 永远不要在RecyclerView布局过程中（比如onBindViewHolder里）调用notifyItemChanged，这会触发IllegalStateException。
• 依赖Adapter的onBindViewHolder来设置UI状态，而不是直接修改子View，这样能适配RecyclerView的复用机制。
• 更新选中状态时，一定要同时刷新旧位置和新位置，确保旧选中Item恢复默认背景。

这样就能完美实现你想要的——居中Item显示选中背景，其他Item显示默认背景的效果啦！

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