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

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

Формат «список-подробности» позволяет пользователям просматривать списки элементов, содержащих описательную, пояснительную или другую дополнительную информацию — подробную информацию об элементе.
Макет приложения разделяет окно на две расположенные рядом панели: одна для списка, другая для подробной информации. Пользователи выбирают элементы из списка, чтобы отобразить подробную информацию о них. Прямые ссылки в подробной информации открывают дополнительный контент в этой панели.
Расширенные по ширине окна (см. раздел «Использование классов размеров окна ») позволяют одновременно отображать список и подробную информацию. Выбор элемента списка обновляет панель с подробной информацией, отображая связанное с выбранным элементом содержимое.
На экранах средней и компактной ширины отображается либо список, либо подробная информация, в зависимости от взаимодействия пользователя с приложением. Когда виден только список, при выборе элемента списка вместо списка отображается подробная информация. Когда виден только подробный список, нажатие кнопки «Назад» снова отображает список.
Изменения конфигурации, такие как изменение ориентации устройства или размера окна приложения, могут изменить класс размера окна дисплея. Макет «список-подробности» реагирует соответствующим образом, сохраняя состояние приложения:
- Если расширенное окно, отображающее одновременно список и подробную информацию, сужается до среднего или компактного размера, подробная информация остается видимой, а список скрывается.
- Если на экране средней или компактной ширины видна только панель с подробной информацией, и размер окна увеличивается до «расширен», то список и подробная информация отображаются одновременно, при этом в списке указывается, что выбран элемент, соответствующий содержимому панели с подробной информацией.
- Если на экране средней или компактной ширины видна только панель списка, а при расширении отображается список и панель с подробной информацией в качестве заполнителя, то список и панель с подробными сведениями отображаются одновременно.
Функция «Список-подробности» идеально подходит для мессенджеров , менеджеров контактов , интерактивных медиабраузеров или любых приложений, где контент может быть организован в виде списка элементов, раскрывающих дополнительную информацию.
Выполнение
Декларативная парадигма 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– показывает содержимое выбранного объекта.
Подробные примеры реализации приведены в следующих статьях:
- Руководство для разработчиков по созданию макета "Список и подробные сведения"
- список и подробные сведения образец
Кормить

Макет ленты располагает эквивалентные элементы контента в настраиваемой сетке для быстрого и удобного просмотра большого объема контента.
Размер и расположение определяют взаимосвязь между элементами контента.
Группы контента создаются путем присвоения элементам одинакового размера и их размещения рядом друг с другом. Внимание к элементам привлекается за счет того, что они становятся больше, чем расположенные рядом элементы.
Карточки и списки — распространенные элементы оформления ленты новостей.
Макет ленты поддерживает отображение контента практически любого размера, поскольку сетка может адаптироваться от одной прокручиваемой колонки к многоколоночной прокручиваемой ленте контента.
Ленты новостей особенно хорошо подходят для новостных приложений и социальных сетей .
Выполнение
Фид состоит из большого количества элементов контента, расположенных в виде сетки в контейнере с вертикальной прокруткой. Ленивые списки эффективно отображают большое количество элементов в столбцах или строках. Ленивые сетки отображают элементы в сетках, поддерживая настройку размеров и диапазонов элементов.
Настройте столбцы макета сетки на основе доступной области отображения, чтобы задать минимально допустимую ширину элементов сетки. При определении элементов сетки настройте диапазоны столбцов, чтобы выделить одни элементы над другими.
Для заголовков разделов, разделителей и других элементов, которые должны занимать всю ширину фида, используйте 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.
Вспомогательная панель

Функция организации панелей позволяет распределить содержимое приложения по основным и дополнительным областям отображения.
Основная область отображения занимает большую часть окна приложения (обычно около двух третей) и содержит основной контент. Вторичная область отображения представляет собой панель, занимающую оставшуюся часть окна приложения и отображающую контент, дополняющий основной контент.
Вспомогательные макеты панелей хорошо работают на дисплеях с увеличенной шириной (см. раздел «Использование классов размеров окон ») в альбомной ориентации. Дисплеи средней или компактной ширины поддерживают отображение как основной, так и дополнительной областей отображения, если контент адаптируется к более узким пространствам экрана или если дополнительный контент может быть изначально скрыт в нижнем или боковом окне, доступном с помощью элемента управления, такого как меню или кнопка.
Макет вспомогательной панели отличается от макета «список-подробности» соотношением основного и второстепенного содержимого. Содержимое второстепенной панели имеет смысл только по отношению к основному содержимому; например, окно инструментов во вспомогательной панели само по себе не имеет значения. Однако дополнительное содержимое в панели подробностей макета «список-подробности» имеет смысл даже без основного содержимого, например, описание товара из списка товаров.
Варианты использования вспомогательной панели включают:
- Приложения для повышения производительности: документ или электронная таблица, сопровождаемые комментариями рецензента во вспомогательной панели.
- Медиаприложения: потоковое видео и список похожих видеороликов во вспомогательной панели, или отображение музыкального альбома, дополненного плейлистом.
- Инструменты и настройки: Инструмент для редактирования медиафайлов с палитрами, эффектами и другими настройками в панели поддержки.
Выполнение
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-функция, которая показывает дополнительный контент.
Подробные примеры реализации приведены в следующих статьях:
- Создание макета со вспомогательной панелью руководство для разработчиков
- Пример supporting-pane-compose
Дополнительные ресурсы
- Материальный дизайн — Канонические макеты