# 设置UI引擎前端页面仪表盘组件属性
仪表盘组件是一种用于直观展示单个指标值的可视化工具，广泛应用于设备状态监控、生产效率分析等。该组件支持自定义进度条样式、刻度范围、图表位置等属性，可结合实时数据源实现动态渲染，助力用户快速判断指标是否在合理区间。
#### 前提条件
已在当前页面添加"仪表盘"组件，具体操作请参见[为UI引擎前端页面添加物料组件](https://support.huaweicloud.com/usermanual-idme/idme_ui_0016.html)。
#### 配置入口
1. 在页面设计器的中心画布区，单击选中"仪表盘"组件。
2. 在右侧设置面板中，单击![](https://support.huaweicloud.com/usermanual-idme/figure/zh-cn_image_0000002503727140.png)，即可展开"属性"设置面板。
 
#### 基础属性
| 属性名称    | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 支持状态变量绑定 |
|:---|:---|:---|
| 图表数据    | 配置仪表盘的数据源，数据格式为长度固定为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"属性，用于注册模板引用以访问组件实例方法。 如果为"数据源表单"组件，会自动填充默认值。 | 是        |