ProgressBar 进度条

通用布局能力：RenderProgressBarOptions 继承 RenderBoxOptions，可直接配置 width、height、min/max、margin 和槽位对齐，也可在创建后赋值。详见组件通用布局属性。

LIVE CANVAS可运行组件示例

ON-DEMAND RUNTIME交互式示例将在进入视区时启动避免文档首屏同时初始化多个 Canvas Runtime

RenderProgressBar 用于展示确定进度或不确定进行中状态。它适合文件上传、导入导出、后台任务、批处理和加载步骤，不负责启动任务、轮询任务状态或取消任务。

API 总览

import {  RenderProgressBar,  type Color,} from 'ds-ui'

API	类型	用途
`RenderProgressBar`	class	胶囊形进度条。支持 `0..1` 确定进度、`-1` 不确定动画、自定义颜色和标签。
`Color`	type	自定义进度颜色。

最小装配顺序是：创建 RenderProgressBar({ value })，任务进度变化时设置 value 或调用 setValue()。传入负数会进入 indeterminate 模式。

使用 ProgressBar：

不要使用：

import { RenderProgressBar } from 'ds-ui' const progress = new RenderProgressBar({  value: 0.35,  label: '正在导入',}) progress.setValue(0.8)

import { RenderProgressBar } from 'ds-ui' const progress = new RenderProgressBar({  value: -1,  label: '正在连接...',}) progress.stopIndeterminate(1)

value < 0 会调用 startIndeterminate()，显示滑动光条。任务结束后调用 stopIndeterminate(finalValue) 或把 value 设置为 0..1。

API	类型 / 返回值	说明
`value`	`number`	当前进度。赋负数进入不确定模式；赋 `0..1` 停止不确定动画。
`label`	`string`	居中文本。为空时显示百分比。
`color`	`Color \| undefined`	自定义进度色。
`height`	`number`	当前高度。
`setValue(value)`	`void`	设置进度，等同于给 `value` 赋值。
`startIndeterminate()`	`void`	启动不确定动画。
`stopIndeterminate(finalValue?)`	`void`	停止不确定动画，并设置最终进度。
`dispose()`	`void`	停止动画 timer 并释放资源。