Когда собираешь дом из 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 и так далее. Цепочка применяется сверху вниз, снаружи внутрь, поэтому порядок важен:
Text(
text = "Kotlin",
modifier = Modifier
.padding(8.dp)
.background(Color.Yellow)
.padding(16.dp)
.clickable { /* open the lesson */ }
)Раскладки: Row, Column, Box, LazyColumn
| Раскладка | Что делает |
|---|---|
Column | располагает элементы вертикально, друг под другом |
Row | располагает элементы горизонтально, рядом |
Box | кладёт элементы друг на друга (например, картинку и надпись поверх) |
LazyColumn / LazyRow | длинный список: создаёт только видимые на экране элементы |
Spacer | пустое место между элементами |
Теперь соединим всё вместе. LessonCard показывает слева круглый значок, а справа — название и длительность. Значок — это Box, тексты — в Column, и оба находятся внутри Row. Modifier.weight(1f) отдаёт колонке всё свободное место в строке.
@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)
}
}
}
}@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)
}
}
}Компоненты Material 3 и тема
Material 3 — дизайн-система Google; в Compose она представлена набором готовых компонентов: Button, OutlinedButton, TextButton, Card, OutlinedTextField, Switch, Checkbox, Scaffold и другими. Вместо того чтобы прописывать цвета и шрифты вручную, бери их из MaterialTheme.colorScheme и MaterialTheme.typography — тогда тёмная тема и, начиная с Android 12, динамические цвета под обои будут работать автоматически.
@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")
}
}
}Обрати внимание: компоненты Material не хранят собственное состояние. OutlinedTextField берёт текст из параметра value и возвращает новый текст через onValueChange — сохранить его должен ты. Как это устроено, подробно разберём в следующем уроке.
Превью: смотри без запуска приложения
@Preview(showBackground = true)
@Preview(
name = "Dark",
showBackground = true,
uiMode = Configuration.UI_MODE_NIGHT_YES
)
@Composable
fun LessonCardPreview() {
EducoraNotesTheme {
LessonCard(title = "Jetpack Compose", minutes = 15)
}
}Открой режим Split
Нажми
Splitв правом верхнем углу редактора: слева будет код, справа — превью.Обнови
После крупной правки нажми
Build & Refreshв панели превью; мелкие изменения текста обычно видны сразу.Интерактивный режим
Нажми кнопку интерактивного режима над превью: теперь можно нажимать кнопки и вводить текст без эмулятора.
import (Mac: Option+Return)Alt+EnterCmd+Option+L)Ctrl+Alt+LCmd+P)Ctrl+PCard (Mac: Cmd+B)Ctrl+BCmd+Option+T)Ctrl+Alt+TЗапомни
- В Compose экран собирается из
@Composable-функций; ты описываешь, как он должен выглядеть. - Цепочка Modifier применяется снаружи внутрь, поэтому порядок
paddingиbackgroundменяет результат. Columnрасполагает вертикально,Row— горизонтально,Box— друг на друге; для длинных списков нуженLazyColumn.- Бери цвета и шрифты из
MaterialTheme, чтобы тёмная тема и динамические цвета работали сами. @Previewпоказывает экран без эмулятора; у одной функции может быть несколько превью.