onLayout(): визначення, алгоритм розташування та параметри методу

Що таке onLayout()?

onLayout(boolean changed, int l, int t, int r, int b) — це protected метод класу ViewGroup, який викликається системою для позиціонування дочірніх View всередині батьківського контейнера. Розробник перевизначає цей метод, коли створює кастомну ViewGroup з нестандартним розташуванням елементів: каскадом, сіткою, у шаховому порядку або за довільними координатами. Кожен дочірній View отримує свої фінальні межі через виклик child.layout().

Параметр changed вказує, чи змінилася позиція або розмір самої ViewGroup з моменту останнього layout. Якщо changed дорівнює true, усі дочірні елементи, ймовірно, також потребують перепозиціонування. Параметри l, t, r, b — це координати верхнього лівого та нижнього правого кутів ViewGroup у системі координат її батька. Всередині onLayout розробник використовує ці значення як початкові координати для розташування дітей.

ViewGroup — це єдиний клас, який перевизначає onLayout. Звичайний View (не ViewGroup) не має дочірніх елементів і не потребує onLayout — його власне позиціонування обробляється батьківським контейнером. Навіть якщо звичайний View перевизначить onLayout, система не буде його викликати. Це фундаментальна відмінність onLayout від onMeasure, який викликається для будь-якого View.

Потік виконання фази layout

Фаза layout починається з виклику публічного методу layout(int l, int t, int r, int b) на кореневому View. Цей метод встановлює фінальні координати самого View та викликає onLayout, якщо View є ViewGroup. Далі onLayout рекурсивно викликає child.layout() для кожного дочірнього елемента, і процес повторюється вниз по ієрархії. Таким чином, layout поширюється від кореня до листків.

Перед викликом onLayout система перевіряє, чи змінилися розміри View порівняно з попереднім циклом. Якщо розміри не змінилися і не був викликаний requestLayout, onLayout може не викликатися — система використовує результати попереднього layout. Це оптимізація, що запобігає зайвим перерахункам позицій при анімаціях або скролінгу, коли змінюється лише вміст, а не розміри.

requestLayout() — це метод View, який повідомляє системі, що layout View застарів і потребує перерахунку. Виклик requestLayout призводить до повного циклу: спочатку викликається onMeasure, потім onLayout, потім onDraw. На відміну від invalidate, який запускає лише перемальовування, requestLayout запускає повний перерахунок розмірів і позицій. Надмірний виклик requestLayout — поширена причина проблем з продуктивністю.

Параметри onLayout: l, t, r, b

l (left) — X-координата лівого краю ViewGroup у системі координат її батька. t (top) — Y-координата верхнього краю. r (right) — X-координата правого краю. b (bottom) — Y-координата нижнього краю. Ширина ViewGroup обчислюється як r - l, висота — як b - t. Ці координати вже включають усі відступи (padding) самої ViewGroup.

Всередині onLayout розробник викликає child.layout(int childLeft, int childTop, int childRight, int childBottom) для кожного дочірнього View. Координати, що передаються в child.layout, повинні бути в системі координат батьківської ViewGroup. Зазвичай childLeft та childTop розраховуються з урахуванням padding'ів батька: childLeft = l + paddingLeft + offsetX, childTop = t + paddingTop + offsetY.

Розрахунок координат для дочірніх елементів

Дочірні координати розраховуються за формулою: childLeft = l + paddingLeft + (marginLeft якщо присутній), childRight = childLeft + child.getMeasuredWidth(). Аналогічно для вертикалі: childTop = t + paddingTop + (marginTop), childBottom = childTop + child.getMeasuredHeight(). Після обчислення цих чотирьох значень викликається child.layout(childLeft, childTop, childRight, childBottom).

Приклад кастомної ViewGroup з onLayout на Kotlin

Створимо FlowLayout — кастомну ViewGroup, яка розташовує дочірні View рядками, переносячи елементи на новий рядок, коли поточний рядок заповнений. Це аналог Flexbox з wrap в одній площині. onLayout перебирає всі дочірні View, обчислює позицію для кожного та викликає child.layout() з коректними межами.

class FlowLayout(context: Context)
    : ViewGroup(context) {

    private val horizontalSpacing = 12
    private val verticalSpacing = 8

    override fun onMeasure(widthMeasureSpec: Int,
                       heightMeasureSpec: Int) {
        val parentWidth =
            MeasureSpec.getSize(widthMeasureSpec)
        var rowX = paddingLeft
        var rowY = paddingTop
        var maxRowHeight = 0

        for (i in 0 until childCount) {
            val child = getChildAt(i)
            measureChildWithMargins(child,
                widthMeasureSpec, 0,
                heightMeasureSpec, 0)

            if (rowX + child.measuredWidth >
                parentWidth - paddingRight) {
                rowX = paddingLeft
                rowY += maxRowHeight + verticalSpacing
                maxRowHeight = 0
            }

            rowX += child.measuredWidth +
                horizontalSpacing
            maxRowHeight = maxOf(maxRowHeight,
                child.measuredHeight)
        }

        val totalHeight = rowY + maxRowHeight +
            paddingBottom
        setMeasuredDimension(
            resolveSize(parentWidth, widthMeasureSpec),
            resolveSize(totalHeight, heightMeasureSpec))
    }

    override fun onLayout(changed: Boolean,
                       l: Int, t: Int,
                       r: Int, b: Int) {
        val parentWidth = r - l
        var rowX = paddingLeft
        var rowY = paddingTop
        var maxRowHeight = 0

        for (i in 0 until childCount) {
            val child = getChildAt(i)
            val cw = child.measuredWidth
            val ch = child.measuredHeight

            if (rowX + cw >
                parentWidth - paddingRight) {
                rowX = paddingLeft
                rowY += maxRowHeight + verticalSpacing
                maxRowHeight = 0
            }

            child.layout(rowX, rowY,
                rowX + cw, rowY + ch)
            rowX += cw + horizontalSpacing
            maxRowHeight =
                maxOf(maxRowHeight, ch)
        }
    }

    override fun generateLayoutParams(attrs: AttributeSet?)
        : LayoutParams =
        MarginLayoutParams(context, attrs)
}

Відмінності onLayout від onMeasure

onMeasure та onLayout — дві послідовні фази життєвого циклу View, які виконують принципово різні завдання. onMeasure визначає бажані (виміряні) розміри View, тоді як onLayout встановлює фактичні (фінальні) координати та розміри. Ключова відмінність: в onMeasure розміри можуть бути проміжними та пізніше скоригованими батьком, а в onLayout фіксується остаточне положення кожного дочірнього View.

onMeasure викликається для кожного View, включаючи листові (TextView, ImageView, Button). onLayout викликається лише для ViewGroup. Це пояснюється тим, що позиціонування — відповідальність батьківського контейнера, а не самого View. Листовий View отримує свою позицію через layout(), викликаний із батьківського onLayout.

getMeasuredWidth() та getMeasuredHeight() доступні після onMeasure, а getWidth() та getHeight() — лише після onLayout. Якщо звернутися до getWidth() всередині onMeasure, буде повернено значення попереднього циклу або нуль. Тому для розрахунку розмірів в onMeasure слід використовувати MeasureSpec та дітей послідовно.

Типові помилки при роботі з onLayout

Позиціонування без урахування padding — перша помилка при реалізації onLayout. Розробник часто забуває додати paddingLeft та paddingTop батька до початкових координат дочірніх View. В результаті діти відображаються з краю ViewGroup, ігноруючи відступи, встановлені через setPadding() або в XML-розмітці. Коректний розрахунок: childLeft = paddingLeft + offsetX.

Виклик layout для невидимих дітей — друга поширена проблема. Якщо ViewGroup містить дочірні View з visibility рівним GONE, їх не потрібно позиціонувати — вони не займають місця. Однак onLayout повинен коректно обробляти цей випадок, пропускаючи GONE-дітей. Для INVISIBLE дітей layout все одно потрібно викликати — вони зберігають своє місце, хоча не відображаються.

Ігнорування параметра changed — третя помилка. Параметр changed вказує, чи змінилися розміри або положення ViewGroup. Якщо changed == false, можна використовувати кешовані координати та не перераховувати layout усіх дочірніх елементів. Однак повне кешування layout — складне завдання, і в більшості реалізацій onLayout просто перераховує всі елементи щоразу. Це допустимо при невеликій кількості дітей.