如何实现RecyclerView与ScrollView滚动联动：仅触顶时自行滚动

要实现「RecyclerView未触顶时由父ScrollView滚动，触顶后自行滚动」的效果，核心是控制触摸事件的传递逻辑——根据RecyclerView的位置和滑动方向，决定让父ScrollView还是RecyclerView处理滚动事件。以下是两种可行的实现方案：

方案一：给RecyclerView设置触摸监听器拦截事件 #

通过监听RecyclerView的触摸事件，动态控制父ScrollView是否拦截事件，代码逻辑更直观：

// 初始化RecyclerView和父ScrollView
RecyclerView recyclerView = findViewById(R.id.recycler_view);
ScrollView parentScrollView = findViewById(R.id.parent_scroll_view);

recyclerView.setOnTouchListener(new View.OnTouchListener() {
    private float downY;
    private int recyclerViewTop;

    @Override
    public boolean onTouch(View v, MotionEvent event) {
        // 首次触摸时获取RecyclerView在ScrollView中的顶部位置
        if (recyclerViewTop == 0) {
            recyclerViewTop = v.getTop();
        }

        switch (event.getAction()) {
            case MotionEvent.ACTION_DOWN:
                downY = event.getY();
                // 先请求父View不拦截事件，确保能接收后续滑动事件
                parentScrollView.requestDisallowInterceptTouchEvent(true);
                break;
            case MotionEvent.ACTION_MOVE:
                float moveY = event.getY();
                float deltaY = moveY - downY;
                int scrollViewScrollY = parentScrollView.getScrollY();
                // 判断RecyclerView是否已经顶到屏幕顶部
                boolean isRecyclerViewAtScreenTop = scrollViewScrollY >= recyclerViewTop;

                if (deltaY < 0) {
                    // 向上滑动：未触顶则让父ScrollView滚动，触顶则自己滚动
                    if (!isRecyclerViewAtScreenTop) {
                        parentScrollView.requestDisallowInterceptTouchEvent(false);
                    } else {
                        parentScrollView.requestDisallowInterceptTouchEvent(true);
                    }
                } else if (deltaY > 0) {
                    // 向下滑动：RecyclerView无法继续向下滚动时，交给父ScrollView处理
                    boolean canRecyclerViewScrollDown = recyclerView.canScrollVertically(1);
                    if (!canRecyclerViewScrollDown) {
                        parentScrollView.requestDisallowInterceptTouchEvent(false);
                    } else {
                        parentScrollView.requestDisallowInterceptTouchEvent(true);
                    }
                }
                break;
            case MotionEvent.ACTION_UP:
            case MotionEvent.ACTION_CANCEL:
                // 触摸结束后恢复父View的拦截权限
                parentScrollView.requestDisallowInterceptTouchEvent(false);
                break;
        }
        // 返回false，让RecyclerView自身处理触摸事件（如点击、长按）
        return false;
    }
});

方案二：自定义ScrollView拦截事件 #

通过重写ScrollView的onInterceptTouchEvent方法，主动判断是否需要拦截滚动事件，适合需要复用逻辑的场景：

public class ParentScrollView extends ScrollView {
    private RecyclerView targetRecyclerView;
    private int recyclerViewTop;
    private float lastTouchY;

    public ParentScrollView(Context context) {
        super(context);
    }

    public ParentScrollView(Context context, AttributeSet attrs) {
        super(context, attrs);
    }

    // 设置需要联动的RecyclerView
    public void setTargetRecyclerView(RecyclerView recyclerView) {
        this.targetRecyclerView = recyclerView;
        // 布局完成后获取RecyclerView在ScrollView中的顶部位置
        recyclerView.post(() -> recyclerViewTop = recyclerView.getTop());
    }

    @Override
    public boolean onInterceptTouchEvent(MotionEvent ev) {
        if (targetRecyclerView == null) {
            return super.onInterceptTouchEvent(ev);
        }

        int scrollY = getScrollY();
        boolean isRecyclerViewAtTop = scrollY >= recyclerViewTop;

        switch (ev.getAction()) {
            case MotionEvent.ACTION_DOWN:
                lastTouchY = ev.getY();
                break;
            case MotionEvent.ACTION_MOVE:
                float deltaY = ev.getY() - lastTouchY;
                if (deltaY < 0 && !isRecyclerViewAtTop) {
                    // 向上滑动且RecyclerView未触顶，拦截事件自己滚动
                    return true;
                } else if (deltaY > 0) {
                    // 向下滑动且RecyclerView无法继续滚动，拦截事件自己滚动
                    boolean canRecyclerViewScrollDown = targetRecyclerView.canScrollVertically(1);
                    if (!canRecyclerViewScrollDown) {
                        return true;
                    }
                }
                break;
        }
        // 其他情况不拦截，交给RecyclerView处理
        return super.onInterceptTouchEvent(ev);
    }
}

使用自定义ScrollView的步骤： #

1. 在布局文件中替换原生ScrollView为ParentScrollView：

<com.yourpackage.ParentScrollView
    android:id="@+id/parent_scroll_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <!-- 其他布局元素 -->
    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/recycler_view"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"/>

</com.yourpackage.ParentScrollView>

2. 在代码中绑定RecyclerView：

ParentScrollView scrollView = findViewById(R.id.parent_scroll_view);
RecyclerView recyclerView = findViewById(R.id.recycler_view);
scrollView.setTargetRecyclerView(recyclerView);

关键注意事项 #

• RecyclerView高度设置：必须将RecyclerView的layout_height设为wrap_content，否则ScrollView无法正确计算滚动范围。
• 布局管理器：确保RecyclerView使用的是垂直方向的布局管理器（如LinearLayoutManager），水平布局需调整滚动方向的判断逻辑。
• 边界测试：测试快速滑动、滚动到边界等场景，确保事件传递逻辑稳定。

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