I widget sono un aspetto essenziale della personalizzazione della schermata Home. Puoi pensare e li offre a colpo d'occhio. visualizzazioni dei dati e delle funzionalità più importanti di un'app accessibili direttamente dalla schermata Home dell'utente. Gli utenti possono spostare i widget tra i riquadri della schermata Home e, se supportato, ridimensionarli per personalizzare la quantità di informazioni nel widget in base alle proprie preferenze.
Questa documentazione introduce i diversi tipi di widget che puoi creare e i principi di progettazione da seguire. Per creare un widget dell'app utilizzando la vista remota Layout per API e XML, consulta Creare un widget semplice. A creare un widget utilizzando le API di stile Kotlin e Compose, consulta Jetpack Glance.
Tipi di widget
Mentre pianifichi il widget, pensa al tipo di widget che vuoi creare. Generalmente i widget rientrano in una delle seguenti categorie:
Widget di informazioni
I widget di informazioni in genere mostrano elementi di informazioni cruciali e monitorano come queste informazioni cambiano nel tempo. Esempi di widget di informazioni sono il meteo widget, widget orologio o widget per il monitoraggio dei risultati sportivi. Toccare le informazioni di solito avviano l'app associata e aprono una visualizzazione dettagliata le informazioni del widget.
Widget raccolta
I widget della raccolta sono specializzati nella visualizzazione di più elementi dello stesso tipo. come una raccolta di immagini da un'app Galleria, una raccolta di articoli da un'app di notizie o una raccolta di email o messaggi da un'app di comunicazione. I widget della raccolta possono scorrere in verticale.
I widget della raccolta si concentrano in genere sui seguenti casi d'uso:
- Sfoglia la raccolta.
- L'apertura di un elemento della raccolta nella relativa visualizzazione dei dettagli nell'elemento dell'app.
- Interazione con gli elementi, ad esempio il loro conteggio, con il supporto dei pulsanti composti in Android 12 (livello API 31).
Controllare i widget
Lo scopo principale di un widget di controllo è visualizzare le funzioni utilizzate di frequente, in modo che in modo che l'utente possa attivarle dalla schermata Home senza dover aprire il dell'app. Considerali come telecomandi per un'app. Un esempio di il widget di controllo è un widget per il controllo della casa che consente agli utenti di accendere le luci in casa on o off.
Interagendo con un widget di controllo, è possibile che si apra una visualizzazione dei dettagli associata nel dell'app. Ciò dipende dal fatto che la funzione del widget di controllo restituisca dati o meno come nel caso di un widget di ricerca.
Widget ibridi
Sebbene alcuni widget rappresentino uno dei tipi descritti nella sezioni—informazioni, raccolta o controllo—molti widget sono ibridi che combinano elementi di tipi diversi. Ad esempio, un widget di un player di musica è principalmente un widget di controllo, ma mostra all'utente anche quale traccia è in riproduzione, come un widget informativo.
Quando pianifichi il widget, progettalo in base a uno dei tipi di base e aggiungi elementi di altri tipi, se necessario.
Integrare i widget con l'Assistente Google
Qualsiasi tipo di widget può essere visualizzato dall'Assistente Google in risposta all'utente comandi vocali. Puoi configurare i widget in modo che eseguano azioni di app, consentendo agli utenti di ricevere risposte rapide ed esperienze con app interattive sulle piattaforme dell'assistente come Android e Android Auto. Per maggiori dettagli sull'implementazione dei widget per l'assistente, consulta Integrare App Actions con i widget Android.
Limitazioni dei widget
I widget possono essere intesi come "mini app", ci sono alcune limitazioni che è importante comprendere prima di progettare il widget.
Gesti
Poiché i widget si trovano sulla schermata Home, devono coesistere che viene stabilito lì. In questo modo viene limitato il supporto dei gesti, disponibile in un widget rispetto a un'app a schermo intero. Anche se le app possono consentire agli utenti puoi navigare tra le schermate in orizzontale. Il gesto è già stato eseguito nella schermata Home. per spostarti tra le schermate Home.
Gli unici gesti disponibili per i widget sono tocco e scorrimento verticale.
Elementi
Viste le limitazioni dei gesti disponibili per i widget, alcuni componenti di base dell'interfaccia utente che si basano su gesti limitati non sono disponibili per i widget. Per un un elenco di componenti di base supportati e ulteriori informazioni sulle limitazioni del layout consulta Creare il layout del widget e Fornire widget flessibili layout.
Linee guida per la progettazione
Contenuti widget
I widget sono un ottimo modo per attirare un utente verso la tua app "pubblicizzando" contenuti nuovi e interessanti disponibili al suo interno.
Proprio come i teaser sulla prima pagina di un giornale, i widget si consolidano e concentrano le informazioni di un'app e forniscono un collegamento a dettagli più all'interno dell'app. Si potrebbe dire che il widget è uno "spuntino" di informazioni mentre è il "pasto". Assicurati che la tua app mostri più dettagli su un'informazione rispetto a quello visualizzato nel widget.
Navigazione widget
Oltre ai contenuti puramente informativi, considera l'idea di fornire il widget Link di navigazione alle aree più utilizzate dell'app. In questo modo gli utenti possono completare le attività più rapidamente ed estende la copertura funzionale dell'app alla casa schermo.
I link di navigazione sui widget sono ideali per i seguenti motivi:
Funzioni generative: sono le funzioni che consentono all'utente di creare nuovi contenuti per un'app, ad esempio la creazione di un nuovo documento o di un nuovo messaggio.
Apri l'app al livello superiore: in genere, toccando un elemento informativo l'utente viene indirizzato a una schermata dei dettagli di livello inferiore. Fornire l'accesso ai al livello superiore dell'applicazione offre una maggiore flessibilità di navigazione sostituisce una scorciatoia app dedicata che gli utenti utilizzano altrimenti per passare alla dalla schermata Home. Utilizzo dell'icona dell'applicazione per questa funzionalità puoi anche fornire al widget una chiara identità se i dati che stai la visualizzazione è ambigua.
Ridimensionamento widget
Toccante e tenendo premuto un widget ridimensionabile e rilasciandolo, il widget viene inserito modalità di ridimensionamento. Gli utenti possono utilizzare i punti di manipolazione di trascinamento o gli angoli del widget per impostare dimensione preferita.
Il ridimensionamento consente agli utenti di regolare l'altezza e la larghezza di un widget all'interno vincoli della griglia di posizionamento nella schermata Home. Puoi decidere se i tuoi il widget può essere ridimensionato liberamente o vincolato a dimensioni orizzontali o verticali modifiche. Non è necessario supportare il ridimensionamento se il widget è intrinsecamente dimensioni fisse.
Consentire agli utenti di ridimensionare i widget offre vantaggi importanti:
- Possono ottimizzare la quantità di informazioni che vogliono visualizzare su ciascun widget.
- Possono influenzare meglio il layout dei widget e delle scorciatoie nella schermata Home. riquadri.
Pianifica una strategia di ridimensionamento per il widget in base al tipo di widget è in fase di creazione. I widget di raccolta basata su elenco o griglia sono solitamente semplici, perché il ridimensionamento del widget espande o contrae l'area di scorrimento verticale. Indipendentemente dalle dimensioni del widget, l'utente può comunque scorrere tutte le informazioni vedere altri elementi.
I widget di informazioni richiedono una pianificazione più pratica, perché non sono scorrevoli e tutti i contenuti devono rientrare in una determinata dimensione. Devi gestire dinamicamente regolare i contenuti e il layout del widget in base alle dimensioni definite dall'utente tramite dell'operazione di ridimensionamento.
Nell'esempio che segue, l'utente può ridimensionare un widget meteo in tre passaggi, mostrando informazioni più complete sul meteo nella posizione corrente come il widget cresce.
Per ogni dimensione del widget, determina quante informazioni della tua app vengono visualizzate. Per i formati più piccoli, concentrati sulle informazioni essenziali e poi aggiungi informazioni le informazioni man mano che il widget cresce orizzontalmente e verticalmente.
Considerazioni sul layout
Potresti avere la tentazione di disporre i widget in base alle dimensioni griglia di posizionamento di un dispositivo con cui sviluppi. Questo può essere un utile riferimento approssimativa, ma tieni presente quanto segue:
- Pianificazione della strategia di ridimensionamento dei widget nei "bucket di dimensioni" anziché con dimensioni della griglia variabili offre i risultati più affidabili.
- Il numero, le dimensioni e la spaziatura delle celle possono variare ampiamente da dispositivo a dispositivo. Di conseguenza, è molto importante che il widget sia flessibile e possa possono occupare più o meno spazio del previsto.
- Quando l'utente ridimensiona un widget, il sistema risponde con un intervallo di dimensioni dp in che il widget può ridisegnare.
- A partire da Android 12, puoi fornire attributi di dimensione più raffinati e layout più flessibili. Ad esempio:
- Specifica delle dimensioni del widget vincoli. Ad esempio: puoi specificare la dimensione target del widget, nella griglia celle, nonché la dimensione massima possibile.
- Fornire layout adattabili, che variano in base alle dimensioni del widget.
- Fornire layout a dimensioni esatte, che consenti all'Avvio app di rispondere con opzioni di dimensioni per verticale e orizzontale per gli smartphone o con quattro taglie per i pieghevoli.
- Utilizzando linee guida aggiornate e nuove API per determinare le dimensioni appropriate per il widget.
Configurazione widget da parte degli utenti
A volte, l'utente deve configurare il widget prima che possa diventare utile. Pensa a un widget email in cui l'utente deve selezionare la cartella della posta prima che la posta in arrivo possa essere visualizzata o a un widget di foto statiche in cui l'utente deve assegnare un'immagine della galleria da visualizzare. I widget Android mostrano la loro scelte di configurazione subito dopo che l'utente inserisce il widget nella schermata Home.
Elenco di controllo per la progettazione di widget
- Concentrati su piccole porzioni di informazioni visibili sul widget. Espandi su le informazioni nella tua app.
- Scegli il tipo di widget giusto per il tuo scopo.
- Pianifica il modo in cui i contenuti del widget si adattano alle diverse dimensioni.
- Assicurati che il layout del widget sia indipendente dall'orientamento e dal dispositivo assicurandoti il layout può allungarsi e contrarsi.
- Valuta se il widget necessita di un'ulteriore configurazione.