Swipe to refresh su Android
Lo swipe to refresh aggiorna manualmente il contenuto dello schermo tramite un'azione o un gesto dell'utente.
Utilizzo
Lo swipe to refresh è un gesto di scorrimento disponibile all'inizio di elenchi, elenchi a griglia e raccolte di scheda, ovvero nella posizione in cui compaiono i contenuti più recenti (indice 0).
Si consiglia di utilizzare questo gesto con contenuti dinamici che si aggiornano frequentemente e compaiono sempre nella stessa posizione, poiché in questi casi gli utenti hanno elevate probabilità di visualizzare nuovi contenuti dopo aver eseguito il gesto.
Indicatore di aggiornamento
L'indicatore di aggiornamento viene visualizzato solo in seguito a un gesto o a un'azione di aggiornamento. La sincronizzazione non mostra alcun indicatore di aggiornamento.
Effetti
Quando questo gesto viene utilizzato in viste che possono cambiare in modo significativo dopo l'aggiornamento, le modifiche potrebbero non risultare immediatamente evidenti agli utenti. Ad esempio, l'aggiornamento potrebbe eliminare, riordinare, modificare e inserire elementi senza seguire un ordine preciso, oppure intervenire solo su elementi fuori dallo schermo.
Lo swipe to refresh non dovrebbe essere utilizzato nelle seguenti situazioni:
- Menu di navigazione a scomparsa (cassetti di navigazione)
- Widget della schermata Home
- Contenuti esplorabili tramite trascinamento (pannable)

Da non fare

Da non fare

Da non fare
Comportamento e posizionamento
Comportamento
Mentre l'indicatore di aggiornamento si espande fino a diventare visibile, lo spinner circolare appare con una dissolvenza in entrata e continua a ruotare.
L'indicatore di aggiornamento rimane visibile fino al completamento dell'attività di aggiornamento e alla visualizzazione degli eventuali nuovi contenuti, oppure finché l'utente non si allontana dai contenuti in aggiornamento.
Da fare
Da non fare
Transizioni dell'indicatore di aggiornamento
Quando una superficie si trova davanti alla superficie contenente i contenuti in aggiornamento, l'indicatore di aggiornamento emerge da dietro tale superficie e rimane ritagliato finché non è completamente visibile.
L'indicatore di aggiornamento aumenta di dimensioni durante lo spostamento quando:
- I contenuti in aggiornamento si trovano a un'elevazione superiore a quella di tutte le altre superfici
- Un aggiornamento dei contenuti viene avviato tramite un'azione della barra dell’applicazione o del menu di overflow
Requisiti di soglia
Per garantire che il gesto di swipe to refresh sia intenzionale, l'indicatore di aggiornamento deve superare una soglia prima che l'app esegua l'aggiornamento. Questa soglia è identificata dai seguenti segnali:
- Lo spinner circolare raggiunge un'opacità del 100%
- La rotazione dello spinner circolare rallenta
- La velocità di spostamento dell'indicatore di aggiornamento rallenta
Una volta superata la soglia, il completamento del gesto avvia l'aggiornamento.
Se il gesto viene invertito riportando l'indicatore al di sotto della soglia, l'aggiornamento viene annullato.
Swipe to refresh nella composizione
Posizionamento del gesto
In genere, il gesto di aggiornamento è disponibile nella parte superiore delle raccolte di contenuti, ma può trovarsi anche nella parte inferiore dello schermo.
Indicatore di aggiornamento (posizione di riposo orizzontale)
Quando si trova in posizione di riposo, l'indicatore di aggiornamento è centrato orizzontalmente rispetto ai contenuti in aggiornamento.

Da fare

Da non fare

Da non fare
Indicatore di aggiornamento (posizione di riposo verticale)
L'indicatore di aggiornamento si trova vicino alla parte superiore dei contenuti in aggiornamento.
La sua posizione di riposo verticale può essere regolata per migliorare l'armonia del layout. Ad esempio, l'indicatore può trovarsi sul bordo di una superficie o sulla griglia del layout, purché sia posizionato vicino alla parte superiore dei contenuti in aggiornamento.

Da fare

Da non fare