O que é ItemDecoration e como usá-lo no Android…

ItemDecoration é usado para desenhar decorações ao redor de elementos individuais do RecyclerView ou sobre toda a tela do RecyclerView.

Funções principais:

Desenhar separadores entre elementos (linhas, margens).
Desenhar fundos ou molduras para os elementos.
Adicionar margens (padding) ao redor dos elementos sem alterar os parâmetros de layout do próprio elemento.

Como usar:

Criar uma classe que herde de RecyclerView.ItemDecoration.
Sobrescrever os métodos necessários:
- onDraw(Canvas c, RecyclerView parent, RecyclerView.State state) para desenhar decorações embaixo dos elementos.
- onDrawOver(Canvas c, RecyclerView parent, RecyclerView.State state) para desenhar decorações sobre os elementos.
- getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state) para adicionar margens às bordas do elemento.
Criar uma instância da classe ItemDecoration.
Adicioná-la ao RecyclerView usando addItemDecoration(ItemDecoration decoration).

Exemplo de uso de getItemOffsets para adicionar margem:

class SpaceItemDecoration(private val spaceHeight: Int) : RecyclerView.ItemDecoration() {
    override fun getItemOffsets(outRect: Rect, view: View, parent: RecyclerView, state: RecyclerView.State) {
        with(outRect) {
            if (parent.getChildAdapterPosition(view) == 0) {
                top = spaceHeight // Margem superior apenas para o primeiro elemento
            }
            left =  spaceHeight
            right = spaceHeight
            bottom = spaceHeight
        }
    }
}

// No código onde o RecyclerView é configurado:
// val recyclerView = findViewById<RecyclerView>(R.id.my_recycler_view)
// recyclerView.addItemDecoration(SpaceItemDecoration(resources.getDimensionPixelSize(R.dimen.item_space)))

Exemplo de uso de onDraw para desenhar um separador:

class DividerItemDecoration(private val dividerHeight: Int, private val dividerColor: Int) : RecyclerView.ItemDecoration() {
    private val paint = Paint().apply {
        color = dividerColor
        style = Paint.Style.FILL
    }

    override fun onDraw(canvas: Canvas, parent: RecyclerView, state: RecyclerView.State) {
        val left = parent.paddingLeft
        val right = parent.width - parent.paddingRight

        for (i in 0 until parent.childCount - 1) { // Iterar até o penúltimo elemento
            val child = parent.getChildAt(i)
            val top = child.bottom
            val bottom = top + dividerHeight
            canvas.drawRect(left.toFloat(), top.toFloat(), right.toFloat(), bottom.toFloat(), paint)
        }
    }

    override fun getItemOffsets(outRect: Rect, view: View, parent: RecyclerView, state: RecyclerView.State) {
        // Adicionar espaço para o separador se não for o último elemento
        if (parent.getChildAdapterPosition(view) != parent.adapter?.itemCount?.minus(1)) {
            outRect.bottom = dividerHeight
        }
    }
}

// No código onde o RecyclerView é configurado:
// val recyclerView = findViewById<RecyclerView>(R.id.my_recycler_view)
// recyclerView.addItemDecoration(DividerItemDecoration(resources.getDimensionPixelSize(R.dimen.divider_height), ContextCompat.getColor(this, R.color.divider_color)))

É importante entender que ItemDecoration não altera os tamanhos ou a disposição dos próprios elementos, apenas influencia na renderização e nos margens ao redor deles.

O que é ItemDecoration e como usá-lo no Android?