В рекомендациях по дизайну ТВ-приложений есть вариант карточки, который называется Широкая классическая карточка. В ней изображение и блок с описанием расположены рядом.
При создании сложных двухмерных макетов для экранов телевизоров использование традиционного позиционирования на основе координат или глубоко вложенных контейнеров Row и Column может затруднить чтение, поддержку и рефакторинг кода.
Широкая классическая карточка – идеальный вариант использования API Grid Jetpack Compose, который помогает аккуратно структурировать расположенные рядом элементы, используя семантические, определяемые пользователем области двухмерного макета.
Рекомендации
Реализуйте макет карточки с помощью Grid.
Использование контейнера Grid улучшает читаемость кода, отделяя физические размеры макета от размещения дочерних элементов.
Вместо того чтобы полагаться на точные индексы дорожек, определите семантические именованные области с помощью функции area и разместите дочерние составные элементы с помощью модификатора gridItem.
Объедините гибкие размеры дорожек, такие как GridTrackSize.Auto и minmax(0.dp, 1.fr), с точными промежутками между дорожками (gap(row = 8.dp, column = 16.dp)), чтобы четко и надежно организовать сложные компоненты карточек, расположенные рядом.
Ингредиенты
Grid– двухмерный макет контейнера в Jetpack Compose, который упорядочивает дочерние composable-функции по строкам и столбцам на основе лямбда-выражения конфигурации.gridItem– расширениеModifier, которое связывает дочерний элемент интерфейса с определенным именованным элементомareaIdв макетеGrid.area– функция DSL конфигурации вGridConfigurationScope, которая сопоставляет семантическийareaIdс определенными диапазонами строк и столбцов.Card– composable-функция контейнера Material Design, которая группирует связанные элементы интерфейса и стили.GridTrackSize.MinMax– свойство, определяющее гибкие границы (minиmax) для размеров строк или столбцов.GridTrackSize.Auto– свойство, которое автоматически подбирает размер строки или столбца в соответствии с контентом (column(GridTrackSize.Auto)).gap– функция конфигурации, которая задает вертикальный (row) и горизонтальный (column) интервал между дорожками сетки.
Шаги
Определите идентификаторы областей, настройте дорожки и области сетки, а затем разместите дочерние composable-функции.
1. Определите идентификаторы семантических областей
Сначала создайте типобезопасное представление регионов в макете широкой классической карточки. Класс enum позволяет избежать опечаток в строках и обеспечивает безопасность во время компиляции при сопоставлении дорожек и размещении дочерних элементов.
enum class CardArea { Image, Title, Subtitle, Description, ExtraText, }
2. Настройка дорожек и именованных областей двухмерной сетки
Внутри лямбда-выражения config composable-функции Grid определите столбцы и строки, из которых состоит структура карточки. Для столбца с изображением используйте GridTrackSize.Auto, чтобы он соответствовал ширине значка. Используйте minmax(0.dp, 1.fr) для столбца с контентом, чтобы он мог расширяться на всю оставшуюся ширину карточки. Укажите расстояние между дорожками с помощью gap(row = 8.dp, column = 16.dp). Сопоставьте идентификаторы CardArea с физическими координатами трека с помощью функции area.
Grid( config = { // Define columns: left column for image, right for content column(GridTrackSize.Auto) column(minmax(0.dp, 1.fr)) // Define row tracks for the vertical content stack row(GridTrackSize.Auto) row(GridTrackSize.Auto) row(GridTrackSize.Auto) row(GridTrackSize.Auto) // Map semantic identifiers to grid coordinates and spans area(CardArea.Image, row = 1, column = 1, rowSpan = 4) area(CardArea.Title, row = 1, column = 2) area(CardArea.Subtitle, row = 2, column = 2) area(CardArea.Description, row = 3, column = 2) area(CardArea.ExtraText, row = 4, column = 2) gap(row = 8.dp, column = 16.dp) } ) { // Child elements placed in Step 3 }
3. Разместите дочерние composable-функции с помощью модификатора gridItem.
Настроив дорожки и области, разместите каждый дочерний элемент пользовательского интерфейса исключительно по семантическому назначению, используя модификатор gridItem. Вы можете объявлять дочерние
composable-функции в любом порядке. Контейнер Grid автоматически размещает каждый элемент в назначенной ему двумерной области.
@Composable fun WideClassicCard( imageContent: @Composable () -> Unit, title: String, subtitle: String, description: String, extraText: String, modifier: Modifier = Modifier, ) { Card(modifier = modifier) { Grid( config = { // Define columns: left column for image, right for content column(GridTrackSize.Auto) column(minmax(0.dp, 1.fr)) // Define row tracks for the vertical content stack row(GridTrackSize.Auto) row(GridTrackSize.Auto) row(GridTrackSize.Auto) row(GridTrackSize.Auto) // Map semantic identifiers to grid coordinates and spans area(CardArea.Image, row = 1, column = 1, rowSpan = 4) area(CardArea.Title, row = 1, column = 2) area(CardArea.Subtitle, row = 2, column = 2) area(CardArea.Description, row = 3, column = 2) area(CardArea.ExtraText, row = 4, column = 2) gap(row = 8.dp, column = 16.dp) }, ) { Box(modifier = Modifier.gridItem(CardArea.Image)) { imageContent() } Text( text = title, style = MaterialTheme.typography.titleLarge, modifier = Modifier .gridItem(CardArea.Title) .padding(top = 16.dp, end = 16.dp), ) Text( text = subtitle, style = MaterialTheme.typography.titleMedium, modifier = Modifier .gridItem(CardArea.Subtitle) .padding(end = 16.dp), ) Text( text = description, style = MaterialTheme.typography.bodyMedium, modifier = Modifier .gridItem(CardArea.Description) .padding(end = 16.dp), ) Text( text = extraText, style = MaterialTheme.typography.labelSmall, modifier = Modifier .gridItem(CardArea.ExtraText) .padding(bottom = 16.dp, end = 16.dp), ) } } }
Результаты
Организовав широкую классическую карточку с помощью Grid и именованных областей, вы добьетесь четкого разделения между физическими дорожками макета, координатами областей и размещением дочерних composable-функций.
Такая структура делает макет читаемым и удобным в обслуживании,
следуя рекомендациям по дизайну ТВ-приложений
для расположенных рядом компонентов миниатюр и описаний.
Дополнительные ресурсы
- Рекомендации по дизайну для телевизоров: карточки
- Руководство по адаптивным приложениям: свойства контейнера сетки