ProgressBar 进度条

属性名	类型	默认值	说明
`loading`	`boolean`	`false`	不确定的加载模式。
`indeterminate`	`boolean`	`false`	不确定进度模式，不表示加载。
`indeterminateVariant`	`'classic' \| 'sweep' \| 'bounce' \| 'elastic' \| 'split'`	`'sweep'`	loading / indeterminate 状态的动画。
`error`	`boolean`	`false`	错误状态，优先于 `status`。
`success`	`boolean`	`false`	成功状态，优先于 `status`。
`status`	`'success' \| 'error' \| 'warning' \| ''`	`''`	状态色。
`message`	`string`	`''`	可见文本，同时作为可访问名。
`detail`	`string`	`''`	次要文案，只在 `textPlacement="top"` 下显示，不进入可访问名。
`ariaLabel`	`string`	`''`	可访问名；未设置时回退到 `message`，再到 `'Progress'`。
`percentage`	`number`	`0`	确定进度值，钳制到 `0..100`。
`segments`	`ProgressSegment[]`	-	多段进度数据。
`segmentsTotal`	`number`	`100`	有 `segments` 时计算填充宽度的总量。
`height`	`string`	`'5px'`	进度条高度。
`showText`	`boolean`	`false`	确定进度下显示百分比文本。
`textPlacement`	`'inside' \| 'outside' \| 'top'`	`'inside'`	文本位置；`top` 在轨道上方显示文案行与 `detail`。
`format`	`(percentage: number) => string`	-	自定义百分比文本。
`flowEffect`	`'none' \| 'shimmer' \| 'wave' \| 'stardust' \| 'particles'`	`'none'`	填充动效；`particles` 是 `stardust` 的废弃别名，对 `segments` 无效。
`indicatorEffect`	`'none' \| 'sparkle'`	`'none'`	进度大于零时的端点效果。
`hoverEffect`	`'none' \| 'glow'`	`'none'`	外层悬停效果。
`color`	`string`	-	自定义填充色，优先于状态色；渐变字符串原样使用。
`maskVariant`	`'solid' \| 'dashed' \| 'plain'`	`'plain'`	轨道描边；`plain` 不画描边。
`maskBackground`	`'none' \| 'blur' \| 'glass' \| 'mask'`	`'none'`	轨道遮罩层；`none` 不渲染遮罩节点。
`tooltip`	`boolean`	`false`	以解析后的文本显示 tooltip。
`tooltipContent`	`string`	-	覆盖 tooltip 内容。
`tooltipProps`	`Partial<TooltipProps>`	-	透传给 `TxTooltip` 的 props。

事件

事件名	参数	说明
`complete`	-	进度达到 `100` 时每个完成周期触发一次；回落后再次完成会再触发。

类型

ProgressSegment：

字段	类型	说明
`value`	`number`	段值；只渲染正的有限数。
`color`	`string`	段填充色，默认回退为进度条填充色。
`label`	`string`	悬停提示中位于占比之前（`视频 · 25%`）；省略时只显示占比。

概述

轨道为 role="progressbar"（aria-valuemin="0"、aria-valuemax="100"）；aria-valuenow 取钳制后的进度，loading、indeterminate 时省略。
文本依次取 message、format、四舍五入的百分比；只有设置 message 或 showText 时显示，loading、indeterminate 时只显示 message。
success 或 error 带 message 且 percentage 为 0 时，填充宽度按 100% 计算。
分段忽略非正值：整体填充宽度按 segmentsTotal 计算，各段宽度按正值之和归一化。
宽度变化以 480ms 过渡；不确定态动画只改 transform 与 opacity，减少动态效果时停止。

技术实现

填充默认是由淡到饱和的 linear-gradient，端点柔光只在 0% 与 100% 之间显示；渐变 color 的柔光为白色。
hoverEffect="glow" 与 indicatorEffect="sparkle" 位于 overflow: hidden 的轨道内，会被裁到轨道高度。
源码：packages/tuffex/packages/components/src/progress-bar/。

查看源码

packages/tuffex/packages/components/src/progress-bar/index.ts