RecyclerView滚动状态回调延迟及ExpandTabLayout视图异常求助

问题背景 #

我遇到了两个和RecyclerView滚动联动相关的棘手问题：

1. 滚动状态切换延迟：当RecyclerView滑动到顶部时，onScrollStateChanged回调中代表SCROLL_STATE_IDLE（状态0）的日志会延迟数秒才出现，日志顺序如下：

[onScrollStateChanged() line:412] -------newState------->1
[onScrollStateChanged() line:412] -------newState------->2
[onScrollStateChanged() line:412] -------newState------->0

2. 视图错乱问题：布局中CollapsingToolbarLayout与AppBarLayout之间有一个自定义的com.xxx.ExpandTabLayout，它具备点击弹出PopupWindow的交互。当滚动状态newState为2（SCROLL_STATE_SETTLING）时，页面视觉上已经静止但状态未及时切换为0，导致点击弹出PopupWindow时出现视图排版错乱。

附相关代码：

• XML布局截图：
  
• RecyclerView滚动监听代码：

RecyclerView.addOnScrollListener(new RecyclerView.OnScrollListener() {
    @Override
    public void onScrollStateChanged(RecyclerView recyclerView, int newState) {
        super.onScrollStateChanged(recyclerView, newState);
        Log.d("-------newState-------" + newState);
    }
});

原因分析 #

这两个问题的核心诱因是AppBarLayout与RecyclerView的滚动联动导致状态判断延迟：

• 当RecyclerView滑动到顶部后，AppBarLayout可能还在执行弹性滚动、折叠/展开的收尾动画，这会让RecyclerView的滚动状态被强制维持在SCROLL_STATE_SETTLING（状态2），直到AppBar的动画完全结束才会切换到SCROLL_STATE_IDLE（状态0）。
• 自定义ExpandTabLayout处于AppBar相关布局层级中，滚动状态未正确切换时，布局的测量或绘制流程可能仍在后台运行，此时触发PopupWindow弹出操作，就容易出现视图错乱。

具体解决办法 #

1. 优化滚动状态判断，主动检测页面真实静止状态

不要单纯依赖onScrollStateChanged的回调状态，结合RecyclerView滚动位置和AppBarLayout的状态综合判断：

// 先获取AppBarLayout实例
AppBarLayout appBarLayout = findViewById(R.id.app_bar_layout);

RecyclerView.addOnScrollListener(new RecyclerView.OnScrollListener() {
    @Override
    public void onScrollStateChanged(RecyclerView recyclerView, int newState) {
        super.onScrollStateChanged(recyclerView, newState);
        
        // 当状态为SETTLING时，主动检测是否真的静止
        if (newState == RecyclerView.SCROLL_STATE_SETTLING) {
            recyclerView.postDelayed(() -> {
                LinearLayoutManager layoutManager = (LinearLayoutManager) recyclerView.getLayoutManager();
                // 检查RecyclerView是否停止滚动，且AppBar处于顶部/底部静止状态
                boolean isRecyclerViewIdle = !recyclerView.isScrolling();
                boolean isAppBarIdle = appBarLayout.getTotalScrollRange() == appBarLayout.getScrollY() 
                                       || appBarLayout.getScrollY() == 0;
                
                if (isRecyclerViewIdle && isAppBarIdle) {
                    // 手动触发IDLE状态的业务逻辑
                    handlePageIdle();
                }
            }, 100); // 延迟100ms检测，规避动画未收尾的情况
        } else if (newState == RecyclerView.SCROLL_STATE_IDLE) {
            handlePageIdle();
        }
        
        Log.d("-------newState-------" + newState);
    }
});

// 统一处理页面静止后的逻辑
private void handlePageIdle() {
    // 这里编写原本需要在SCROLL_STATE_IDLE时执行的代码
    // 比如标记页面已静止，允许ExpandTabLayout的PopupWindow正常弹出
}

2. 调整ExpandTabLayout的点击交互逻辑

在点击ExpandTabLayout时，先校验页面是否处于真正的静止状态，再执行PopupWindow弹出操作：

expandTabLayout.setOnClickListener(v -> {
    boolean isRecyclerViewIdle = !recyclerView.isScrolling();
    boolean isAppBarIdle = appBarLayout.getTotalScrollRange() == appBarLayout.getScrollY() 
                           || appBarLayout.getScrollY() == 0;
    
    if (isRecyclerViewIdle && isAppBarIdle) {
        // 页面静止时正常弹出PopupWindow
        showCustomPopupWindow();
    } else {
        // 页面仍在滚动/动画中，延迟后再弹出
        recyclerView.postDelayed(this::showCustomPopupWindow, 200);
    }
});

3. 优化AppBarLayout滚动行为（可选）

如果AppBarLayout的弹性滚动是延迟的主要原因，可以调整其滚动标志位或自定义Behavior来减少不必要的动画：

<AppBarLayout
    android:id="@+id/app_bar_layout"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:layout_scrollFlags="scroll|exitUntilCollapsed">
    <!-- 嵌套的CollapsingToolbarLayout及其他布局 -->
</AppBarLayout>

若不需要弹性效果，可通过自定义Behavior关闭拖动弹性：

appBarLayout.addOnOffsetChangedListener((appBar, verticalOffset) -> {
    // 滚动到顶部或底部时，禁用AppBar的拖动弹性
    if (verticalOffset == 0 || verticalOffset == -appBar.getTotalScrollRange()) {
        AppBarLayout.Behavior behavior = (AppBarLayout.Behavior) ((CoordinatorLayout.LayoutParams) appBar.getLayoutParams()).getBehavior();
        if (behavior != null) {
            behavior.setDragCallback(new AppBarLayout.Behavior.DragCallback() {
                @Override
                public boolean canDrag(AppBarLayout appBarLayout) {
                    return false; // 禁止AppBar拖动，按需开启
                }
            });
        }
    }
});

总结 #

核心思路是不单纯依赖RecyclerView的滚动状态回调，结合AppBarLayout的滚动状态综合判断页面是否真正静止，同时在交互触发前做状态校验，避免在布局未稳定时执行视图变更操作。

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