Интерфейс на Jetpack Compose

Собери экран из composable-функций: управляй размерами и отступами через Modifier, располагай элементы с помощью Row, Column, Box и LazyColumn, используй компоненты Material 3 и сразу смотри результат в @Preview.

  • Продвинутый
  • 22 мин
  • 10 вопросов
  • Урок 10 из 14

В этом уроке ты узнаешь

  • Писать переиспользуемую composable-функцию с параметрами
  • Читать цепочку Modifier и объяснять, как порядок влияет на результат
  • Строить раскладку экрана с Row, Column, Box и LazyColumn
  • Использовать компоненты Material 3 и создавать превью

Когда собираешь дом из LEGO, у каждого кирпичика своё место: несколько кирпичиков — стена, стены — комната, комнаты — дом. Экран в Jetpack Compose строится так же: из маленьких composable-функций — текста, кнопки, картинки — складываются части побольше, а из них — целый экран. В этом уроке ты соберёшь карточку урока и список уроков для приложения Educora.

Composable-функции и декларативный подход

В старом подходе Android экран описывался в XML-файле, а код на Kotlin находил элементы через findViewById и менял их вручную. В Compose ты просто пишешь, как должен выглядеть экран при данных данных; когда данные меняются, Compose вызывает функцию заново. Сравни:

Императивно: XML + findViewById

// activity_main.xml contains a TextView and a Button
class MainActivity : AppCompatActivity() {
    private var count = 0

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        val label = findViewById<TextView>(R.id.label)
        val button = findViewById<Button>(R.id.button)
        button.setOnClickListener {
            count++
            label.text = "Taps: $count"
        }
    }
}

Декларативно: Compose

@Composable
fun TapCounter() {
    var count by remember { mutableIntStateOf(0) }
    Column {
        Text("Taps: $count")
        Button(onClick = { count++ }) {
            Text("Tap")
        }
    }
}
Слева текст приходится обновлять самому; справа меняется только count, а экран обновляется сам.
  • Composable-функция помечается @Composable, а её имя начинается с заглавной буквы: LessonCard.
  • Composable, рисующая интерфейс, ничего не возвращает (Unit) — она описывает интерфейс.
  • Данные приходят через параметры, а последний параметр обычно modifier: Modifier = Modifier, чтобы вызывающий код мог настроить внешний вид.

Чтобы читать дальше, зарегистрируйся бесплатно

Остальные разделы урока, тест и заметки открываются с аккаунтом Educora. Регистрация занимает минуту, а прогресс сохраняется на всех твоих устройствах.

Modifier: размер, отступы, фон, нажатия

Modifier — цепочка, которая задаёт, как элемент размещается и как себя ведёт: padding, size, fillMaxWidth, background, clip, clickable и так далее. Цепочка применяется сверху вниз, снаружи внутрь, поэтому порядок важен:

Kotlin
Text(
    text = "Kotlin",
    modifier = Modifier
        .padding(8.dp)
        .background(Color.Yellow)
        .padding(16.dp)
        .clickable { /* open the lesson */ }
)
Результат: прозрачный отступ 8 dp, затем жёлтый фон, внутри которого вокруг текста 16 dp пустого места. Область нажатия — только текст и внутренний отступ.

Раскладки: Row, Column, Box, LazyColumn

РаскладкаЧто делает
Columnрасполагает элементы вертикально, друг под другом
Rowрасполагает элементы горизонтально, рядом
Boxкладёт элементы друг на друга (например, картинку и надпись поверх)
LazyColumn / LazyRowдлинный список: создаёт только видимые на экране элементы
Spacerпустое место между элементами

Теперь соединим всё вместе. LessonCard показывает слева круглый значок, а справа — название и длительность. Значок — это Box, тексты — в Column, и оба находятся внутри Row. Modifier.weight(1f) отдаёт колонке всё свободное место в строке.

Kotlin
@Composable
fun LessonCard(title: String, minutes: Int, modifier: Modifier = Modifier) {
    Card(modifier = modifier.fillMaxWidth()) {
        Row(
            modifier = Modifier.padding(16.dp),
            verticalAlignment = Alignment.CenterVertically
        ) {
            Box(
                modifier = Modifier
                    .size(48.dp)
                    .clip(CircleShape)
                    .background(MaterialTheme.colorScheme.primaryContainer),
                contentAlignment = Alignment.Center
            ) {
                Text(title.first().toString())
            }
            Spacer(Modifier.width(16.dp))
            Column(modifier = Modifier.weight(1f)) {
                Text(title, style = MaterialTheme.typography.titleMedium)
                Text("$minutes min", style = MaterialTheme.typography.bodySmall)
            }
        }
    }
}
На экране: карточка; слева круг с первой буквой названия, справа крупное название и под ним мелкая надпись «15 min».
Kotlin
@Composable
fun LessonList(lessons: List<String>, modifier: Modifier = Modifier) {
    LazyColumn(
        modifier = modifier,
        contentPadding = PaddingValues(16.dp),
        verticalArrangement = Arrangement.spacedBy(8.dp)
    ) {
        items(lessons) { title ->
            LessonCard(title = title, minutes = 15)
        }
    }
}
На экране: прокручиваемый список карточек с промежутками 8 dp.

Компоненты Material 3 и тема

Material 3 — дизайн-система Google; в Compose она представлена набором готовых компонентов: Button, OutlinedButton, TextButton, Card, OutlinedTextField, Switch, Checkbox, Scaffold и другими. Вместо того чтобы прописывать цвета и шрифты вручную, бери их из MaterialTheme.colorScheme и MaterialTheme.typography — тогда тёмная тема и, начиная с Android 12, динамические цвета под обои будут работать автоматически.

Kotlin
@Composable
fun ProfileForm(modifier: Modifier = Modifier) {
    var name by remember { mutableStateOf("") }
    var reminders by remember { mutableStateOf(true) }

    Column(
        modifier = modifier.padding(16.dp),
        verticalArrangement = Arrangement.spacedBy(12.dp)
    ) {
        OutlinedTextField(
            value = name,
            onValueChange = { name = it },
            label = { Text("Name") }
        )
        Row(verticalAlignment = Alignment.CenterVertically) {
            Text("Daily reminders", modifier = Modifier.weight(1f))
            Switch(checked = reminders, onCheckedChange = { reminders = it })
        }
        Button(onClick = { /* save */ }, enabled = name.isNotBlank()) {
            Text("Save")
        }
    }
}
На экране: текстовое поле с подписью «Name», строка «Daily reminders» с переключателем справа и кнопка «Save», которая неактивна, пока имя пустое.

Обрати внимание: компоненты Material не хранят собственное состояние. OutlinedTextField берёт текст из параметра value и возвращает новый текст через onValueChange — сохранить его должен ты. Как это устроено, подробно разберём в следующем уроке.

Превью: смотри без запуска приложения

Kotlin
@Preview(showBackground = true)
@Preview(
    name = "Dark",
    showBackground = true,
    uiMode = Configuration.UI_MODE_NIGHT_YES
)
@Composable
fun LessonCardPreview() {
    EducoraNotesTheme {
        LessonCard(title = "Jetpack Compose", minutes = 15)
    }
}
Два превью: одна и та же карточка в светлой и тёмной теме.
  1. Открой режим Split

    Нажми Split в правом верхнем углу редактора: слева будет код, справа — превью.

  2. Обнови

    После крупной правки нажми Build & Refresh в панели превью; мелкие изменения текста обычно видны сразу.

  3. Интерактивный режим

    Нажми кнопку интерактивного режима над превью: теперь можно нажимать кнопки и вводить текст без эмулятора.

быстрое исправление: добавить недостающий import (Mac: Option+Return)Alt+Enter
отформатировать код (Mac: Cmd+Option+L)Ctrl+Alt+L
показать параметры функции (Mac: Cmd+P)Ctrl+P
перейти к объявлению, например к исходнику Card (Mac: Cmd+B)Ctrl+B
обернуть выделенный код — Surround With (Mac: Cmd+Option+T)Ctrl+Alt+T

Запомни

  • В Compose экран собирается из @Composable-функций; ты описываешь, как он должен выглядеть.
  • Цепочка Modifier применяется снаружи внутрь, поэтому порядок padding и background меняет результат.
  • Column располагает вертикально, Row — горизонтально, Box — друг на друге; для длинных списков нужен LazyColumn.
  • Бери цвета и шрифты из MaterialTheme, чтобы тёмная тема и динамические цвета работали сами.
  • @Preview показывает экран без эмулятора; у одной функции может быть несколько превью.
Заметил ошибку или неточность в уроке?

Проверь себя

Вопросов: 10. Каждый правильный ответ приносит XP.

Вопрос 1 / 10

Вопрос 1 / 10. Что лучше всего подходит для прокручиваемого списка из 500 уроков?