如何让RecyclerView滚动条显示在ItemDecoration粘性头部之上？

针对你用RecyclerView.ItemDecoration实现粘性头部时遇到的滚动条被覆盖问题，这里提供几个可行的解决方案：

方案1：自定义RecyclerView调整滚动条绘制顺序 #

核心思路是让滚动条在粘性头部绘制完成后再绘制，这样滚动条就能显示在头部上层。通过重写RecyclerView的draw()方法，先完成原有内容（包括粘性头部）的绘制，再手动触发滚动条的绘制：

class StickyHeaderRecyclerView(context: Context, attrs: AttributeSet?) : RecyclerView(context, attrs) {
    override fun draw(canvas: Canvas) {
        // 先绘制所有默认内容（Item、粘性头部等）
        super.draw(canvas)
        // 手动绘制垂直/水平滚动条，确保在头部之上
        verticalScrollbar?.takeIf { it.isVisible }?.draw(canvas)
        horizontalScrollbar?.takeIf { it.isVisible }?.draw(canvas)
    }
}

这个方案完全保留原有滚动条的样式和行为，只是调整了绘制顺序，兼容性最好。

方案2：绘制粘性头部时预留滚动条空间 #

如果滚动条位置固定（比如右侧垂直滚动条），可以在绘制头部时主动避开滚动条区域，避免覆盖：

override fun onDrawOver(canvas: Canvas, parent: RecyclerView, state: State) {
    super.onDrawOver(canvas, parent, state)
    
    // 获取垂直滚动条的宽度
    val scrollbarWidth = parent.verticalScrollbarWidth
    // 计算头部绘制区域，右侧留出滚动条的宽度
    val headerRight = parent.width - if (parent.isVerticalScrollBarEnabled) scrollbarWidth else 0
    val headerRect = Rect(0, 0, headerRight, YOUR_HEADER_HEIGHT)
    
    // 按计算后的区域绘制粘性头部
    // ... 你的头部绘制逻辑
}

这个方案实现简单，但会压缩头部的显示宽度，适合对布局紧凑性要求不高的场景。

方案3：换一种粘性头部实现方式 #

如果上述方案都不满足需求，可以放弃ItemDecoration.onDrawOver，改用以下方式：

• 用ConcatAdapter将头部Adapter和内容Adapter组合，给RecyclerView添加固定头部；
• 监听RecyclerView的滚动事件，当头部即将被推出屏幕时，在RecyclerView的父布局中显示一个完全相同的悬浮头部View；
• 滚动到顶部时隐藏悬浮View。

这种方式下，滚动条作为RecyclerView的原生控件，会自然显示在内容上层，只要调整悬浮View的布局范围不覆盖滚动条区域即可。

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