value | number | 0 | value={42} | 百分比进度,自动 clamp 到 0–100 |
variant | ProgressVariant | "line" | variant={value} | 长条形或圆形 |
size | number | string | 16 | size="Example" | 圆形宽高;与 Spinner 默认一致 |
thickness | number | string | — | thickness="Example" | 长条形高度或圆环粗细;circle / 不确定态对齐 Spinner 环宽 默认行为:line 确定态 4;circle 与不确定态为 size 的 15%(size=16 时 2.4px)。 |
background | SnowUIColor | string | "Black4" | background="Example" | 轨道底色 |
color | SnowUIColor | string | "Primary" | color="Example" | 填充颜色 |
isIndeterminate | boolean | false | isIndeterminate | 不确定态 |
showLabel | boolean | false | showLabel | 仅 circle 生效;确定态下生成显示实时 value 的内置 Text |
loopMotion | LoopMotionConfig | — | loopMotion={{ duration: 1200 }} | 覆盖不确定态循环时序 |
children | Snippet | — | <Progress value={60}><Frame as="label">…</Frame></Progress> | 显式 label 组合;存在时替换 circle 内置 label |
parts | ComponentPartsOf<{ Text: typeof Text }> | — | parts={{ Text: { color: "Black100" } }} | 配置 circle 的内置 Text label |