Ladeanzeigen zeigen den Fortschritt für eine kurze Wartezeit an, in der Regel für Vorgänge, die in weniger als fünf Sekunden abgeschlossen sind. Es gibt zwei Konfigurationen von Ladeanzeigen:
- Standard: Unbegrenzte, sich verändernde Formen.
- Contained: Morphende Formen in einem kreisförmigen Container.
Die Anzeige wechselt kontinuierlich zwischen den Polygonformen, entweder unbegrenzt oder als Reaktion auf einen Fortschrittswert.
Ladeanzeigen verwenden
- Empfohlen als Ersatz für die meisten unbestimmten kreisförmigen Fortschrittsanzeigen.
- Sie spiegeln immer einen laufenden Prozess wider und sind nie rein dekorativ.
- Verwenden Sie sie, wenn der Fortschritt nicht messbar ist oder wenn es nicht erforderlich ist, anzugeben, wie lange eine Aktivität dauert.
- Kann für „Zum Aktualisieren nach unten ziehen“-Interaktionen verwendet werden.
- Mit Bewegungen, die die Form verändern, Aufmerksamkeit erregen.
Beispiele
Ladeanzeige implementieren
Ladeanzeigen verwenden Animationen, um Aufmerksamkeit zu erregen, die wahrgenommene Latenz zu verringern und anzuzeigen, dass eine Aktivität im Gange ist. Das folgende Snippet rendert ein unbestimmtes Standard-LoadingIndicator:
@Composable fun LoadingIndicatorSample() { Column(horizontalAlignment = Alignment.CenterHorizontally) { LoadingIndicator() } }
Eingebettete Ladeanzeige implementieren
Verwenden Sie ContainedLoadingIndicator, um Morphing-Formen in einem kreisförmigen Container zu rendern, der zusätzlichen Kontrast zum Textinhalt bietet. Das folgende Snippet implementiert eine Ladeanzeige in einem Container:
@Composable fun ContainedLoadingIndicatorSample() { Column(horizontalAlignment = Alignment.CenterHorizontally) { ContainedLoadingIndicator() } }
Bestimmte Ladeanzeige implementieren
Übergeben Sie einen progress-Lambda, der einen Float von 0.0 an 1.0 zurückgibt, um LoadingIndicator im Verlauf eines Vorgangs deterministisch zu morphen. Im folgenden Snippet wird der Fortschritt der Ladeanzeige mit einem Slider und rememberSliderState gesteuert:
@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), ) } }