ViewPager与RecyclerView(ItemTouchHelper)滑动冲突解决方案咨询

这个问题本质是横向滑动事件的分发冲突——ViewPager和RecyclerView（配合ItemTouchHelper）都想处理横向滑动，我们需要让系统能精准区分：触摸的是可滑动列表项时，交给ItemTouchHelper处理item滑动；触摸空白区域时，交给ViewPager完成页面切换。

核心思路 #

利用Android事件分发机制的requestDisallowInterceptTouchEvent()方法：

• 当手指按下（ACTION_DOWN）时，判断触摸点是否落在可被ItemTouchHelper滑动的列表项上
• 如果是，请求父View（ViewPager）不要拦截后续触摸事件，让RecyclerView+ItemTouchHelper处理滑动
• 如果不是，允许父View拦截事件，让ViewPager处理页面切换

具体实现方案 #

方案1：自定义RecyclerView（推荐，耦合度低）

创建一个继承自RecyclerView的自定义View，内置触摸位置判断逻辑：

class TouchAwareRecyclerView(context: Context, attrs: AttributeSet?) : RecyclerView(context, attrs) {
    private var itemTouchHelper: ItemTouchHelper? = null
    private var touchedItemPosition = -1

    // 关联ItemTouchHelper，用于判断item是否可滑动
    fun bindItemTouchHelper(helper: ItemTouchHelper) {
        this.itemTouchHelper = helper
    }

    override fun onInterceptTouchEvent(e: MotionEvent): Boolean {
        val interceptResult = super.onInterceptTouchEvent(e)
        
        when (e.action) {
            MotionEvent.ACTION_DOWN -> {
                // 找到触摸点对应的item位置
                touchedItemPosition = findChildViewUnder(e.x, e.y)?.let { childView ->
                    getChildAdapterPosition(childView)
                } ?: -1

                // 判断该item是否支持滑动（通过ItemTouchHelper的Callback判断）
                val isItemSwipeable = touchedItemPosition != -1 && itemTouchHelper?.run {
                    val callback = this.callback
                    callback.isItemViewSwipeEnabled && callback.getSwipeDirs(this@TouchAwareRecyclerView, adapter?.getItem(touchedItemPosition)) != 0
                } ?: false

                // 告诉父View是否要拦截事件
                parent.requestDisallowInterceptTouchEvent(isItemSwipeable)
            }
            MotionEvent.ACTION_UP, MotionEvent.ACTION_CANCEL -> {
                // 事件结束，重置状态，允许父View拦截后续事件
                parent.requestDisallowInterceptTouchEvent(false)
                touchedItemPosition = -1
            }
        }
        return interceptResult
    }
}

然后在你的Fragment中，初始化ItemTouchHelper时关联这个自定义RecyclerView：

// 初始化你的ItemTouchHelper Callback
val swipeCallback = object : ItemTouchHelper.SimpleCallback(0, ItemTouchHelper.LEFT or ItemTouchHelper.RIGHT) {
    override fun onMove(recyclerView: RecyclerView, viewHolder: RecyclerView.ViewHolder, target: RecyclerView.ViewHolder): Boolean {
        return false // 不需要拖拽，只处理滑动
    }

    override fun onSwiped(viewHolder: RecyclerView.ViewHolder, direction: Int) {
        // 处理item滑动后的逻辑，比如删除、标记已读等
    }
}

val itemTouchHelper = ItemTouchHelper(swipeCallback)
val recyclerView = view.findViewById<TouchAwareRecyclerView>(R.id.your_recycler_view)
itemTouchHelper.attachToRecyclerView(recyclerView)
recyclerView.bindItemTouchHelper(itemTouchHelper)

方案2：通过OnTouchListener处理（无需自定义View）

如果不想自定义RecyclerView，也可以直接给RecyclerView设置触摸监听器：

val itemTouchHelper = ItemTouchHelper(yourSwipeCallback)
itemTouchHelper.attachToRecyclerView(recyclerView)

recyclerView.setOnTouchListener { v, event ->
    when (event.action) {
        MotionEvent.ACTION_DOWN -> {
            val childView = recyclerView.findChildViewUnder(event.x, event.y)
            val position = childView?.let { recyclerView.getChildAdapterPosition(it) } ?: -1
            
            val isSwipeable = position != -1 && itemTouchHelper.callback.run {
                isItemViewSwipeEnabled && getSwipeDirs(recyclerView, recyclerView.adapter?.getItem(position)) != 0
            }
            
            recyclerView.parent.requestDisallowInterceptTouchEvent(isSwipeable)
        }
        MotionEvent.ACTION_UP, MotionEvent.ACTION_CANCEL -> {
            recyclerView.parent.requestDisallowInterceptTouchEvent(false)
        }
    }
    false // 返回false，让RecyclerView自己处理触摸事件
}

关键细节说明 #

1. 如何判断item是否可滑动？
   我们通过ItemTouchHelper的Callback来判断：
   • isItemViewSwipeEnabled：全局是否允许滑动
   • getSwipeDirs()：当前item是否允许某个方向的滑动（比如有些item可能不需要滑动功能）
2. 为什么在ACTION_DOWN时处理？
   因为父View的拦截逻辑（onInterceptTouchEvent）在ACTION_MOVE时才会触发，在ACTION_DOWN时提前告诉父View不要拦截，才能让后续的滑动事件顺利传递到RecyclerView。
3. 事件结束后必须重置状态
   在ACTION_UP或ACTION_CANCEL时，必须调用requestDisallowInterceptTouchEvent(false)，否则后续的触摸事件会一直被RecyclerView拦截，导致ViewPager无法正常切换页面。

内容的提问来源于stack exchange，提问作者Сергей В