Yükleme göstergeleri

Yükleme göstergeleri, kısa bir bekleme süresi (genellikle beş saniyeden kısa sürede tamamlanan işlemler) için ilerleme durumunu gösterir. Yükleme göstergelerinin iki yapılandırması vardır:

  1. Varsayılan: Sınırlanmamış şekil değiştiren şekiller.
  2. Sınırlı: Dairesel bir kapsayıcı içinde şekil değiştirme.
Yükleme göstergelerinin varsayılan ve kapsayıcı yapılandırmaları
Şekil 1. Varsayılan ve kapsayıcı yükleme göstergeleri.

Gösterge, süresiz olarak veya bir ilerleme değerine yanıt olarak sürekli olarak çokgen şekilleri arasında değişir.

Yükleme göstergelerini kullanma

  • Çoğu belirsiz dairesel ilerleme göstergesinin yerine kullanılması önerilir.
  • Her zaman devam eden bir süreci yansıtır ve hiçbir zaman tamamen dekoratif değildir.
  • İlerleme ölçülebilir olmadığında veya bir etkinliğin ne kadar sürdüğünü belirtmek gerekmediğinde bunları kullanın.
  • Yenilemek için kaydırma etkileşimlerinde kullanılabilir.
  • Şekil değiştiren hareketlerle dikkat çekin.

Örnekler

Yükleme göstergesi uygulama

Yükleme göstergeleri; dikkat çekmek, algılanan gecikmeyi azaltmak ve bir etkinliğin devam ettiğini belirtmek için animasyon kullanır. Aşağıdaki snippet, varsayılan belirsiz bir LoadingIndicator oluşturur:

@Composable
fun LoadingIndicatorSample() {
    Column(horizontalAlignment = Alignment.CenterHorizontally) { LoadingIndicator() }
}

Kapsayıcı yükleme göstergesi uygulama

Gövde içeriğine göre daha fazla kontrast sağlayan dairesel bir kapsayıcıda şekil değiştirme efektini oluşturmak için ContainedLoadingIndicator kullanın. Aşağıdaki snippet, kapsayıcı yükleme göstergesini uygular:

@Composable
fun ContainedLoadingIndicatorSample() {
    Column(horizontalAlignment = Alignment.CenterHorizontally) { ContainedLoadingIndicator() }
}

Belirli bir yükleme göstergesi uygulama

Bir işlem ilerledikçe LoadingIndicator öğesini kesin olarak dönüştürmek için 0.0 ile 1.0 arasında Float döndüren bir progress lambda iletin. Aşağıdaki snippet, Slider ve rememberSliderState ile yükleme göstergesinin ilerleme durumunu gösterir:

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