Wskaźniki wczytywania

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:

  1. Domyślne: nieograniczone kształty zmieniające się.
  2. W ramach: kształty zmieniające się w okrągłym kontenerze.
Domyślne i zawarte konfiguracje wskaźników wczytywania
Rysunek 1. Domyślne i zawarte wskaźniki wczytywania.

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