Indicateurs de chargement

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 :

  1. Par défaut : formes changeantes non contenues.
  2. Contenu : formes qui se transforment dans un conteneur circulaire.
Configurations par défaut et contenues des indicateurs de chargement
Figure 1. Indicateurs de chargement par défaut et contenus.

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),
        )
    }
}