Wskaźniki ładowania pokazują postęp w przypadku krótkiego czasu oczekiwania – zwykle operacji, które kończą się w ciągu 5 sekund. Istnieją 2 konfiguracje wskaźników wczytywania:
- Domyślne: nieograniczone kształty zmieniające się.
- W ramach: kształty zmieniające się w okrągłym kontenerze.
Wskaźnik stale zmienia kształt między wielokątami, w nieskończoność lub w odpowiedzi na wartość postępu.
Używanie wskaźników wczytywania
- Zalecany jako zamiennik większości nieokreślonych okrągłych wskaźników postępu.
- Zawsze odzwierciedlają trwający proces i nigdy nie mają charakteru wyłącznie dekoracyjnego.
- Używaj ich, gdy postęp nie jest mierzalny lub gdy nie jest konieczne wskazanie, ile czasu zajmuje dana aktywność.
- Można go używać do interakcji polegających na przeciąganiu w dół w celu odświeżenia.
- Przyciągaj uwagę dzięki ruchowi zmieniającemu kształt.
Przykłady
Zaimplementuj wskaźnik wczytywania
Wskaźniki ładowania wykorzystują animację, aby przyciągnąć uwagę, zmniejszyć postrzegany czas oczekiwania i wskazać, że działanie jest w toku. Ten fragment kodu renderuje domyślny nieokreślony element LoadingIndicator:
@Composable fun LoadingIndicatorSample() { Column(horizontalAlignment = Alignment.CenterHorizontally) { LoadingIndicator() } }
Wdrażanie wskaźnika wczytywania w ramach kontenera
Użyj ContainedLoadingIndicator, aby renderować zmieniające się kształty w okrągłym kontenerze, który zapewnia dodatkowy kontrast w stosunku do treści. Poniższy fragment kodu implementuje wskaźnik stanu wczytywania w kontenerze:
@Composable fun ContainedLoadingIndicatorSample() { Column(horizontalAlignment = Alignment.CenterHorizontally) { ContainedLoadingIndicator() } }
Implementowanie wskaźnika wczytywania o określonym stanie
Przekaż funkcję lambda progress zwracającą Float z 0.0 do 1.0, aby przekształcić LoadingIndicator w sposób deterministyczny w miarę postępu operacji. Poniższy fragment kodu steruje postępem wskaźnika wczytywania za pomocą Slider i 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), ) } }