轮播图
轮播图是媒体组件的一种，支持自定义轮播图片、轮播动画效果等，能够在可视化应用中展示多张图片轮流播放的效果。本文介绍轮播图各配置项的含义。
配置
- **全局样式 **
| 参数 | 说明 |
|---|---|
| 字体 | 组件中所有文本的字体。请选择已安装于本机中的字体，否则以默认字体显示。 |
| 字号 | 组件中所有文本的字体大小，取值范围为10~100。 |
- **动画 **
| 参数 | 说明 |
|---|---|
| 自动轮播 | 打开开关，开启图片自动轮播；关闭开关，图片不轮播。 |
| 停顿 | 图片停留展示的时间，单位为ms。 |
| 速度 | 图片轮播时动画效果持续时间，单位为ms。 |
| 特效 | 动画播放的效果，可选：水平滚动、垂直滚动、 淡入淡出、马赛克。 |
- 图片
| 参数 | 说明 |
|---|---|
| 默认图片 | 轮播图默认显示的图片，将本地图片拖动到虚线框内或者输入图片的url地址。可单击虚线框内删除图标删除当前图片。 |
| 填充方式 | 图片的填充方式，可选：拉伸以充满容器、充满容器、居中。 |
- 描述：轮播图中每张图片的描述样式，可单击眼睛图标控制描述的显隐。
- 背景颜色：描述模块的背景颜色。
| 参数 | 说明 |
|---|---|
| 颜色样式 | 背景颜色的样式，可选：渐变、单色。 |
| 开始颜色 | 背景的开始颜色，仅当颜色样式为渐变时有效。 |
| 结束颜色 | 背景的结束颜色，仅当颜色样式为渐变时有效。 |
| 角度 | 开始到结束两个颜色渐变的方向，仅当颜色样式为渐变时有效。 |
-
文字颜色：描述文本的颜色。
-
字体粗细：描述文本的字体粗细。
-
长度：描述栏占组件长度的百分比，单位为%。
-
高度：描述栏占组件宽度的百分比，单位为%。
-
上边距：描述栏距离组件上边界的距离，单位为px。
-
下边距：描述栏距离组件下边界的距离，单位为px。
-
对齐方式：描述文本的对齐方式，可选：向左、居中、向右。
-
圆点：轮播图底部的圆点样式，可单击眼睛图标控制圆点的显隐。
| 参数 | 说明 |
|---|---|
| 圆点颜色 | 未选中图片的圆点颜色。 |
| 当前颜色 | 当前页面的圆点颜色。 |
数据
上图中的示例数据如下：
[
{
"description": "这是第一张图片的描述",
"url": "https://u394122-05f3f5f3df8047ea9332a043118bd550.ktb.wqdian.net/qngroup001%2Fu394122%2F1%2F0%2Fc080054171aa4a43a2e226c0ba10f340.jpg"
},
{
"description": "这是第二张图片的描述",
"url": "http://u394122-05f3f5f3df8047ea9332a043118bd550.ktb.wqdian.net/qngroup001%2Fu394122%2F1%2F0%2F1e97bb82b0794668aa004153e3b45ffc.jpg"
}
]
表 1. 字段说明
| 字段 | 说明 |
|---|---|
| url | 轮播图片的url，与图片 > 默认图片配置项功能相同。如果同时配置，则以url中的内容为准**。** |
| description | （可选）图片的描述内容。 |
表 2. 配置项说明
| 配置项 | 说明 |
|---|---|
| 数据源 | 点击数据源下拉框，可以修改数据源类型。详情请查看配置组件数据。 |
| 刷新数据 | 点击刷新数据，组件会按照设置请求最新数据。 |
| 查看响应数据 | 点击查看响应数据按钮，会将组件数据展示出来。 |
| 受控模式 | 打开开关，组件初始化状态下不请求数据，仅通过回调id或蓝图编辑器配置的方法发起请求数据；关闭开关，可以使用自动更新请求数据。 |
| 自动更新请求 | 选中后可以设置动态轮询，还可以手动输入轮询的时间频次。 |
交互
选中启用，开启组件交互功能。当单击图片时，会触发数据请求，抛出回调值，动态加载轮播图的数据。默认抛出数据中的description和url值，具体配置请参见回调ID实现图表联动功能。
蓝图编辑器交互配置
- 在画布编辑器页面，右键单击组件，选择导出到蓝图编辑器。
- 单击页面左上角的蓝图图标。
- 在蓝图编辑器配置页面，单击导入节点栏内的轮播图组件，在画布中可以看到如下图所示的轮播图的蓝图编辑器配置参数。
事件
| 事件 | 说明 |
|---|---|
| 当数据接口请求完成时 | 数据接口请求返回并经过过滤器处理 后抛出的事件，同时抛出处理后的JSON格式的数据。具体数据可参见上文的数据示例。 |
| 当点击图片时 | 当单击轮播图的图片时抛出的事件，同时抛出当前图片描述和地址对应的数据项。 |
动作
| 动作 | 说明 |
|---|---|
| 请求数据接口 | 重新请求服务端数据，上游数据处理节点或图层节点抛出的数据将作为参数。例如轮播图配置了API数据源为[http://api.test/?id=:id](http://api.test/?id=:id)，传到请求数据接口动作的数据为{ id: '1'}，则最终请求接口为[http://api.test?id=1](http://api.test/?id=1)。 |
| 导入数据接口 | 按组件绘制格式处理数据后，导入组件，重新绘制。不需要重新请求服务端数据。具体数据可参见上文的数据示例。 |
| 开始轮播 | 开始轮流播放图片。参数示例如下。{ // 图片在组件数据源中对应的序号，默认从 0 开始计数 "index": 0} |
| 停止轮播 | 停止播放图片，无需参数。 |
| 翻到上一页 | 播放小于当前图片序号的前面一张图片，无需参数。 |
| 翻到下一页 | 播放大于当前图片序号的前面一张图片，无需参数。 |
| 更新组件配置 | 动态更新组件的样式配置。需要先在组件的配置面板中，单击复制配置到剪贴板，获取组件配置数据。再根据需要在蓝图编辑器配置页面的数据处理节点中更改对应样式的字段值。 |
| 显示 | 显示组件，不需要参数。 |
| 隐藏 | 隐藏组件，不需要参数。 |
| 切换显隐状态 | 切换组件显示或者隐藏。 |
| 移动 | 将组件移动到指定位置。{// 移动方式。绝对定位：to，相对定位：by。默认值：to。"positionType": "to",// 指定位置。x坐标，y坐标。"attr": {"x": 0,"y": 0},// 动画方式。"animation": {"enable": false,// 动画延时。"animationDuration": 1000,// 动画曲线。可选值为：linear|easeInOutQuad|easeInOutExpo。"animationEasing": "linear"}} |