Android中如何禁止ViewPager在斜向滑动时切换页面？

我有一个包含ViewPager2的Activity，该ViewPager2承载多个页面，每个页面内都包含一个RecyclerView。水平和垂直滑动的表现符合预期：水平滑动切换页面，垂直滑动滚动RecyclerView。

但用户进行斜向滑动时，页面会发生切换。如何避免这种情况？斜向滑动应仅触发RecyclerView的滚动。

布局代码：

<?xml version="1.0" encoding="utf-8"?>
<androidx.viewpager2.widget.ViewPager2 xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/page"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

我已尝试以下代码，但未解决问题：

binding.page.setOnTouchListener(object : View.OnTouchListener {
    override fun onTouch(v: View?, event: MotionEvent?): Boolean {
        when (event?.action) {
            MotionEvent.ACTION_DOWN -> binding.page.isUserInputEnabled = false
        }
        return v?.onTouchEvent(event) ?: true
    }
})

核心思路是动态判断滑动方向的优先级：当垂直滑动的分量（距离/速度）大于水平时，让RecyclerView处理触摸事件，阻止ViewPager2拦截。以下是两种可靠的实现方式：

方式一：自定义ViewPager2重写拦截逻辑 #

创建自定义ViewPager2子类，在触摸拦截时判断滑动方向，仅当水平滑动占优时才允许页面切换：

class CustomViewPager2(context: Context, attrs: AttributeSet?) : ViewPager2(context, attrs) {
    private var startX = 0f
    private var startY = 0f

    override fun onInterceptTouchEvent(event: MotionEvent): Boolean {
        when (event.action) {
            MotionEvent.ACTION_DOWN -> {
                startX = event.x
                startY = event.y
                // 按下时重置父布局拦截状态
                parent.requestDisallowInterceptTouchEvent(false)
            }
            MotionEvent.ACTION_MOVE -> {
                val dx = abs(event.x - startX)
                val dy = abs(event.y - startY)
                // 垂直滑动占优时，禁止ViewPager2拦截，交给RecyclerView处理
                if (dy > dx) {
                    parent.requestDisallowInterceptTouchEvent(true)
                    return false
                }
            }
        }
        return super.onInterceptTouchEvent(event)
    }
}

之后在布局中替换原ViewPager2为这个自定义类：

<?xml version="1.0" encoding="utf-8"?>
<com.yourpackage.CustomViewPager2 xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/page"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

方式二：给RecyclerView添加触摸监听 #

如果不想自定义ViewPager2，可以给每个页面的RecyclerView添加触摸监听，动态控制父布局的拦截权限：

// 在RecyclerView所在的Fragment/ViewHolder中添加
recyclerView.setOnTouchListener { _, event ->
    when (event.action) {
        MotionEvent.ACTION_DOWN -> {
            // 按下时阻止父布局（ViewPager2）拦截事件
            recyclerView.parent.requestDisallowInterceptTouchEvent(true)
        }
        MotionEvent.ACTION_MOVE -> {
            val dx = abs(event.x - event.rawX)
            val dy = abs(event.y - event.rawY)
            // 水平滑动占优时，允许父布局拦截以切换页面
            if (dx > dy) {
                recyclerView.parent.requestDisallowInterceptTouchEvent(false)
            } else {
                // 垂直滑动占优时，继续阻止父布局拦截
                recyclerView.parent.requestDisallowInterceptTouchEvent(true)
            }
        }
        MotionEvent.ACTION_UP, MotionEvent.ACTION_CANCEL -> {
            // 滑动结束后恢复父布局的拦截权限
            recyclerView.parent.requestDisallowInterceptTouchEvent(false)
        }
    }
    // 让RecyclerView处理自身的触摸逻辑
    false
}

原代码无效的原因 #

你之前的代码在ACTION_DOWN时直接禁用了ViewPager2的输入，这会导致所有滑动都无法切换页面，属于一刀切的错误逻辑，没有动态区分滑动方向。

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