组件

本章节介绍部分组件存在的配置注意事项以及部分组件静态数据格式！

文本

• 配置属性：

属性	作用	类型
字体	修改文字字体	select
行高	修改文字在容器中的行高，为0时则垂直居中	数值

• 数据格式：

字段	说明	类型
value	显示的文本内容	字符

iframe

iframe组件要求目标页面开启允许iframe嵌入，否则无法显示！

视频

支持播放在线视频链接和本地上传的视频，对接实时监控或直播需要修改源代码。 2.7.8版本之后支持从数据中读取视频地址，若数据中指定了地址则配置栏中地址不生效

• 数据格式：

字段	说明	类型
value	视频地址，当配置中选择本地视频时地址为上传后返回的路径(如:/video/202508/c0add0f2.mp4)，当选择在线视频时地址为http链接	字符

轮播图

拖动后默认没有图片显示，需要在配置栏中自行添加轮播图片，2.7.8版本之后支持从数据中读取图片地址，若数据中指定了地址则配置栏中的图片不生效

• 数据格式：

字段	说明	类型
value	图片地址，可在图片资源管理页面查看(如:/imgPool/202508/add0f2.png)	字符

滚动表格

已知bug：设计时调整了表格列宽后需要重新拉伸一下表格组件宽度，否则列数据会重叠，预览时不存在此问题。

高级操作：可在数据中可通过关键字控制指定行列字段字体颜色：

关键字	说明	类型
TBCONFIG_FILED	需要指定的列字段(多个用,隔开)	字符
TBCONFIG_COLOR	需要指定的列字段的字体颜色	字符
TBCONFIG_BG_COLOR	当前行背景颜色(v2.6.4)	字符

示例：控制第一行和第二行某一字段的颜色

天气

天气组件可显示当前城市或指定城市天气图标，需要连接互联网才能取到数据，默认数据来源由 心知天气 提供，交付的软件使用个人注册的免费版，有调用限制，私有化部署时请购买官方套餐并更换API-KEY。

配置栏API-KEY未填写时，则使用后台jar包内置的APIKEY(此为免费版，api请求额度有限)，可以在后端application-prod.yml配置中添加以下内容并重启jar包。若前端配置栏填写了API-KEY则优先使用。

seniverse: 
  key: '您的key'

省份和城市默认未选择，未选择时使用IP进行定位。鼠标放置在天气图片上时会显示具体的省份和城市。

ps:

心知天气API文档：https://seniverse.yuque.com/hyper_data/api_v3/nyiu3t

心知天气价格：https://seniverse.yuque.com/hyper_data/api_v3/nyiu3t

双Y轴折线柱状图

数据格式：

字段	说明	类型
group	分组标识	String
y	数据对应哪个y轴，可选"L"和"R"	String
unit	数值单位，可为空	String
type	渲染类型，可选"line"(折线)和"bar"(柱)	String
data	渲染的数据	Data

Data:

字段	说明	类型
name	数据名称，对应X轴显示	String
value	数值，对应Y轴显示	Number

渐变地图&3D地图

渐变地图与3D地图支持2种数据格式，当数据中指定了cityCode字段时则组件展示对应的地图，此时配置栏中的城市和省份配置不生效，cityCode可以是区域代码也可以是区域名称。

格式1：Array[MapData]

MapData:

字段	说明	类型
name	区域名称，对应地图上显示的，如如广东、成都市	String
value	区域数值，数值不同，区域颜色不同(参考配置)	Number

格式2：

字段	说明	类型
cityCode	显示的地图区域代码如110100或北京市	String
mapData	地图色块数据	Array[MapData]

MapData:

字段	说明	类型
name	区域名称，对应地图上显示的，如如广东、成都市	String
value	区域数值，数值不同，区域颜色不同(参考配置)	Number

飞线地图&3D飞线地图

数据格式：

字段	说明	类型
lines	飞线数据	Array[Line]
bars	地图覆盖物数据	Array[Bar]
mapData	地图色块数据	Array[MapData]

Line:

字段	说明	类型
start	起点经纬度，经度在前，维度在后	Array[Number]
end	终点经纬度，经度在前，维度在后	Array[Number]

Bar:

字段	说明	类型
name	覆盖物名称	String
lct	地点经纬度，经度在前，维度在后	Array[Number]
value	覆盖物数值，鼠标移上覆盖物时显示	Number

MapData:

字段	说明	类型
name	区域名称，对应地图上显示的，如如广东、成都市	String
value	区域数值，数值不同，区域颜色不同(参考配置)	Number