Crea layout di widget efficaci identificando innanzitutto i contenuti principali. Il layout determina la modalità di organizzazione delle informazioni e degli elementi interattivi all'interno del widget. Android offre diversi layout predefiniti per widget di tipo barra degli strumenti, testo, elenco e griglia per semplificare questa procedura.
Testo
I layout di testo sono ideali per visualizzare informazioni concise. Migliora l'aspetto visivo del widget includendo facoltativamente un'immagine accanto al testo.
Ideale per titoli, aggiornamenti di stato, descrizioni brevi o qualsiasi scenario in cui una singola riga di testo trasmette efficacemente il messaggio.
Includi un'immagine per un maggiore impatto visivo. Per ulteriori informazioni, consulta la sezione Punti di interruzione per scoprire come adattare questo layout a schermi di dimensioni diverse.
Barre degli strumenti
Utilizza i layout della barra degli strumenti per consentire agli utenti di accedere rapidamente alle attività utilizzate di frequente nella tua app, in un layout flessibile che si adatta alle dimensioni dei widget.
Un layout della barra degli strumenti di ricerca è progettato appositamente per concentrare l'attenzione sulla ricerca come azione principale nella barra degli strumenti. I pulsanti aggiuntivi possono fornire accesso rapido alle funzioni utilizzate di frequente.
Le barre degli strumenti mostrano il branding dell'app seguito da pulsanti per le attività più utilizzate che sono ideali per impostazioni attivabili/disattivabili o link alle attività. Quando si ridimensionano, le opzioni meno di uso comune possono essere nascoste a favore di azioni più comuni. Use Breakpoints to add a new minimum 48dp tappable button when there's room.
Elenchi
Utilizza i layout di elenco per organizzare più elementi in un formato chiaro e scansionabile. È ideale per titoli di notizie, elenchi di cose da fare o messaggi. Organizza i contenuti in un elenco strutturato e scansionabile. Scegli tra la presentazione in contenitori o senza contenitori in base alle esigenze dei contenuti.
Gli elenchi di testo e immagini scansionabili sono perfetti per mostrare più tipi di contenuti, come titoli di notizie, playlist con copertine di album o messaggi.
Il layout dell'elenco di controllo è perfetto per visualizzare le attività, fornendo target di tocco chiari per consentire agli utenti di contrassegnare rapidamente gli elementi come completati.
Fornisci un raggruppamento di controlli intuitivo con gli elenchi di azioni, in cui gli stati visivi di attivazione/disattivazione offrono un feedback immediato sullo stato degli elementi.
Griglia
Presenta le immagini in una griglia compatta, flessibile e visivamente ricca con etichette facoltative. Utilizza colonne e righe che si adattano a schermi di dimensioni diverse.
Crea gallerie di immagini scorrevoli e di grande impatto visivo utilizzando griglie di sole immagini. Righe e colonne si adattano automaticamente a varie dimensioni dello schermo per una presentazione ottimale.
Puoi anche incorporare etichette e descrizioni di testo, arricchendo i contenuti della griglia di immagini con contesto e informazioni aggiuntive.
Esempi di codice
La tabella seguente mappa ogni layout canonico alla relativa implementazione di Jetpack Glance nel repository GitHub degli esempi della piattaforma Android.
| Layout canonico | Categoria di layout | File di implementazione di esempio |
|---|---|---|
| Solo testo | Testo | LongTextAppWidget.kt |
| Testo e immagine | Testo | TextWithImageAppWidget.kt |
| Barra degli strumenti di ricerca | Barre degli strumenti | SearchToolBarAppWidget.kt |
| Barra degli strumenti (standard) | Barre degli strumenti | ToolBarAppWidget.kt |
| Elenco di testo e immagini | Elenchi | ImageTextListAppWidget.kt |
| Elenco di controllo | Elenchi | CheckListAppWidget.kt |
| Elenco di azioni | Elenchi | ActionListAppWidget.kt |
| Solo immagini | Griglia | ImageGridAppWidget.kt |
| Immagine e testo | Griglia | ImageGridAppWidget.kt |