“正在加载”指示器

加载指示器会显示短时间等待(通常在 5 秒内完成的操作)的进度。加载指示器有两种配置:

  1. 默认:无边界的变形形状。
  2. 包含:在圆形容器内变形的形状。
加载指示器的默认配置和包含的配置
图 1. 默认和包含的加载指示器。

指示器会在其多边形形状之间持续变形,可以无限期变形,也可以根据进度值变形。

使用加载指示器

  • 建议用于替代大多数不确定圆形进度指示器。
  • 始终反映正在进行的过程,绝不只是装饰。
  • 当进度无法衡量或无需指明活动所需时间时,请使用它们。
  • 可用于下拉刷新互动。
  • 通过形状变形动作吸引注意力。

示例

实现加载指示器

加载指示器使用动画来吸引注意力、缓解感知延迟,并指示活动正在进行中。以下代码段会呈现默认的不确定 LoadingIndicator:

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

实现包含式加载指示器

使用 ContainedLoadingIndicator 在圆形容器内呈现变形形状,从而与正文内容形成更鲜明的对比。以下代码段实现了一个包含式加载指示器:

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

实现确定性加载指示器

将一个返回 Float 的 progress lambda 从 0.0 传递给 1.0,以便在操作进行时确定性地变形 LoadingIndicator。以下代码段使用 Slider 和 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),
        )
    }
}