数据展示组件
数据展示组件用于以可视化方式呈现设备数据和运行状态。
进度条/进度环
以进度条或进度环的形式展示数值占比。
典型场景: 水箱液位百分比、电机负载率、储能电量显示。
用法:
- 选择进度条(水平/垂直)或进度环形态
- 绑定数据点,组件根据当前值与最大值的比例自动填充
- 可配置标签位置、单位后缀、填充色

数据点
以网格卡片形式批量展示多个数据点的名称与当前值。
典型场景: 设备运行参数总览(温度、压力、转速等)、多测点实时监控面板。
用法:
- 配置行列数确定卡片网格布局
- 绑定数据源后,自动按字段名-值对显示
- 支持分页浏览大量数据点,可自定义键值颜色

状态显示
根据数据值切换颜色和外观的多状态指示灯。
典型场景: 设备运行/停止/故障状态指示、报警级别提示、工艺流程节点状态。
用法:
- 设置状态规则,将数据值映射到不同状态(如 0=停止/绿色,1=运行/蓝色,2=报警/红色)
- 每个状态可配置独立颜色、文字和图标
- 状态灯形状支持圆形、方形等外观形状,状态灯和标签可水平或垂直布局,或将标签至于状态灯内的居中布局

状态表
以表格形式展示设备状态切换历史和工单记录。
典型场景: 设备运行状态历史、工单记录列表、报警日志。
用法:
- 选择设备状态模式(展示状态切换历史及持续时长)或工单模式(展示工单记录)
- 配置列映射和表头样式
- 支持斑马纹、基于健康状态的颜色标记、分页浏览

图表类组件
折线图
以时序折线图展示数据趋势变化。
典型场景: 温度/压力趋势曲线、多通道数据对比、历史数据回放。
用法:
- 绑定一个或多个数据点作为数据系列
- 配置图例位置、坐标轴和网格线
- 支持直线/阶梯线型和区域填充,预览模式下自动采样实时数据
采样与显示参数:
折线图涉及四个关键参数,它们的关系如下:
| 参数 | 说明 | 默认值 |
|---|---|---|
| 采样间隔 | 原始采样值在该时间窗口内聚合为一个采样点(均值/最大值/最小值) | 100ms |
| 聚合方式 | 采样间隔窗口内多个原始值合并为一个采样点的计算方式 | 均值 |
| 缓冲窗口 | 采样点累积到该窗口时长后一次性批量渲染到图表,避免每个采样点都触发重绘,降低渲染开销 | 1000ms |
| 可见时间窗口 | 图表 X 轴上展示的时间跨度,即当前画面能看到多长时间范围内的数据 | 60s |
四者关系: 原始采样值在采样间隔内聚合为采样点,采样点累积到缓冲窗口后批量写入图表减少重绘次数,可见时间窗口决定画面展示范围。增大采样间隔可降低数据量,增大缓冲窗口可减少重绘次数,增大可见时间窗口可以看到更长的历史趋势。

柱状图
以柱状图展示数据对比关系。
典型场景: 各班组产量对比、设备能耗统计、多参数柱状对比。
用法:
- 配置矩阵数据(行×列)绑定到柱状图
- 支持分组和堆叠两种展示模式
- 可设置柱宽、圆角、间距和渐变填充,预览模式下读取实时数据

线性坐标
一维线性刻度轴,适用于单轴位置可视化。
典型场景: 单轴伺服位置显示、滑块行程指示、液位标尺。
用法:
- 绑定数据点,组件在水平或垂直刻度轴上显示当前位置标记
- 支持自动或固定量程、刻度标签、轨迹拖尾效果
- 标记点可使用自定义图片,支持实时数值标签
系列属性: 每条数据系列支持原始零点和换算倍率,用于将原始坐标值换算为实际物理量。计算公式:实际值 = (原始值 - 原始零点) × 换算倍率。

直角坐标
XY 散点/轨迹图,适用于双轴坐标可视化。
典型场景: 双轴伺服运动轨迹、机器人路径规划、XY 平面定位监控。
用法:
- 分别绑定 X 轴和 Y 轴数据点
- 配置轴方向、量程范围和刻度标签
- 支持路径连线、标记点样式(圆形/方形/菱形/图片)、轨迹拖尾渐隐效果
系列属性: 每条数据系列的 X 轴和 Y 轴分别支持原始零点和换算倍率,独立换算各轴的原始坐标值为实际物理量。计算公式:实际值 = (原始值 - 原始零点) × 换算倍率。

仪表盘类组件
液位计
动画液位填充仪表,直观展示容器液位高度。
典型场景: 水箱/油罐液位监控、储料仓料位显示。
用法:
- 选择圆形、矩形或菱形外观
- 绑定数据点,组件以动画水波和气泡效果展示当前液位
- 支持标题标签、数值百分比叠加显示

半圆仪表盘
半圆形仪表盘,通过指针指示当前数值。
典型场景: 压力表、温度表、转速表等模拟仪表显示。
用法:
- 绑定数据点,指针自动指向当前值
- 支持分段刻度和颜色阈值分区
- 可配置指针样式(三角/矩形)、刻度密度、标题和数值显示
