Indikator pemuatan

Indikator pemuatan menunjukkan progres untuk waktu tunggu yang singkat—biasanya operasi yang selesai dalam waktu kurang dari lima detik. Ada dua konfigurasi indikator pemuatan:

  1. Default: Bentuk morphing yang tidak dibatasi.
  2. Terkandung: Bentuk yang berubah dalam penampung melingkar.
Konfigurasi default dan yang dimuat dari indikator pemuatan
Gambar 1. Indikator pemuatan default dan yang dimuat.

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