更新时间:2026-03-16 GMT+08:00
分享

设置UI引擎前端页面仪表盘组件属性

仪表盘组件是一种用于直观展示单个指标值的可视化工具,广泛应用于设备状态监控、生产效率分析等。该组件支持自定义进度条样式、刻度范围、图表位置等属性,可结合实时数据源实现动态渲染,助力用户快速判断指标是否在合理区间。

前提条件

已在当前页面添加“仪表盘”组件,具体操作请参见为UI引擎前端页面添加物料组件

配置入口

  1. 在页面设计器的中心画布区,单击选中“仪表盘”组件。
  2. 在右侧设置面板中,单击,即可展开“属性”设置面板。

基础属性

属性名称

说明

支持状态变量绑定

图表数据

配置仪表盘的数据源,数据格式为长度固定为1的数组,数组内对象需包含“name”(指标名称)和“value”(指标数值)两个字段。示例:

[ { name: 'Jan', value: 20 } ]

颜色

设置调色盘颜色列表,仪表盘将从数组中依次循环取用颜色渲染进度条。可根据指标区间配置差异化颜色(如正常范围用绿色、警戒范围用黄色、超标范围用红色),通过变量绑定实现颜色随数值动态切换,提升异常识别效率。

进度条样式

自定义仪表盘进度条及刻度线样式,值为对象类型,支持以下配置项:

  • width:进度条宽度,单位为像素,可根据图表尺寸调整,避免过宽或过窄影响视觉效果。
  • lineStyle:刻度线样式,为配置对象。包含三个子属性:
    • width:刻度线宽度(像素),建议设置为1-2px,确保清晰可见。
    • color:刻度线颜色,选用与进度条、背景对比明显的颜色(如深色背景用白色刻度线)。
    • length:刻度线长度(像素),用于区分主刻度与副刻度,提升读数准确性。

图表位置及大小

控制仪表盘的中心位置与半径大小,值为对象类型。

  • center:图表中心位置,值为数组类型,支持百分比或绝对数值,示例:['50%','50%'](容器居中)、[200, 200](像素定位)。

    百分比配置时,第一项对应容器宽度占比,第二项对应容器高度占比,适配不同尺寸终端。

  • radius:仪表盘半径,支持百分比或绝对数值。

    百分比以容器宽高中较小值的一半为基准计算,绝对数值单位为像素,可根据页面布局调整,确保与其他组件协调。

最小刻度

设置仪表盘的数值最小值。

最大刻度

设置仪表盘的数值最大值。

图表容器宽度

设置仪表盘容器的宽度,支持像素单位(如300px)或视口宽度单位(如30vw)。

图表容器高度

设置仪表盘容器的高度,支持像素单位(如300px)或视口高度单位(如30vh),建议与容器宽度保持一致,确保仪表盘为标准圆形,提升视觉协调性。

显示加载状态

控制是否启用加载状态。

暂无数据

控制无数据时是否显示占位提示。

其他

如下属性适用于UI引擎所有组件,用于精细化控制。

属性名称

说明

是否支持变量绑定

元素id值

对应HTML标签的“id”属性,同一页面内必须唯一。

样式类

对应HTML标签的“class”属性,为空格分隔的类名列表,用于自定义组件样式。默认为“component-base-style”

ref引用类

对应Vue的“ref”属性,用于注册模板引用以访问组件实例方法。

如果为“数据源表单”组件,会自动填充默认值。

相关文档