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()— полный кастомный модификатор: вы сами измеряете и размещаете содержимое.
Важен ли порядок? Да, и это ключевой момент
Модификаторы применяются в цепочке слева направо, и каждый влияет на следующий. Классический пример:
ВыделитьKotlin
// 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 процентов реальных задач.