Layout dei widget canonici
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Crea layout dei widget efficaci identificando innanzitutto i tuoi contenuti principali. Il layout determina il modo in cui le informazioni e gli elementi interattivi sono organizzati all'interno del widget. Android offre diversi layout predefiniti per barre degli strumenti, testo, elenchi e widget di tipo griglia per semplificare questa procedura.
Testo
I layout di testo sono ideali per visualizzare informazioni concise. Migliora l'impatto visivo del widget includendo, se vuoi, un'immagine accanto al testo.
Solo testo
Ideale per titoli, aggiornamenti dello stato, descrizioni brevi o qualsiasi scenario
in cui una singola riga di testo trasmette efficacemente il messaggio. Consulta il
esempio di layout canonico
per indicazioni su come ridimensionare dinamicamente i contenuti di testo in base alle dimensioni dei widget.
Testo e immagine
Includi un'immagine per un maggiore impatto visivo. Per ulteriori informazioni, consulta
Punti di interruzione
per scoprire come adattare questo layout a dimensioni dello schermo diverse.
Utilizza i layout della barra degli strumenti per offrire agli utenti un accesso rapido alle attività utilizzate di frequente nella tua app, in un layout flessibile che si adatta alle dimensioni dei widget.
Barra degli strumenti di ricerca
Il layout di una barra degli strumenti di ricerca è progettato intenzionalmente per attirare l'attenzione sulla ricerca come azione principale nella barra degli strumenti. Ulteriori pulsanti pratici possono fornire accesso rapido alle funzioni utilizzate di frequente.
Barra degli strumenti
Le barre degli strumenti mostrano il branding dell'app seguito da pulsanti per le attività più utilizzate, ideali per impostazioni o link alle attività attivabili/disattivabili. Quando modifichi le dimensioni, le opzioni meno comunemente utilizzate possono essere nascoste a favore di azioni più comuni. Utilizza
Breakpoint
per aggiungere un nuovo pulsante toccabile di almeno 48 dp quando c'è spazio.
Elenchi
Utilizza i layout di elenco per organizzare più elementi in un formato chiaro e leggibile. È ideale per titoli di notizie, liste di cose da fare o messaggi. Organizza i contenuti in un elenco strutturato e facilmente consultabile. Scegli tra la presentazione con contenitore o senza contenitore in base alle esigenze dei tuoi contenuti.
Elenco di testo e immagini
Elenchi di testo e immagini facilmente scansionabili sono perfetti per mostrare più tipi di contenuti, ad esempio titoli di notizie, playlist con copertine degli album o messaggi.
Elenco di controllo
Il layout della lista di controllo è perfetto per visualizzare le attività e offre obiettivi di tocco chiari per consentire agli utenti di contrassegnare facilmente gli elementi come completati.
Elenco di azioni
Fornisci un raggruppamento di controllo intuitivo con gli elenchi di azioni, in cui gli stati di attivazione/disattivazione visivi offeriscono un feedback immediato sugli stati degli elementi.
Griglia
Mostra le immagini in una griglia compatta, flessibile e accattivante con etichette facoltative.
Utilizza colonne e righe che si adattano a diversi formati dello schermo.
Solo immagine
Crea gallerie di immagini scorrevoli e visivamente efficaci utilizzando griglie con solo immagini. Le righe e le colonne si adattano automaticamente a varie dimensioni dello schermo per una presentazione ottimale.
Immagine e testo
Puoi anche incorporare etichette e descrizioni di testo, arricchendo così i contenuti della griglia di immagini con contesto e informazioni aggiuntivi.
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-07-27 UTC.
[null,null,["Ultimo aggiornamento 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."]]
