Indikator pemuatan menunjukkan progres untuk waktu tunggu yang singkat—biasanya operasi yang selesai dalam waktu kurang dari lima detik. Ada dua konfigurasi indikator pemuatan:
- Default: Bentuk morphing yang tidak dibatasi.
- Terkandung: Bentuk yang berubah dalam penampung melingkar.
Indikator terus berubah di antara bentuk poligonnya, baik tanpa batas waktu atau sebagai respons terhadap nilai progres.
Menggunakan indikator pemuatan
- Direkomendasikan sebagai pengganti sebagian besar indikator progres lingkaran yang tidak tentu.
- Selalu mencerminkan proses yang sedang berlangsung dan tidak pernah murni dekoratif.
- Gunakan indikator ini saat progres tidak dapat diukur, atau saat tidak perlu menunjukkan durasi aktivitas.
- Dapat digunakan untuk interaksi tarik untuk memuat ulang.
- Tarik perhatian melalui gerakan perubahan bentuk.
Contoh
Mengimplementasikan indikator pemuatan
Indikator pemuatan menggunakan animasi untuk menarik perhatian, mengurangi latensi yang dirasakan,
dan menunjukkan bahwa aktivitas sedang berlangsung. Cuplikan berikut merender
LoadingIndicator tidak tentu default:
@Composable fun LoadingIndicatorSample() { Column(horizontalAlignment = Alignment.CenterHorizontally) { LoadingIndicator() } }
Menerapkan indikator pemuatan yang dimuat
Gunakan ContainedLoadingIndicator untuk merender bentuk morphing di dalam penampung
melingkar yang memberikan kontras ekstra pada konten isi. Cuplikan berikut
mengimplementasikan indikator pemuatan yang dimuat:
@Composable fun ContainedLoadingIndicatorSample() { Column(horizontalAlignment = Alignment.CenterHorizontally) { ContainedLoadingIndicator() } }
Mengimplementasikan indikator pemuatan pasti
Teruskan lambda progress yang menampilkan Float dari 0.0 ke 1.0 untuk mengubah bentuk
LoadingIndicator secara determinatif seiring berjalannya operasi. Cuplikan berikut
mendorong progres indikator pemuatan dengan Slider dan
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), ) } }