Gli indicatori di caricamento mostrano l'avanzamento per un breve tempo di attesa, in genere per operazioni che vengono completate in meno di cinque secondi. Esistono due configurazioni degli indicatori di caricamento:
- Predefinito: forme che si trasformano senza contenitore.
- Contenuto: forme che si trasformano all'interno di un contenitore circolare.
L'indicatore si trasforma continuamente tra le sue forme poligonali, indefinitamente o in risposta a un valore di avanzamento.
Utilizzo degli indicatori di caricamento
- Consigliato come sostituto per la maggior parte degli indicatori di avanzamento circolari indeterminati.
- Riflettono sempre un processo in corso e non sono mai puramente decorative.
- Utilizzali quando l'avanzamento non è misurabile o quando non è necessario indicare il tempo necessario per un'attività.
- Può essere utilizzato per le interazioni di tipo pull to refresh.
- Cattura l'attenzione con un movimento di metamorfosi delle forme.
Esempi
Implementa un indicatore di caricamento
Gli indicatori di caricamento utilizzano l'animazione per attirare l'attenzione, ridurre la latenza percepita e indicare che un'attività è in corso. Il seguente snippet mostra un elemento LoadingIndicator indeterminato predefinito:
@Composable fun LoadingIndicatorSample() { Column(horizontalAlignment = Alignment.CenterHorizontally) { LoadingIndicator() } }
Implementa un indicatore di caricamento contenuto
Utilizza ContainedLoadingIndicator per eseguire il rendering di forme in trasformazione all'interno di un contenitore circolare che fornisce un contrasto aggiuntivo rispetto ai contenuti del corpo. Il seguente snippet implementa un indicatore di caricamento contenuto:
@Composable fun ContainedLoadingIndicatorSample() { Column(horizontalAlignment = Alignment.CenterHorizontally) { ContainedLoadingIndicator() } }
Implementa un indicatore di caricamento determinato
Passa un'espressione lambda progress che restituisce un valore Float da 0.0 a 1.0 per trasformare
LoadingIndicator in modo definitivo man mano che un'operazione procede. Lo snippet seguente gestisce l'avanzamento dell'indicatore di caricamento con un Slider e rememberSliderState:
@Composable fun DeterminateLoadingIndicatorSample() { val sliderState = rememberSliderState() val animatedProgress by animateFloatAsState( targetValue = sliderState.value, animationSpec = spring( dampingRatio = Spring.DampingRatioNoBouncy, stiffness = Spring.StiffnessVeryLow, visibilityThreshold = 1 / 1000f, ), ) Column(horizontalAlignment = Alignment.CenterHorizontally) { LoadingIndicator(progress = { animatedProgress }) Spacer(Modifier.requiredHeight(30.dp)) Text("Set loading progress:") Slider( state = sliderState, onValueChange = { sliderState.value = it }, modifier = Modifier.width(300.dp), ) } }