进度条 basic-progress

数值进度，支持环形 / 条形 / 柱形，可绑字段。

• 类型串：basic-progress　默认尺寸：[200, 200]　分类：控件

实时预览

下面渲染的是真实组件（与编辑器 / 运行时同源）。修改右侧「样式参数」，左侧预览实时更新；点击底部「全页面查看」可放大。

属性

下表为本组件特有的属性；position / size / opacity / background / border / 联动选中 / 筛选等通用参数见组件手册总览。

value

属性	名称	类型	默认	说明
static-value	固定值	number	60
max-value	最大值	number(min=0)	100

shape

属性	名称	类型	默认	说明
shape	形状	select(radioGroup)	ring	可选：rect / column / ring
progress-color	进度颜色	color(gradient)	#1890FF
shape-background	轨道颜色	color(gradient)	#E6F3F7
bar-shape	条形样式	select(radioGroup)	normal	可选：normal / burst / bold
bar-shape_burst-number	分段数量	number(min=1,unit=段)	20
bar-shape_burst-interval	分段间隔	number(min=0,unit=px)	6
background-shape_burst	显示空段轨道	boolean	true
fill-border-radius	圆角	number(unit=px,min=0)	0
data-start-angle	起始角度	number(min=-360,max=360,step=1,unit=°)	-90
data-end-angle	结束角度	number(min=-360,max=360,step=1,unit=°)	270
ring-size	环宽度	number(min=0,max=100,unit=%)	25

label-group

属性	名称	类型	默认	说明
label	显示标签	boolean	true
label-position	标签位置	select(radioGroup)	outside	可选：inside / outside / top
label-font	字体	font	{"size":14,"color":"#ffffff"}
label-offset	文本偏移	vector<X,Y>(unit=px)	[0,0]
label-text-type	数据格式	select(radioGroup)	percent	可选：normal / percent
label-unit	单位	string	—
label-decimal-places	小数位数	number(min=0)	0
label-complete-zero	末尾补零	boolean	false

数据绑定

字段槽	类型 / 约束	说明
value-field	field(recommend=number,min=0,max=1)	数值

事件

触发器

触发器在预览 / 播放态生效（编辑态点击 = 选中组件）。写在本组件 options.interactions 的 groups[].trigger 里。

触发器	名称	触发时机	payload（供动作公式 {:字段} 取值）
click	点击	点击本组件时触发	无
mouseEnter	鼠标移入	指针移入组件时触发	无
mouseLeave	鼠标移出	指针移出组件时触发	无
appear	入场	组件出现时触发（配合进场动画）	无
disappear	离场	组件消失时触发（配合退场动画）	无
receiveBehaviorEvent	接收行为事件	收到 sendBehaviorEvent 动作或宿主 ctx.emit 投递的事件时触发（按 eventName 匹配）	发送方携带的 data

动作

触发器命中后执行的动作。本组件既可发起动作（配在自己的交互里），也可作为其它组件动作的目标。

动作	名称	说明
changeOption	修改设置	把本组件（或其它组件）的某个属性改为静态值 / 公式动态值
switchState	切换状态	切到多状态里的某个状态（state:"" 回默认态）
appear / disappear	进 / 退场动画	对目标 opacity 做 0↔100 插值的显隐动画

完整动作清单（switchScreen / switchWindow / openUrl / sendBehaviorEvent / transfer / executeScript / requestApi 等）与持久化写法见事件交互。

示例

{
  "type": "basic-progress",
  "uid": "w_basic_progress",
  "options": {
    "position": [40, 40],
    "size": [200, 200],
    "value-field": [["conn_demo", "tbl_demo", "字段名"]]
  }
}

绑定三元组 [连接uid, 表uid, 字段uid] 指向工程 connections 里的真实字段，见数据系统。

变体示例：环形 / 条形 / 柱形三种形状

延伸阅读：组件手册总览 · 数据系统 · 事件交互。