Широкий классический макет карточки с сеткой

значок оценки в четыре звезды

В рекомендациях по дизайну ТВ-приложений есть вариант карточки, который называется Широкая классическая карточка. В ней изображение и блок с описанием расположены рядом. При создании сложных двухмерных макетов для экранов телевизоров использование традиционного позиционирования на основе координат или глубоко вложенных контейнеров Row и Column может затруднить чтение, поддержку и рефакторинг кода. Широкая классическая карточка – идеальный вариант использования API Grid Jetpack Compose, который помогает аккуратно структурировать расположенные рядом элементы, используя семантические, определяемые пользователем области двухмерного макета.

Спецификация компонента "Широкая классическая карточка" с пятью именованными областями макета: "Изображение", "Заголовок", "Подзаголовок", "Описание" и "Дополнительный текст".
Рисунок 1. Широкая классическая карточка с пятью именованными областями: область изображения и четыре текстовых поля в блоке контента.

Рекомендации

Реализуйте макет карточки с помощью 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-функций. Такая структура делает макет читаемым и удобным в обслуживании, следуя рекомендациям по дизайну ТВ-приложений для расположенных рядом компонентов миниатюр и описаний.

Дополнительные ресурсы