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:
- Varsayılan: Sınırlanmamış şekil değiştiren şekiller.
- Sınırlı: Dairesel bir kapsayıcı içinde şekil değiştirme.
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), ) } }