What is ItemDecoration and how is it used in Android?

ItemDecoration is used for drawing decorations around individual RecyclerView items or over the entire RecyclerView canvas.

Main functions:

• Draw separators between items (lines, margins).
• Draw backgrounds or borders for items.
• Add padding around items without changing the layout parameters of the item itself.

How to use:

1. Create a class inheriting from RecyclerView.ItemDecoration.
2. Override necessary methods:
   • onDraw(Canvas c, RecyclerView parent, RecyclerView.State state): for drawing decorations under the items.
   • onDrawOver(Canvas c, RecyclerView parent, RecyclerView.State state): for drawing decorations over the items.
   • getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state): for adding offsets to the item's boundaries.
3. Create an instance of the ItemDecoration class.
4. Add it to the RecyclerView using addItemDecoration(ItemDecoration decoration).

Example of using getItemOffsets to add spacing:

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 // Top margin only for the first item
            }
            left =  spaceHeight
            right = spaceHeight
            bottom = spaceHeight
        }
    }
}

// In the code where RecyclerView is configured:
// val recyclerView = findViewById<RecyclerView>(R.id.my_recycler_view)
// recyclerView.addItemDecoration(SpaceItemDecoration(resources.getDimensionPixelSize(R.dimen.item_space)))

Example of using onDraw to draw a separator:

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) { // Iterate up to the second last item
            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) {
        // Add space for the separator if not the last item
        if (parent.getChildAdapterPosition(view) != parent.adapter?.itemCount?.minus(1)) {
            outRect.bottom = dividerHeight
        }
    }
}

// In the code where RecyclerView is configured:
// 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)))

It is important to understand that ItemDecoration does not change the size or position of the items themselves, but only affects their drawing and spacing around them.