如何确定RecyclerView的fast scroller滑块的显示时机？

核心原因说明 #

你在onLayout/onSizeChanged阶段拿不到有效值，是因为RecyclerView的Adapter数据提交、子View测量布局是异步执行的，这两个回调触发时RecyclerView还没完成内容测量，所以computeVerticalScrollRange()和itemCount都返回0。

自定义FastScroller内部实现逻辑 #

所有逻辑完全封装在你的自定义快滚View内部，无需宿主页面参与：

步骤1：绑定RecyclerView时注册监听 #

在你的自定义快滚View提供的绑定RecyclerView的公共方法（比如attachToRecyclerView(RecyclerView rv)）内，注册三类监听即可：

• RecyclerView.AdapterDataObserver：监听Adapter数据更新
• OnLayoutChangeListener：监听RecyclerView布局变化
• 可选：OnScrollChangeListener：监听滚动状态实时更新快滚显隐

步骤2：封装可滚动状态判断方法 #

先写私有方法统一判断是否可滚动：

private fun isRecyclerViewScrollable(): Boolean {
    val recyclerView = this.attachedRecyclerView ?: return false
    val layoutManager = recyclerView.layoutManager ?: return false
    if (recyclerView.adapter == null || recyclerView.adapter!!.itemCount == 0) {
        return false
    }
    // 计算垂直滚动范围和可见范围的差值
    val scrollRange = recyclerView.computeVerticalScrollRange()
    val scrollExtent = recyclerView.computeVerticalScrollExtent()
    return scrollRange > scrollExtent
}

注意：该方法只有在RecyclerView完成首次布局后调用才能拿到有效值

步骤3：延迟触发判断，避免初始化时值为空 #

不要在onLayout/onSizeChanged里直接调用判断，而是通过以下方式延迟到布局完成后执行：

1. 在Adapter数据更新的回调里post到主线程消息队列尾部，等待布局完成后再判断：

private val dataObserver = object : RecyclerView.AdapterDataObserver() {
    override fun onChanged() {
        super.onChanged()
        updateFastScrollerVisibility()
    }

    override fun onItemRangeInserted(positionStart: Int, itemCount: Int) {
        super.onItemRangeInserted(positionStart, itemCount)
        updateFastScrollerVisibility()
    }

    // 可按需实现数据删除、移动等其他变更回调
}

private fun updateFastScrollerVisibility() {
    attachedRecyclerView?.post {
        val isScrollable = isRecyclerViewScrollable()
        visibility = if (isScrollable) View.VISIBLE else View.GONE
    }
}

2. 同时注册布局变化监听兜底，覆盖首次绑定时数据已加载完成的场景：

private val layoutChangeListener = View.OnLayoutChangeListener { _, _, _, _, _, _, _, _, _ ->
    updateFastScrollerVisibility()
}

步骤4：资源释放 #

在自定义FastScroller的onDetachedFromWindow回调里主动移除所有监听，避免内存泄漏：

override fun onDetachedFromWindow() {
    super.onDetachedFromWindow()
    attachedRecyclerView?.let { rv ->
        rv.adapter?.unregisterAdapterDataObserver(dataObserver)
        rv.removeOnLayoutChangeListener(layoutChangeListener)
    }
    attachedRecyclerView = null
}

兼容场景 #

• 支持Adapter动态更新数据后自动重新判断显隐
• 支持LayoutManager动态切换（切换后会触发布局变化回调自动重新判断）
• 无需宿主Activity/Fragment添加任何额外代码

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