如何限制ViewPager2仅可拖动切换至相邻页面？当前可无限上下滑动

要实现类似TikTok的单页滑动切换效果（仅能拖动到上一页或下一页，禁止跨多页无限滑动），同时避免setUserInputEnabled(false)带来的生硬体验，可以通过以下两种平滑方案实现：

方案一：基于PageChangeCallback修正滚动行为 #

通过监听页面滚动状态，在用户试图跨页滑动时自动回弹到相邻有效页面，保留滑动连贯性：

private int currentPage = 0;
private boolean isScrolling = false;

vp2.registerOnPageChangeCallback(new ViewPager2.OnPageChangeCallback() {
    @Override
    public void onPageSelected(int position) {
        currentPage = position;
        super.onPageSelected(position);
    }

    @Override
    public void onPageScrollStateChanged(int state) {
        isScrolling = state != ViewPager2.SCROLL_STATE_IDLE;
        super.onPageScrollStateChanged(state);
    }

    @Override
    public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {
        super.onPageScrolled(position, positionOffset, positionOffsetPixels);
        // 检测到试图跨多页滑动时，强制平滑滚动到相邻页
        if (isScrolling && Math.abs(position - currentPage) > 1) {
            int targetPage = position > currentPage ? currentPage + 1 : currentPage - 1;
            vp2.setCurrentItem(targetPage, true);
        }
    }
});

方案二：自定义触摸拦截器（精准控制滑动逻辑） #

通过拦截ViewPager2内部RecyclerView的触摸事件，根据滑动距离和方向限制仅触发相邻页切换：

// 获取ViewPager2内部的RecyclerView实例
RecyclerView recyclerView = (RecyclerView) vp2.getChildAt(0);
recyclerView.addOnItemTouchListener(new RecyclerView.OnItemTouchListener() {
    private float startX, startY;
    private boolean isIntercepted = false;

    @Override
    public boolean onInterceptTouchEvent(@NonNull RecyclerView rv, @NonNull MotionEvent e) {
        switch (e.getAction()) {
            case MotionEvent.ACTION_DOWN:
                startX = e.getX();
                startY = e.getY();
                isIntercepted = false;
                break;
            case MotionEvent.ACTION_MOVE:
                float dx = Math.abs(e.getX() - startX);
                float dy = Math.abs(e.getY() - startY);
                // 垂直滑动场景（TikTok式），水平滑动则替换为dx判断
                boolean isVerticalScroll = dy > dx;
                if (isVerticalScroll) {
                    int currentPos = vp2.getCurrentItem();
                    int totalPages = vp2.getAdapter().getItemCount();
                    float scrollThreshold = rv.getHeight() * 0.4f; // 自定义触发翻页的阈值

                    // 边界页禁止反向滑动
                    if ((currentPos == 0 && (e.getY() - startY) < 0) 
                        || (currentPos == totalPages - 1 && (e.getY() - startY) > 0)) {
                        isIntercepted = true;
                    }
                    // 滑动距离超过2倍阈值，判定为试图跨多页，强制切换到相邻页并拦截事件
                    else if (dy > scrollThreshold * 2) {
                        int targetPos = (e.getY() - startY) > 0 ? currentPos + 1 : currentPos - 1;
                        vp2.setCurrentItem(targetPos, true);
                        isIntercepted = true;
                    }
                }
                break;
        }
        return isIntercepted;
    }

    @Override
    public void onTouchEvent(@NonNull RecyclerView rv, @NonNull MotionEvent e) {}

    @Override
    public void onRequestDisallowInterceptTouchEvent(boolean disallowIntercept) {}
});

方案说明 #

• 方案一实现简单，依托ViewPager2原生回调修正滚动，适配大多数常规场景；
• 方案二更灵活，可自定义滑动阈值、边界行为，适合有特殊交互需求的场景；
• 若为水平滑动的ViewPager2，只需将代码中判断滑动方向的dy替换为dx即可。

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