进度指示器
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。

进度指示器是圆形显示屏,用于显示进程时长或未指定的等待时间。
进度指示器可以显示已完成任务的比例。为显示进度,指示器会沿着顺时针方向的环形轨道呈现动画效果。
您可以将进度指示器应用于播放按钮等组件。
解剖学
进度指示器可以显示已完成任务的比例。为显示进度,指示器会沿着顺时针方向的环形轨道呈现动画效果。
您可以将进度指示器应用于播放按钮等组件。
设计建议
带间隔的进度指示器
创建进度指示器,并留出间隙,以便留出空间来显示时间等重要信息。如需创建间隙,请更改进度指示器的 startAngle 和 endAngle。
小进度指示器
创建进度指示器,并留出间隙,以便留出空间来显示时间等重要信息。通过更改进度指示器的起始角度和结束角度来创建间隔。
不确定进度指示器
在未设置时间的情况下使用进度指示器时,请使用带有动画值的进度指示器。也可称为旋转图标。请谨慎使用旋转图标,因为它们可能会增加用户感知到的等待时间。
使用方法

自适应布局

自适应行为
进度指示器的周长会按比例填满屏幕/元素(用于按钮上的)宽度和高度,而描边宽度在所有断点上都保持不变。
全屏的间隙度保持为 51°,但扫描将根据屏幕尺寸而增加 dp。
环形宽度以及起点和终点均可自定义。

本页面上的内容和代码示例受内容许可部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-27。
[null,null,["最后更新时间 (UTC):2025-07-27。"],[],[],null,["# Progress indicator\n\n[Progress indicators](/reference/kotlin/androidx/wear/compose/material/package-summary#CircularProgressIndicator(kotlin.Float,androidx.compose.ui.Modifier,kotlin.Float,kotlin.Float,androidx.compose.ui.graphics.Color,androidx.compose.ui.graphics.Color,androidx.compose.ui.unit.Dp)) are circular displays of the length of a process or an otherwise unspecified wait time. \nUse progress indicators to show the proportion of a task that is complete. To show progress an indicator is animated along a circular track in a clockwise direction. \n\nYou can apply progress indicators to components such as a play button.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nAnatomy\n-------\n\nUse progress indicators to show the proportion of a task that is complete. To show progress an indicator is animated along a circular track in a clockwise direction. \n\nYou can apply progress indicators to components such as a play button.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n**Design recommendations**\n--------------------------\n\n**Progress indicator with gap**\n\n\u003cbr /\u003e\n\n\nCreate progress indicators with a gap to leave space for important information such as the time. To create a gap, change the progress indicator's startAngle and endAngle.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n**Small progress indicator**\n\n\u003cbr /\u003e\n\n\nCreate progress indicators with a gap to leave space for important information such as the time. Create a gap by changing the progress indicator's start and end angle.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n**Indeterminate progress indicator**\n\n\u003cbr /\u003e\n\n\nWhen using the progress indicator for situations where there is no set time, use a progress indicator with animated value. This can also be called a spinner. Use spinners sparingly as they can increase perceived wait time.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nUsage\n-----\n\nAdaptive layouts\n----------------\n\nResponsive behavior\n-------------------\n\nThe circumference of the progress indicator fills the screen/element (for on button) width and height, proportionally, while the stroke width remains the same across all breakpoints. \n\n\nThe gap degree for full screen stays at 51°, but the sweep will increase in dp based on the screen size. \n\nThe ring width and starting and end points are customisable."]]