API 21兼容：NestedScrollView内RecyclerView滚动事件处理方案

嘿，这个问题我之前做低版本兼容的时候也踩过坑，API 21确实不支持NestedScrollView.setOnScrollChangeListener()，不过有几个稳定的适配方案，给你详细说说：

方案一：利用ViewTreeObserver监听滚动（API 1+全兼容） #

ViewTreeObserver.OnScrollChangedListener是从API 1就存在的接口，能完美适配低版本，核心是监听View树的滚动变化：

// 获取NestedScrollView的ViewTreeObserver
ViewTreeObserver scrollObserver = yourNestedScrollView.getViewTreeObserver();
scrollObserver.addOnScrollChangedListener(new ViewTreeObserver.OnScrollChangedListener() {
    @Override
    public void onScrollChanged() {
        // 获取当前滚动的Y轴偏移量
        int currentScrollY = yourNestedScrollView.getScrollY();
        // 在这里处理你的滚动逻辑，比如判断是否滚动到顶部/底部
        if (currentScrollY == 0) {
            Log.d("Scroll", "已滚动到顶部");
        } else if (currentScrollY + yourNestedScrollView.getHeight() >= yourNestedScrollView.getChildAt(0).getHeight()) {
            Log.d("Scroll", "已滚动到底部");
        }
    }
});

// 重要：在页面销毁时移除监听，避免内存泄漏
@Override
protected void onDestroy() {
    super.onDestroy();
    ViewTreeObserver observer = yourNestedScrollView.getViewTreeObserver();
    if (observer.isAlive()) {
        observer.removeOnScrollChangedListener(this);
    }
}

方案二：自定义NestedScrollView重写onScrollChanged（API 1+全兼容） #

如果需要更灵活的监听逻辑，可以自定义NestedScrollView，重写系统自带的onScrollChanged方法，对外暴露自定义监听接口：

1. 自定义NestedScrollView类 #

public class CompatibleNestedScrollView extends NestedScrollView {
    private OnScrollChangeListener mScrollListener;

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

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

    public CompatibleNestedScrollView(Context context, AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
    }

    @Override
    protected void onScrollChanged(int l, int t, int oldl, int oldt) {
        super.onScrollChanged(l, t, oldl, oldt);
        // 滚动变化时回调自定义监听
        if (mScrollListener != null) {
            mScrollListener.onScrollChanged(this, l, t, oldl, oldt);
        }
    }

    // 对外设置监听的方法
    public void setOnScrollChangeListener(OnScrollChangeListener listener) {
        mScrollListener = listener;
    }

    // 自定义监听接口
    public interface OnScrollChangeListener {
        void onScrollChanged(NestedScrollView scrollView, int scrollX, int scrollY, int oldScrollX, int oldScrollY);
    }
}

2. 在布局中使用自定义View #

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

    <!-- 内部包含RecyclerView等子View -->
    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/recycler_view"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"/>

</com.yourpackage.CompatibleNestedScrollView>

3. 设置监听 #

CompatibleNestedScrollView scrollView = findViewById(R.id.nested_scroll_view);
scrollView.setOnScrollChangeListener(new CompatibleNestedScrollView.OnScrollChangeListener() {
    @Override
    public void onScrollChanged(NestedScrollView scrollView, int scrollX, int scrollY, int oldScrollX, int oldScrollY) {
        // 处理滚动逻辑，比如对比新旧滚动值判断滚动方向
        boolean isScrollingDown = scrollY > oldScrollY;
        Log.d("Scroll", "滚动方向：" + (isScrollingDown ? "向下" : "向上"));
    }
});

方案三：监听RecyclerView自身的滚动（API 21+兼容） #

如果你的核心需求是监听RecyclerView内部的列表滚动（而非NestedScrollView的整体滚动），可以直接给RecyclerView设置OnScrollListener，但需要先开启嵌套滚动支持：

RecyclerView recyclerView = findViewById(R.id.recycler_view);
// 开启嵌套滚动（API 21支持），让RecyclerView和NestedScrollView协同处理滚动
recyclerView.setNestedScrollingEnabled(true);

// 设置RecyclerView滚动监听
recyclerView.addOnScrollListener(new RecyclerView.OnScrollListener() {
    @Override
    public void onScrolled(@NonNull RecyclerView recyclerView, int dx, int dy) {
        super.onScrolled(recyclerView, dx, dy);
        // 获取列表滚动状态，比如第一个可见项位置
        LinearLayoutManager layoutManager = (LinearLayoutManager) recyclerView.getLayoutManager();
        int firstVisiblePos = layoutManager.findFirstVisibleItemPosition();
        Log.d("RecyclerView", "第一个可见项位置：" + firstVisiblePos);
    }

    @Override
    public void onScrollStateChanged(@NonNull RecyclerView recyclerView, int newState) {
        super.onScrollStateChanged(recyclerView, newState);
        // 处理滚动状态变化：停止滚动、正在滚动、拖拽中
        if (newState == RecyclerView.SCROLL_STATE_IDLE) {
            Log.d("RecyclerView", "滚动已停止");
        }
    }
});

选择建议 #

• 若需监听NestedScrollView的整体滚动：优先选方案二（自定义View），代码更清晰易维护；
• 若快速实现兼容：方案一（ViewTreeObserver）更简单；
• 若核心关注RecyclerView内部滚动：方案三最直接。

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