进度指示器

进度指示器以视觉方式显示操作的状态。它们使用动态效果来提示用户进程（例如加载或处理数据）完成的进度。它们也可以表示正在进行处理，而无需参考完成的接近程度。

考虑以下三种可能使用进度指示器的用例

加载内容：从网络获取内容时，例如加载图像或用户个人资料的数据。
文件上传：向用户反馈上传可能需要多长时间。
长时间处理：应用程序正在处理大量数据时，向用户传达已完成的总量。

在 Material Design 中，有两种类型的进度指示器

确定性：准确显示已完成的进度。
不确定性：持续动画，不考虑进度。

同样，进度指示器可以采用以下两种形式之一

线性：从左到右填充的水平条。
圆形：一个圆圈，其描边长度不断增长，直到包含圆圈的整个圆周。

A linear progress indicator alongside a circular progress indicator. — **图 1.** 两种类型的进度指示器。

API 接口

虽然您可以使用多个可组合项来创建与 Material Design 一致的进度指示器，但它们的参数差别不大。您应该记住的关键参数如下：

progress：指示器显示的当前进度。传递 Float 值，范围在 0.0 和 1.0 之间。
color：实际指示器的颜色。也就是说，反映进度并进度完成后完全包含组件的组件部分。
trackColor：指示器绘制在其上的轨道的颜色。

确定性指示器

确定性指示器准确反映操作完成的程度。使用 LinearProgressIndicator 或 CircularProgressIndicator 可组合项，并为 progress 参数传递一个值。

以下代码段提供了一个比较详细的示例。当用户按下按钮时，应用程序同时显示进度指示器，并启动一个协程，逐渐增加 progress 的值。这将导致进度指示器依次递增。

@Composable
fun LinearDeterminateIndicator() {
    var currentProgress by remember { mutableStateOf(0f) }
    var loading by remember { mutableStateOf(false) }
    val scope = rememberCoroutineScope() // Create a coroutine scope

    Column(
        verticalArrangement = Arrangement.spacedBy(12.dp),
        horizontalAlignment = Alignment.CenterHorizontally,
        modifier = Modifier.fillMaxWidth()
    ) {
        Button(onClick = {
            loading = true
            scope.launch {
                loadProgress { progress ->
                    currentProgress = progress
                }
                loading = false // Reset loading when the coroutine finishes
            }
        }, enabled = !loading) {
            Text("Start loading")
        }

        if (loading) {
            LinearProgressIndicator(
                progress = { currentProgress },
                modifier = Modifier.fillMaxWidth(),
            )
        }
    }
}

/** Iterate the progress value */
suspend fun loadProgress(updateProgress: (Float) -> Unit) {
    for (i in 1..100) {
        updateProgress(i.toFloat() / 100)
        delay(100)
    }
}ProgressIndicator.kt

当加载部分完成时，前面示例中的线性指示器显示如下：

同样，圆形指示器显示如下：

不确定性指示器

不确定性指示器不反映操作完成的接近程度。相反，它使用动态效果来向用户指示正在进行处理，但没有指定任何完成程度。

要创建不确定性进度指示器，请使用 LinearProgressIndicator 或 CircularProgressIndicator 可组合项，但不要为 progress 传递值。以下示例演示了如何通过按下按钮来切换不确定性指示器。

@Composable
fun IndeterminateCircularIndicator() {
    var loading by remember { mutableStateOf(false) }

    Button(onClick = { loading = true }, enabled = !loading) {
        Text("Start loading")
    }

    if (!loading) return

    CircularProgressIndicator(
        modifier = Modifier.width(64.dp),
        color = MaterialTheme.colorScheme.secondary,
        trackColor = MaterialTheme.colorScheme.surfaceVariant,
    )
}ProgressIndicator.kt

以下是指示器处于活动状态时的示例：

以下是相同实现的示例，但使用 LinearProgressIndicator 代替 CircularProgressIndicator。

其他资源

Material UI 文档