Τι είναι το ItemDecoration και πώς χρησιμοποιείται…

Το ItemDecoration χρησιμοποιείται για την απόδοση διακοσμήσεων γύρω από μεμονωμένα στοιχεία του RecyclerView ή πάνω από ολόκληρο τον καμβά του RecyclerView.

Βασικές λειτουργίες:

Σχεδίαση διαχωριστικών μεταξύ στοιχείων (γραμμές, περιθώρια).
Σχεδίαση φόντων ή πλαισίων για τα στοιχεία.
Προσθήκη περιθωρίων (padding) γύρω από τα στοιχεία χωρίς να αλλάζει τις παραμέτρους διάταξης του ίδιου του στοιχείου.

Πώς να το χρησιμοποιήσετε:

Δημιουργήστε μια κλάση που κληρονομεί από το RecyclerView.ItemDecoration.
Υπερκαλύψτε τις απαραίτητες μεθόδους:
- onDraw(Canvas c, RecyclerView parent, RecyclerView.State state): για σχεδίαση διακοσμήσεων κάτω από τα στοιχεία.
- onDrawOver(Canvas c, RecyclerView parent, RecyclerView.State state): για σχεδίαση διακοσμήσεων πάνω από τα στοιχεία.
- getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state): για προσθήκη περιθωρίων στα όρια του στοιχείου.
Δημιουργήστε ένα αντικείμενο της κλάσης ItemDecoration.
Προσθέστε το στο RecyclerView χρησιμοποιώντας addItemDecoration(ItemDecoration decoration).

Παράδειγμα χρήσης του getItemOffsets για προσθήκη περιθωρίου:

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 // Περιθώριο πάνω μόνο για το πρώτο στοιχείο
            }
            left =  spaceHeight
            right = spaceHeight
            bottom = spaceHeight
        }
    }
}

// Στον κώδικα όπου διαμορφώνεται το RecyclerView:
// val recyclerView = findViewById<RecyclerView>(R.id.my_recycler_view)
// recyclerView.addItemDecoration(SpaceItemDecoration(resources.getDimensionPixelSize(R.dimen.item_space)))

Παράδειγμα χρήσης του onDraw για σχεδίαση διαχωριστικού:

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) { // μέχρι τον προτελευταίο στοιχείο
            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) {
        // Προσθέστε χώρο για τον διαχωριστικό, εκτός αν είναι το τελευταίο στοιχείο
        if (parent.getChildAdapterPosition(view) != parent.adapter?.itemCount?.minus(1)) {
            outRect.bottom = dividerHeight
        }
    }
}

// Στον κώδικα όπου διαμορφώνεται το RecyclerView:
// 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)))

Είναι σημαντικό να κατανοήσετε ότι το ItemDecoration δεν αλλάζει τα μεγέθη ή τη θέση των ίδιων των στοιχείων, αλλά επηρεάζει μόνο την απόδοση και τα περιθώρια γύρω από αυτά.

Τι είναι το ItemDecoration και πώς χρησιμοποιείται στο Android;