Layouts de widgets canônicos
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Crie layouts de widgets eficazes identificando primeiro o conteúdo principal. O
layout determina como as informações e os elementos interativos são organizados no
widget. O Android oferece vários layouts pré-criados para barras de ferramentas, widgets de texto, lista
e tipo de grade para simplificar esse processo.
Texto
Os layouts de texto são ideais para mostrar informações concisas. Melhore o apelo visual
do widget incluindo uma imagem ao lado do texto.
Somente texto
Ideal para títulos, atualizações de status, descrições curtas ou qualquer cenário
em que uma única linha de texto transmita a mensagem de forma eficaz. Consulte o
Exemplo de layout canônico
para orientações sobre como dimensionar dinamicamente o conteúdo de texto com base no tamanho do widget.
Texto e imagem
Inclua uma imagem para aumentar o impacto visual. Para mais informações, consulte
Pontos de interrupção
para saber como adaptar esse layout a diferentes tamanhos de tela.
Use layouts de barra de ferramentas para oferecer aos usuários acesso rápido às tarefas usadas com frequência
no app, em um layout flexível que se adapta a todos os tamanhos de widget.
Barra de ferramentas de pesquisa
O layout da barra de pesquisa é projetado intencionalmente para direcionar o foco para a pesquisa
como uma ação principal na barra. Botões úteis adicionais podem fornecer
acesso rápido a funções usadas com frequência.
Barra de ferramentas
As barras de ferramentas apresentam a marca do app, seguida de botões para as tarefas mais usadas,
que são ideais para configurações alternáveis ou links de tarefas. Ao redimensionar, as opções menos
usadas podem ser ocultas em favor de ações mais comuns. Use
Pontos de interrupção
para adicionar um novo botão acionável mínimo de 48 dp quando houver espaço.
Listas
Use layouts de lista para organizar vários itens em um formato claro e legível. Esse
formato é ideal para manchetes de notícias, listas de tarefas ou mensagens. Organize o conteúdo em uma
lista estruturada e fácil de ler. Escolha entre a apresentação com contêineres ou sem contêineres
com base nas suas necessidades de conteúdo.
Lista de texto e imagem
Listas de texto e imagens de fácil leitura são perfeitas para mostrar vários
tipos de conteúdo, como manchetes de notícias, playlists com capas de álbuns ou
mensagens.
Lista de verificação
O layout da lista de verificação é perfeito para mostrar tarefas, fornecendo alvos de toque
claros para que os usuários marquem os itens como concluídos.
Lista de ações
Ofereça agrupamento de controle intuitivo com listas de ações, em que os estados de ativação/desativação
visuais oferecem feedback imediato sobre os status dos itens.
Grade
Apresente imagens em uma grade compacta, flexível e visualmente rica com rótulos opcionais.
Use colunas e linhas que se adaptam a diferentes tamanhos de tela.
Somente imagem
Crie galerias de imagens roláveis e visualmente impactantes usando grids
somente de imagens. As linhas e colunas se adaptam automaticamente a vários tamanhos de tela para
uma apresentação ideal.
Imagem e texto
Você também pode incorporar rótulos e descrições de texto, enriquecendo o
conteúdo da grade de imagens com mais contexto e informações.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[null,null,["Última atualização 2025-07-27 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."]]
