Данфа

Modifier в Jetpack Compose: Разбор параметров и порядок применения

В Compose у каждого компонента есть параметр modifier — это объект, который описывает, как элемент должен выглядеть, вести себя и взаимодействовать с окружением. Важно понимать: Modifier — это не один параметр, а цепочка функций-модификаторов, которые применяются по очереди. Сам класс не хранит «кучу параметров» в привычном смысле — вместо этого каждый модификатор оборачивает предыдущий, образуя цепочку. Именно поэтому порядок имеет значение, и к нему мы вернёмся в конце.

Размеры


  • width(), height(), size() — задают фиксированную ширину, высоту или оба размера сразу: Modifier.size(100.dp).
  • widthIn(min, max), heightIn(), sizeIn() — задают диапазон допустимых размеров. Полезно, когда размер контента заранее неизвестен.
  • fillMaxWidth(), fillMaxHeight(), fillMaxSize() — растягивают элемент на всю доступную ширину, высоту или обе оси. Внутри необязательный параметр fraction — какую долю пространства занять: fillMaxWidth(0.5f).
  • requiredWidth(), requiredHeight(), requiredSize() — как обычные, но принудительно: элемент получит указанный размер даже если родитель не даёт столько места (содержимое может обрезаться).
  • sizeWithLimits такого нет — вместо него работают комбинации sizeIn.
  • aspectRatio() — задаёт соотношение сторон: Modifier.aspectRatio(16f/9f) сделает элемент прямоугольным в пропорции 16:9, подстраивая недостающую сторону под известную.
  • weight() — работает только внутри Row и Column: делит оставшееся место между «тяжёлыми» детьми пропорционально весам.
  • matchParentSize() — доступен только внутри области BoxScope: элемент займёт размер самого большого ребёнка бокса.
  • defaultMinSize() — минимальный размер, если контента меньше, чем минимальное значение.


Отступы


  • padding(all), padding(start, top, end, bottom), padding(horizontal, vertical) — внешние и внутренние отступы. Точнее — просто отступы вокруг контента; будут ли они «внешними» или «внутренними», зависит от порядка в цепочке (об этом ниже).
  • absolutePadding() — то же самое, но с фиксированными значениями LTR/RTL: не переворачивается в языках с письмом справа налево.
  • paddingFromBaseline() — отступы, отсчитываемые от базовых линий текста, а не от границ контейнера. Незаменим, когда нужно ровно выровнять подписи и заголовки.
  • windowInsetsPadding(), statusBarsPadding(), navigationBarsPadding(), imePadding(), safeDrawingPadding() — семейство модификаторов для отступов от системных областей: статус-бара, навигационной панели и клавиатуры. Рекомендуются вместо ручных хардкод-отступов.


Позиционирование и трансформации


  • offset(x, y) — визуальное смещение элемента без изменения места в раскладке: соседи не сдвигаются.
  • absoluteOffset() — то же, но без учёта направления письма.
  • layoutId() — присваивает элементу идентификатор для работы с кастомными Layout и анимациями AnimatedContent.
  • rotate(degrees) — поворот вокруг центра.
  • scale(scaleX, scaleY) — масштабирование.
  • graphicsLayer() — «тяжёлая артиллерия» трансформаций: объединяет поворот, масштаб, прозрачность, смещение по Z и аппаратное ускорение. Снижает нагрузку, если анимировать несколько свойств сразу.
  • zIndex() — определяет порядок отрисовки среди соседей.
  • blur() — размытие содержимого (только на Android 12+).
  • clip() — обрезает элемент по заданной форме: Modifier.clip(RoundedCornerShape(12.dp)).
  • drawWithContent() / drawBehind() — низкоуровневые модификаторы для кастомной отрисовки: первого используют, чтобы рисовать поверх или до контента, второго — только позади него.


Внешний вид


  • background(color, shape) — цветной фон, при желании с формой.
  • border(width, color, shape) — рамка заданной толщины, цвета и формы.
  • shadow(elevation, shape) — тень, соответствующая высоте «подъёма» элемента.
  • alpha() — прозрачность от 0.0 до 1.0.


Взаимодействие и поведение


  • clickable(onClick) — делает элемент кликабельным, добавляет рябь (ripple) и семантику нажатия. Вариант combinedClickable поддерживает долгое нажатие и двойной клик.
  • focusable() — делает элемент фокусируемым с клавиатуры.
  • selectable(), toggleable() — семантика выбора и переключения (для чекбоксов, списков, радио-кнопок).
  • scrollable() — добавляет возможность прокрутки, но без содержимого — для скролла списков используйте verticalScroll() и horizontalScroll() с объектом rememberScrollState().
  • draggable(), nestedScroll() — перетаскивание и вложенная прокрутка.
  • pointerInput() — универсальный обработчик жестов: тапы, свайпы, долгие нажатия, кастомная логика.
  • hoverable(), mouseHoverIcon() — реакция на наведение курсора (полезно для десктопных сборок).


Прочее


  • semantics() — добавляет описание для TalkBack и тестов.
  • testTag() — метка для UI-тестов.
  • onGloballyPositioned() — колбэк с координатами и размерами после размещения — источник данных для всплывающих окон и анимаций.
  • animateContentSize() — анимирует изменение размера элемента при изменении контента.
  • imeNestedScroll() — взаимодействие прокрутки с клавиатурой.
  • layout() — полный кастомный модификатор: вы сами измеряете и размещаете содержимое.


Важен ли порядок? Да, и это ключевой момент


Модификаторы применяются в цепочке слева направо, и каждый влияет на следующий. Классический пример:
// 1. padding → background
Modifier
    .padding(16.dp)
    .background(Color.Red)
// фон соприкасается с текстом, а красная область — на всю ячейку,
// отступ «снаружи»

// 2. background → padding
Modifier
    .background(Color.Red)
    .padding(16.dp)
// отступ внутри красной области — фон окружает контент

То же с размером и тенью: Modifier.size(100.dp).background(...) — фон на всю область 100 dp, а Modifier.background(...).size(100.dp) — фон сначала на контент, потом всё это растягивается. С кликабельностью нюанс ещё важнее: если написать Modifier.clickable().padding(16.dp), то отступы тоже станут кликабельной зоной; если Modifier.padding(16.dp).clickable() — реагировать будет только контент, без отступов. С clip() и shadow() порядок определяет, обрезается ли тень по форме или рисуется под ней.

Практическое правило: идите в порядке «от общего к частному» — сначала позиция и размер, потом фон и форма, потом отступы и клики.

*** *** *** *** ***

Полный список модификаторов ещё шире — сюда не вошли модификаторы из accompanist, coil (например, Modifier.paint()), навигационных библиотек и собственных расширений. Но ядро из androidx.compose.ui именно такое, и его покрывает 90 процентов реальных задач.

Автор:  16.11.2026 08:45:13 pm