加载指示器会显示短时间等待(通常在 5 秒内完成的操作)的进度。加载指示器有两种配置:
- 默认:无边界的变形形状。
- 包含:在圆形容器内变形的形状。
指示器会在其多边形形状之间持续变形,可以无限期变形,也可以根据进度值变形。
使用加载指示器
- 建议用于替代大多数不确定圆形进度指示器。
- 始终反映正在进行的过程,绝不只是装饰。
- 当进度无法衡量或无需指明活动所需时间时,请使用它们。
- 可用于下拉刷新互动。
- 通过形状变形动作吸引注意力。
示例
实现加载指示器
加载指示器使用动画来吸引注意力、缓解感知延迟,并指示活动正在进行中。以下代码段会呈现默认的不确定 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), ) } }