Канонические макеты виджетов
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Создавайте эффективные макеты виджетов, сначала определив основной контент. Ваш макет определяет, как информация и интерактивные элементы организованы в вашем виджете. Android предлагает несколько готовых макетов для панелей инструментов, текста, списков и виджетов типа сетки, чтобы упростить этот процесс.
Текст
Текстовые макеты идеально подходят для отображения краткой информации. Повысьте визуальную привлекательность вашего виджета, при необходимости включив изображение рядом с текстом.
Только текст Идеально подходит для заголовков, обновлений статуса, кратких описаний или любого сценария, в котором одна строка текста эффективно передает сообщение. Обратитесь к образцу макета Canonical для получения инструкций по динамическому масштабированию текстового содержимого в зависимости от размера виджета.

Текст и изображение Добавьте изображение для дополнительного визуального эффекта. Дополнительные сведения см. в разделе «Точки останова» , чтобы узнать, как адаптировать этот макет для экранов разных размеров.

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

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

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

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

Список действий Обеспечьте интуитивно понятную группировку элементов управления со списками действий, где визуальные состояния включения/выключения обеспечивают немедленную обратную связь о статусах элементов.

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

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

Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-29 UTC.
[null,null,["Последнее обновление: 2025-07-29 UTC."],[],[],null,["# Canonical widget layouts\n\nCraft effective widget layouts by first identifying your core content. Your\nlayout dictates how information and interactive elements are organized within\nyour widget. Android offers several prebuilt layouts for toolbars, text, list\nand grid-type widgets to streamline this process.\n| **Note:** View detailed layout specs in our [Figma Widget Canonical Builder](https://goo.gle/widget-canonical), and find the code samples using Jetpack Glance in the [Android Platform Samples GitHub repository](https://github.com/android/platform-samples/tree/main/samples/user-interface/appwidgets/src/main/java/com/example/platform/ui/appwidgets/glance).\n\nText\n----\n\nText layouts are ideal for displaying concise information. Enhance the visual\nappeal of your widget by optionally including an image alongside the text. \n**Text only**\n\n\nIdeal for titles, status updates, short descriptions, or any scenario\nwhere a single line of text effectively conveys the message. Refer to the\n[Canonical layout sample](https://github.com/android/platform-samples/tree/main/samples/user-interface/appwidgets/src/main/java/com/example/platform/ui/appwidgets/glance)\nfor guidance on dynamically scaling text content based on widget size. \n**Text and image**\n\n\nInclude an image for added visual impact. For more information, see\n[Breakpoints](/design/ui/mobile/guides/widgets/sizing#breakpoints)\nto learn how to adapt this layout for different screen sizes.\n\nToolbars\n--------\n\nUse toolbar layouts to provide users with quick access to frequently used tasks\nin your app, in a flexible layout that adapts across widget sizes. \n**Search Toolbar**\n\n\nA search toolbar layout is intentionally designed to draw focus to search\nas a primary action in the toolbar. Additional handy buttons can provide\nquick access to frequently used functions.\n\n\n**Toolbar**\n\n\nToolbars presents app branding followed by buttons for the most used tasks\nthat are ideal for toggleable settings or task links. When resizing, less\ncommonly used options can be hidden in favor of more common actions. Use\n[Breakpoints](/design/ui/mobile/guides/widgets/sizing#breakpoints)\nto add a new minimum 48dp tappable button when there's room.\n\n\u003cbr /\u003e\n\nLists\n-----\n\nUse list layouts to organize multiple items in a clear, scannable format. This\nis ideal for news headlines, to-do lists or messages. Organize content into a\nstructured, easily scannable list. Choose between containerized or containerless\npresentation based on your content needs. \n**Text and image list**\n\n\nEasily scannable text and image lists are perfect for showcasing multiple\ncontent types, such as news headlines, playlists with album art, or\nmessages. \n**Checklist**\n\n\nThe checklist layout is perfect for displaying tasks, providing clear tap\ntargets for users to easily mark items as done. \n**Action list**\n\n\nProvide intuitive control grouping with action lists, where visual on/off\nstates offer immediate feedback on item statuses.\n\nGrid\n----\n\nPresent images in a compact, flexible, visually rich grid with optional labels.\nUse columns and rows that adapt to different screen sizes. \n**Image only**\n\n\nCreate visually impactful, scrollable image galleries using image-only\ngrids. Rows and columns automatically adapt to various screen sizes for\noptimal presentation. \n**Image and text**\n\n\nYou can also incorporate text labels and descriptions, enriching your\nimage grid content with additional context and information."]]