覆盖主要内容
版本: 下个版本

单张图片

单张图片是媒体组件的一种，支持自定义图片的URL地址和跳转链接，能够为可视化应用和其他组件添加自定义的背景图，使操作更加智能，可视化应用更加美观。本文介绍单张图片各配置项的含义。

配置​

  • 背景图：您可以输入图片的url地址或单击图片区域内的更改上传图片，也可以单击图片区域删除当前图片后再次单击上传本地图片。同时也可以在数据面板中的img字段中配置背景图的url地址。如果配置面板和数据面板都配置了图片，则优先使用数据面板中的图片配置。
  • 图片重复：背景图的重复方式，可选不重复，拉伸满、水平和垂直重复、水平重复和垂直重复。
  • 圆角：图片的圆角大小，取值范围为0~360。数值为0的时候图片为方形，数值为360时图片为圆形。
  • 超链接配置：配置后，在预览或发布页面，单击图片区域会跳转至指定的超链接。
参数说明
超链接您可以设置单击后跳转页面的URL，也可以在数据面板中的url字段中进行配置。如果配置和数据面板中都配置了超链接，则优先使用数据面板中的配置。
是否新开窗口打开开关，单击背景图可以新开一个标签页打开背景图的超链接；关闭开关，直接在当前页面打开超链接。

数据

示例代码如下。

[
  {
    "img": "https://uniplore-source.oss-cn-chengdu.aliyuncs.com/bigscreen/MainImage/defaultimg.png",
    "url": "http://www.uniplore.cn/"
  }
]

表 1. 字段说明​

字段说明
img（可选）设置展示的图片，会覆盖掉背景图中的配置。如果该字段为空，会读取配置中的背景图进行展示。
url（可选）设置单击后跳转页面的URL，会覆盖掉超链接中的配置。如果该字段为空，会读取配置中的超链接进行跳转。

表 2. 配置项说明​

配置项说明
数据源点击数据源下拉框，可以修改数据源类型。详情请查看配置组件数据。
刷新数据点击刷新数据，组件会按照设置请求最新数据。
查看响应数据点击查看响应数据按钮，会将组件数据展示出来。
受控模式打开开关，组件初始化状态下不请求数据，仅通过回调id或蓝图编辑器配置的方法发起请求数据；关闭开关，可以使用自动更新请求数据。
自动更新请求选中后可以设置动态轮询，还可以手动输入轮询的时间频次。

交互​

交互事件说明
当点击图片时选中启用，开启组件交互功能。当单击图片时，会触发数据请求，抛出回调值，动态加载图片的数据。默认抛出数据中的img和url值，具体配置请参见回调ID实现图表联动功能。
当鼠标移入时选中启用，开启组件交互功能。当鼠标移入到图片时，会触发数据请求，抛出回调值，动态加载图片的数据。默认抛出数据中的img和url值，具体配置请参见回调ID实现图表联动功能。
当鼠标移出时选中启用，开启组件交互功能。当鼠标移出图片时，会触发数据请求，抛出回调值，动态加载图片的数据。默认抛出数据中的img和url值，具体配置请参见回调ID实现图表联动功能。

蓝图编辑器交互配置​

  1. 在画布编辑器页面，右键单击组件，选择导出到蓝图编辑器。
  2. 单击页面左上角的蓝图图标。
  3. 在蓝图编辑器配置页面，单击导入节点栏内的单张图片组件，在画布中可以看到如下图所示的单张图片的蓝图编辑器配置参数。![image.png]

事件​

事件说明
当数据接口请求完成时数据接口请求返回并经过过滤器处理后抛出的事件，同时抛出处理后的JSON格式的数据。具体数据可参见上文的数据示例。
当点击图片时当单击单张图片组件的图片时抛出的事件，同时抛出该图片对应的数据项。
当鼠标移入时当鼠标移入到图片时抛出的事件，同时抛出该图片对应的数据项。
当鼠标移出时当鼠标移出图片时抛出的事件，同时抛出该图片对应的数据项。

动作​

动作说明
请求数据接口重新请求服务端数据，上游数据处理节点或图层节点抛出的数据将作为参数。例如单张图片配置了API数据源为http://api.test/?id=:id，传到请求数据接口动作的数据为{ id: '1'}，则最终请求接口为http://api.test?id=1。
导入数据接口按组件绘制格式处理数据后，导入组件，重新绘制。不需要重新请求服务端数据。具体数据可参见上文的数据示例。
更新组件配置动态更新组件的样式配置。需要先在组件的配置面板中，单击复制配置到剪贴板，获取组件配置数据。再根据需要在蓝图编辑器配置页面的数据处理节点中更改对应样式的字段值。
显示显示组件，不需要参数。
隐藏隐藏组件，不需要参数。
切换显隐状态切换组件显示或者隐藏。
移动将组件移动到指定位置。{// 移动方式。绝对定位：to，相对定位：by。默认值：to。"positionType": "to",// 指定位置。x坐标，y坐标。"attr": {"x": 0,"y": 0},// 动画方式。"animation": {"enable": false,// 动画延时。"animationDuration": 1000,// 动画曲线。可选值为：linear|easeInOutQuad|easeInOutExpo。"animationEasing": "linear"}}
最后一次更新 更新于