Les indicateurs de chargement indiquent la progression d'un temps d'attente court, généralement pour les opérations qui se terminent en moins de cinq secondes. Il existe deux configurations d'indicateurs de chargement :
- Par défaut : formes changeantes non contenues.
- Contenu : formes qui se transforment dans un conteneur circulaire.
L'indicateur se transforme en continu entre ses formes de polygones, soit indéfiniment, soit en réponse à une valeur de progression.
Utiliser des indicateurs de chargement
- Recommandé pour remplacer la plupart des indicateurs de progression circulaires indéterminés.
- Ils reflètent toujours un processus en cours et ne sont jamais purement décoratifs.
- Utilisez-les lorsque la progression n'est pas mesurable ou lorsqu'il n'est pas nécessaire d'indiquer la durée d'une activité.
- Peut être utilisé pour les interactions de type "glisser vers le bas pour actualiser".
- Captez l'attention grâce à des mouvements de morphing.
Exemples
Implémenter un indicateur de chargement
Les indicateurs de chargement utilisent l'animation pour attirer l'attention, réduire la latence perçue et indiquer qu'une activité est en cours. L'extrait de code suivant affiche un LoadingIndicator indéterminé par défaut :
@Composable fun LoadingIndicatorSample() { Column(horizontalAlignment = Alignment.CenterHorizontally) { LoadingIndicator() } }
Implémenter un indicateur de chargement contenu
Utilisez ContainedLoadingIndicator pour afficher des formes changeantes dans un conteneur circulaire qui offre un contraste supplémentaire par rapport au contenu du corps. L'extrait de code suivant implémente un indicateur de chargement contenu :
@Composable fun ContainedLoadingIndicatorSample() { Column(horizontalAlignment = Alignment.CenterHorizontally) { ContainedLoadingIndicator() } }
Implémenter un indicateur de chargement déterminé
Transmettez un lambda progress renvoyant un Float de 0.0 à 1.0 pour transformer LoadingIndicator de manière déterminée au fur et à mesure de la progression d'une opération. L'extrait de code suivant gère la progression de l'indicateur de chargement avec un Slider et un 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), ) } }