Android：如何设置RecyclerView.ItemDecoration的层级（Z-index）

嘿，这个问题我之前帮不少开发者处理过——其实RecyclerView的ItemDecoration本身并没有直接暴露elevation属性来控制层级，但我们有两种核心方法可以实现你要的效果：

1. 利用添加顺序控制（最简单直接） #

RecyclerView对ItemDecoration的绘制顺序是严格按照你添加它们的顺序来的：

• 先调用addItemDecoration()添加的Decoration会先被绘制，也就是处于底层
• 后添加的Decoration会覆盖在之前的上面，处于上层

举个直观的例子：

// 先加的DecorationA会在最底层
recyclerView.addItemDecoration(DecorationA())
// 后加的DecorationB会叠在DecorationA上面
recyclerView.addItemDecoration(DecorationB())

要是想让DecorationA跑到上面，直接调换一下添加顺序就搞定了。

2. 自定义Decoration时通过Canvas精细控制（更灵活） #

如果因为业务限制不能调整添加顺序，或者需要更精细的层级区分，我们可以在自定义ItemDecoration的绘制方法里动手脚：

方式一：用Canvas的图层Z值控制 #

在onDraw()方法中，我们可以通过saveLayer()创建图层，并给不同图层设置不同的Z值——数值越大，图层越靠上：

class ElevatedDecoration(private val zLevel: Float) : RecyclerView.ItemDecoration() {
    override fun onDraw(c: Canvas, parent: RecyclerView, state: RecyclerView.State) {
        // 创建一个新图层，并记录图层ID
        val layerId = c.saveLayer(0f, 0f, c.width.toFloat(), c.height.toFloat(), null, Canvas.ALL_SAVE_FLAG)
        // 设置当前图层的Z轴高度
        c.setZ(zLevel)
        
        // 在这里绘制你的Decoration内容，比如分割线、侧边标记等
        // 示例：画个红色顶部分割线
        val paint = Paint().apply { color = Color.RED }
        c.drawRect(0f, 0f, parent.width.toFloat(), 10f, paint)
        
        // 恢复到之前的图层状态
        c.restoreToCount(layerId)
    }
}

使用时给不同Decoration设置不同的Z值就行：

// Z值5的Decoration会在Z值2的上面
recyclerView.addItemDecoration(ElevatedDecoration(2f))
recyclerView.addItemDecoration(ElevatedDecoration(5f))

方式二：利用onDraw()和onDrawOver()的差异 #

RecyclerView的ItemDecoration有两个关键绘制方法：

• onDraw()：在ItemView绘制之前执行，所以这里画的内容会被ItemView盖住，处于ItemView下方
• onDrawOver()：在ItemView绘制之后执行，这里画的内容会盖在ItemView上面

如果你的两个Decoration一个需要在ItemView上方，一个在下方，分别重写这两个方法就能轻松区分层级。

额外注意 #

• 要是多个Decoration都重写了onDrawOver()，它们的绘制顺序还是遵循添加顺序，后加的在上
• onDrawOver()的内容永远会比onDraw()的内容靠上，不管添加顺序如何

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