Chỉ báo đang tải

Chỉ báo tải cho biết tiến trình trong thời gian chờ ngắn, thường là các thao tác hoàn tất trong vòng chưa đầy 5 giây. Có hai cấu hình của chỉ báo tải:

  1. Mặc định: Hình dạng biến đổi không chứa nội dung.
  2. Chứa: Biến đổi hình dạng trong vùng chứa hình tròn.
Cấu hình mặc định và cấu hình chứa chỉ báo tải
Hình 1. Chỉ báo tải mặc định và chỉ báo tải có vùng chứa.

Chỉ báo liên tục biến đổi giữa các hình dạng đa giác, vô thời hạn hoặc theo giá trị tiến trình.

Sử dụng chỉ báo đang tải

  • Được đề xuất để thay thế cho hầu hết các chỉ báo tiến trình vòng tròn không xác định.
  • Luôn phản ánh một quy trình đang diễn ra và không bao giờ chỉ mang tính trang trí.
  • Hãy sử dụng các chỉ báo này khi không thể đo lường tiến trình hoặc khi không cần cho biết thời gian thực hiện một hoạt động.
  • Có thể dùng cho các hoạt động tương tác kéo để làm mới.
  • Thu hút sự chú ý thông qua chuyển động biến đổi hình dạng.

Ví dụ

Triển khai chỉ báo đang tải

Chỉ báo tải sử dụng ảnh động để thu hút sự chú ý, giảm độ trễ nhận biết được và cho biết rằng một hoạt động đang diễn ra. Đoạn mã sau đây hiển thị một LoadingIndicator mặc định không xác định:

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

Triển khai chỉ báo tải có vùng chứa

Sử dụng ContainedLoadingIndicator để kết xuất các hình dạng biến đổi bên trong một vùng chứa hình tròn, giúp tăng độ tương phản so với nội dung chính. Đoạn mã sau đây triển khai chỉ báo tải có vùng chứa:

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

Triển khai chỉ báo tải xác định

Truyền một hàm lambda progress trả về Float từ 0.0 đến 1.0 để biến đổi LoadingIndicator một cách dứt khoát khi một thao tác diễn ra. Đoạn mã sau đây thúc đẩy tiến trình của chỉ báo tải bằng Slider và 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),
        )
    }
}