Канонические макеты

Канонические макеты — это проверенные, универсальные макеты, обеспечивающие оптимальное взаимодействие с пользователем на различных форм-факторах.

Изображение устройств с большими экранами, демонстрирующее канонические схемы расположения элементов.

Стандартные макеты поддерживают телефоны с маленькими экранами, а также планшеты, складные устройства и устройства ChromeOS. Созданные в соответствии с принципами Material Design , эти макеты являются одновременно эстетичными и функциональными.

Фреймворк Android включает в себя специализированные компоненты, которые упрощают и делают надежной реализацию макетов.

Стандартные макеты создают привлекательные, повышающие производительность пользовательские интерфейсы, которые лежат в основе отличных приложений.

Подробный список

Макет структуры "список-детали".

Формат «список-подробности» позволяет пользователям просматривать списки элементов, содержащих описательную, пояснительную или другую дополнительную информацию — подробную информацию об элементе.

Макет приложения разделяет окно на две расположенные рядом панели: одна для списка, другая для подробной информации. Пользователи выбирают элементы из списка, чтобы отобразить подробную информацию о них. Прямые ссылки в подробной информации открывают дополнительный контент в этой панели.

Расширенные по ширине окна (см. раздел «Использование классов размеров окна ») позволяют одновременно отображать список и подробную информацию. Выбор элемента списка обновляет панель с подробной информацией, отображая связанное с выбранным элементом содержимое.

На экранах средней и компактной ширины отображается либо список, либо подробная информация, в зависимости от взаимодействия пользователя с приложением. Когда виден только список, при выборе элемента списка вместо списка отображается подробная информация. Когда виден только подробный список, нажатие кнопки «Назад» снова отображает список.

Изменения конфигурации, такие как изменение ориентации устройства или размера окна приложения, могут изменить класс размера окна дисплея. Макет «список-подробности» реагирует соответствующим образом, сохраняя состояние приложения:

  • Если расширенное окно, отображающее одновременно список и подробную информацию, сужается до среднего или компактного размера, подробная информация остается видимой, а список скрывается.
  • Если на экране средней или компактной ширины видна только панель с подробной информацией, и размер окна увеличивается до «расширен», то список и подробная информация отображаются одновременно, при этом в списке указывается, что выбран элемент, соответствующий содержимому панели с подробной информацией.
  • Если на экране средней или компактной ширины видна только панель списка, а при расширении отображается список и панель с подробной информацией в качестве заполнителя, то список и панель с подробными сведениями отображаются одновременно.

Функция «Список-подробности» идеально подходит для мессенджеров , менеджеров контактов , интерактивных медиабраузеров или любых приложений, где контент может быть организован в виде списка элементов, раскрывающих дополнительную информацию.

Рисунок 1. Приложение для обмена сообщениями, отображающее список переписок и подробную информацию о выбранной переписке.

Выполнение

Декларативная парадигма Compose поддерживает логику класса размера окна, которая определяет, показывать ли панели списка и сведений одновременно (когда класс размера окна по ширине развернут) или только панель списка или сведений (когда класс размера окна по ширине средний или компактный).

Чтобы обеспечить однонаправленный поток данных, поднимите все состояния, включая текущий класс размера окна и сведения о выбранном элементе списка (если есть), чтобы все composable-функции имели доступ к данным и могли правильно отображаться.

Если в окне небольшого размера показывается только панель подробностей, добавьте кнопку BackHandler, чтобы убрать ее и оставить только панель списка. BackHandler не является частью общей навигации по приложению, поскольку обработчик зависит от класса размера окна и выбранного состояния детализации.

ListDetailPaneScaffold – это composable-функция высокого уровня, которая упрощает реализацию макетов со списком и подробными сведениями. Он автоматически обрабатывает логику панелей на основе классов размеров окон и поддерживает навигацию между панелями.

Ниже приведен пример минимальной реализации с использованием ListDetailPaneScaffold:

@OptIn(ExperimentalMaterial3AdaptiveApi::class)
@Composable
fun MyListDetailPaneScaffold() {
    val navigator = rememberListDetailPaneScaffoldNavigator()
    ListDetailPaneScaffold(
        directive = navigator.scaffoldDirective,
        value = navigator.scaffoldValue,
        listPane = {
            // Listing Pane
        },
        detailPane = {
            // Details Pane
        }
    )
}

Ниже приведены ключевые компоненты этого примера.

  • rememberListDetailPaneScaffoldNavigator создает навигатор для управления навигацией между панелями списка и подробностей.
  • listPane: показывает список элементов.
  • detailPane – показывает содержимое выбранного объекта.

Подробные примеры реализации приведены в следующих статьях:

Кормить

Макет схемы расположения элементов на экране.

Макет ленты располагает эквивалентные элементы контента в настраиваемой сетке для быстрого и удобного просмотра большого объема контента.

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

Группы контента создаются путем присвоения элементам одинакового размера и их размещения рядом друг с другом. Внимание к элементам привлекается за счет того, что они становятся больше, чем расположенные рядом элементы.

Карточки и списки — распространенные элементы оформления ленты новостей.

Макет ленты поддерживает отображение контента практически любого размера, поскольку сетка может адаптироваться от одной прокручиваемой колонки к многоколоночной прокручиваемой ленте контента.

Ленты новостей особенно хорошо подходят для новостных приложений и социальных сетей .

Рисунок 2. Приложение для социальных сетей, отображающее публикации в виде карточек разного размера.

Выполнение

Фид состоит из большого количества элементов контента, расположенных в виде сетки в контейнере с вертикальной прокруткой. Ленивые списки эффективно отображают большое количество элементов в столбцах или строках. Ленивые сетки отображают элементы в сетках, поддерживая настройку размеров и диапазонов элементов.

Настройте столбцы макета сетки на основе доступной области отображения, чтобы задать минимально допустимую ширину элементов сетки. При определении элементов сетки настройте диапазоны столбцов, чтобы выделить одни элементы над другими.

Для заголовков разделов, разделителей и других элементов, которые должны занимать всю ширину фида, используйте maxLineSpan.

На узких экранах, где не помещается больше одного столбца, LazyVerticalGrid ведет себя так же, как LazyColumn.

Ниже приведен пример минимальной реализации с использованием LazyVerticalGrid:

@Composable
fun MyFeed(names: List<String>) {
    LazyVerticalGrid(
        // GridCells.Adaptive automatically adapts column count based on available width
        columns = GridCells.Adaptive(minSize = 180.dp),
    ) {
        items(names) { name ->
            Text(name)
        }
    }
}

Ключевой элемент адаптивного фида – конфигурация columns. GridCells.Adaptive(minSize = 180.dp) создает сетку, в которой ширина каждого столбца составляет не менее 180.dp. В сетке будет показано столько столбцов, сколько поместится на экране.

Пример реализации можно найти в образце ленты с Compose.

Вспомогательная панель

Макет расположения вспомогательных панелей.

Функция организации панелей позволяет распределить содержимое приложения по основным и дополнительным областям отображения.

Основная область отображения занимает большую часть окна приложения (обычно около двух третей) и содержит основной контент. Вторичная область отображения представляет собой панель, занимающую оставшуюся часть окна приложения и отображающую контент, дополняющий основной контент.

Вспомогательные макеты панелей хорошо работают на дисплеях с увеличенной шириной (см. раздел «Использование классов размеров окон ») в альбомной ориентации. Дисплеи средней или компактной ширины поддерживают отображение как основной, так и дополнительной областей отображения, если контент адаптируется к более узким пространствам экрана или если дополнительный контент может быть изначально скрыт в нижнем или боковом окне, доступном с помощью элемента управления, такого как меню или кнопка.

Макет вспомогательной панели отличается от макета «список-подробности» соотношением основного и второстепенного содержимого. Содержимое второстепенной панели имеет смысл только по отношению к основному содержимому; например, окно инструментов во вспомогательной панели само по себе не имеет значения. Однако дополнительное содержимое в панели подробностей макета «список-подробности» имеет смысл даже без основного содержимого, например, описание товара из списка товаров.

Варианты использования вспомогательной панели включают:

Рисунок 3. Приложение для покупок с описанием товаров во вспомогательной панели.

Выполнение

Compose поддерживает логику классов размера окна, которая позволяет определить, следует ли показывать как основной контент, так и вспомогательный контент одновременно или размещать вспомогательный контент в альтернативном месте.

Поднимите все состояния, включая текущий класс размера окна и информацию, связанную с данными в основном и вспомогательном контенте.

На узких экранах размещайте вспомогательный контент под основным или на нижнем экране. Для средних и расширенных экранов разместите вспомогательный контент рядом с основным, выбрав подходящий размер в зависимости от контента и доступного пространства. Для средней ширины разделите пространство экрана поровну между основным и вспомогательным контентом. Для ширины в раскрытом виде выделите 70% пространства для основного контента и 30% для вспомогательного.

SupportingPaneScaffold – это composable-функция высокого уровня, которая упрощает реализацию макетов со вспомогательной панелью. Composable-функция автоматически обрабатывает логику панелей на основе классов размера окна, отображая панели рядом на больших экранах или скрывая вспомогательную панель на маленьких экранах. SupportingPaneScaffold также поддерживает навигацию между панелями.

Ниже приведен пример минимальной реализации.

@OptIn(ExperimentalMaterial3AdaptiveApi::class)
@Composable
fun MySupportingPaneScaffold() {
    // Creates and remembers a navigator to control pane visibility and navigation
    val navigator = rememberSupportingPaneScaffoldNavigator()
    SupportingPaneScaffold(
        // Directive and value help control pane visibility based on screen size and state
        directive = navigator.scaffoldDirective,
        value = navigator.scaffoldValue,
        mainPane = {
            // Main Pane for the primary content
        },
        supportingPane = {
            //Supporting Pane for supplementary content
        }
    )
}
Основные компоненты в примере:

  • rememberSupportingPaneScaffoldNavigator – composable-функция, которая создает навигатор для управления видимостью панелей (например, для скрытия или показа вспомогательной панели на компактных экранах).
  • mainPane – composable-функция, которая показывает основной контент.
  • supportingPane – composable-функция, которая показывает дополнительный контент.

Подробные примеры реализации приведены в следующих статьях:

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