轮播列表 - DataV数据可视化

轮播列表是文字组件的一种，支持各行各列的样式和内容的自定义配置，支持列表内容的超链接配置，同时支持图片格式的列表内容，能够使用轮播动画的方式，将数据信息以列表的形式清晰地展示在可视化应用上。本文介绍轮播列表各配置项的含义。

配置

搜索配置：单击配置面板右上角的搜索配置，可在搜索配置对话框中输入您需要搜索的配置项名称，快速定位到该配置项，系统支持模糊匹配。详情请参见搜索组件配置。
图表尺寸：包括组件的宽度和高度，单位为px。可单击锁定组件的宽高比，等比例修改组件的宽高。再次单击进行解锁，解锁后宽高比不受限制。
图表位置：包括组件的横坐标和纵坐标，单位为px。横坐标为组件左上角距离页面左边界的像素距离，纵坐标为组件左上角距离页面上边界的像素距离。
旋转角度：以组件的中心为中心点，进行旋转，单位为度（°）。
- 手动输入角度值，控制组件的旋转角度。
- 拖动图标内的黑点，控制组件的旋转角度。
- 单击图标，控制组件左右翻转样式。
- 单击图标，控制组件上下翻转样式。
透明度：取值范围为0~1。为0时，图表隐藏；为1时，图表全部显示。默认为1。

全局


参数	说明
表格行数	轮播列表的表格行数。
是否轮播	打开开关，在预览或发布页面列表内容可自动轮播。关闭开关，动画样式无法配置。
字体	组件中所有文本的字体，默认为微软雅黑。

动画：仅当开启了是否轮播配置项才生效。


参数	说明
动画模式	轮播动画的模式，可选：全部滚动和逐条滚动。
轮播间隔	轮播间隔的时间，单位为秒。
单页不轮播	打开开关，若数据条数达不到表格行数（数据只有一页）时，不进行轮播。

空值隐藏行：打开开关，数据内容为空的情况下，自动隐藏该行不显示。

溢出文本滚动


参数	说明
滚动	打开开关，在预览或发布页面溢出文本可自动滚动。
滚动时间（秒）	溢出文本的滚动时间，单位为秒。

即刻更新：打开开关，当数据更新时立即更新视图渲染；关闭开关，视图将在下次轮播时更新。

表头：列表的表头样式，可单击眼睛图标

图标控制表头样式的显隐。轮播列表表头配置


参数	说明
表头行高	表头部分占整个图表高度的比例值，取值范围为0~100，单位为%。
背景颜色	表头部分的背景颜色，请参见颜色选择器说明进行修改。
文本样式	表头中文本的样式。文本对齐：文本对齐的方式，可选：左对齐、居中对齐和右对齐。字体：文本的字体系列，默认为微软雅黑。字体颜色：文本的颜色。字号：文本的大小，取值范围为0~200。字体粗细：文本字体的粗细样式。

行配置


参数	说明
奇行背景色	列表中奇数行的背景颜色。
偶行背景色	列表中偶数行的背景颜色。
回调字段	作为回调参数的字段，需要取数据中的某个字段。

序列号：列表中序列号的样式，可单击眼睛图标

图标控制序列号的显隐。轮播列表序列号配置


参数	说明
背景颜色	序列号的背景颜色。
列宽占比	序列号所在列的宽度，取值为占列表宽度的百分比，取值范围为0~100，单位为%。
半径占比	序列号的半径，取值为占序列号所在列的宽度的百分比，取值范围为0~100，单位为%。
文本样式	序列号文本的文本样式，包括字体样式、颜色、字号和字体粗细。

自定义列：单击右侧的加号图标

或

图标，添加或删除一个标签列。单击横排列图标

或

图标配置多个自定义系列的排列样式。轮播列表自定义列配置

说明该配置项为一个数组，可配置多个自定义列，编辑器会遍历数据，使数据通过一个或多个自定义列配置循环渲染。若需要自定义某些数据为特定样式，则需要手动对数据进行排序。


参数	说明
列字段名	自定义列所对应的字段名，需要与数据中的type字段相对应。
列显示名	自定义列所对应的显示名，作为表头的内容显示。
列宽占比	自定义列占列表宽度的百分比，取值范围为0~100，单位为%。所有列宽占比总和为100%，超出则会偏离您输入的值。
内容类型	自定义列的内容类型，可选：文本和图片。
自动换行	打开开关，自定义列的内容可自动换行。仅在内容类型配置项选择文本后可配置。
文本对齐	自定义列的文本对齐方式，可选：左对齐、居中对齐和右对齐。仅在内容类型配置项选择文本后可配置。
文本样式	自定义列的文本样式，仅在内容类型配置项选择文本后可配置。字体：自定义列的文本字体样式，默认微软雅黑。字体粗细：自定义列文本的字体粗细。字号：自定义列的文本大小，取值范围为0~200。颜色：自定义列的文本颜色。
图片宽度	自定义列的图片宽度值，仅在内容类型配置项选择图片后可配置。
图片边距	自定义列的图片边距值，包括配置图片距离自定义列左侧的边距值和距离自定义列顶部的边距值，单位为px。仅在内容类型配置项选择图片后可配置。

数据

上图中的示例数据如下。

[
  {
    "area": "中国",
    "pv": 688,
    "attribute": "xxxxxxxxxxxxxxxxxxx"
  },
  {
    "area": "美国",
    "pv": 688,
    "attribute": "xxxxxxxxxxxxxxxxxxx"
  },
  {
    "area": "俄罗斯",
    "pv": 688,
    "attribute": "xxxxxxxxxxxxxxxxxxx"
  },
  {
    "area": "德国",
    "pv": 688,
    "attribute": "xxxxxxxxxxxxxxxxxxx"
  },
  {
    "area": "吉尔吉斯斯坦",
    "pv": 688,
    "attribute": "xxxxxxxxxxxxxxxxxxx"
  },
  {
    "area": "英国",
    "pv": 688,
    "attribute": "xxxxxxxxxxxxxxxxxxx"
  },
  {
    "area": "日本",
    "pv": 688,
    "attribute": "xxxxxxxxxxxxxxxxxxx"
  },
  {
    "area": "南非",
    "pv": 688,
    "attribute": "xxxxxxxxxxxxxxxxxxx"
  },
  {
    "area": "巴西",
    "pv": 688,
    "attribute": "xxxxxxxxxxxxxxxxxxx"
  },
  {
    "area": "印度",
    "pv": 688,
    "attribute": "xxxxxxxxxxxxxxxxxxx"
  },
  {
    "area": "新加坡",
    "pv": 688,
    "attribute": "xxxxxxxxxxxxxxxxxxx"
  },
  {
    "area": "加拿大",
    "pv": 688,
    "attribute": "xxxxxxxxxxxxxxxxxxx"
  },
  {
    "area": "澳大利亚",
    "pv": 688,
    "attribute": "xxxxxxxxxxxxxxxxxxx"
  },
  {
    "area": "阿根廷",
    "pv": 688,
    "attribute": "xxxxxxxxxxxxxxxxxxx"
  },
  {
    "area": "西班牙",
    "pv": 688,
    "attribute": "xxxxxxxxxxxxxxxxxxx"
  }
]

字段任意配置，需要与自定义列 > 列字段名配置项中的字段相对应。若要实现超链接可把字段内容设置为a标签。

表 1. 配置项说明
配置项	说明
受控模式	打开开关，组件初始化状态下不请求数据，仅通过回调ID或蓝图编辑器配置的方法发起请求数据；关闭开关，可以使用自动更新请求数据。
自动更新请求	选中后可以设置动态轮询，还可以手动输入轮询的时间频次。清除后则不会自动更新，需要手动刷新页面，或通过蓝图编辑器和回调ID事件来触发请求更新数据。
数据源	单击配置数据源，可在设置数据源页面中修改数据源类型和数据查询代码、预览数据源返回结果以及查看数据响应结果。详情请参见配置组件数据。
数据过滤器	单击添加过滤器，可在设置数据源页面中配置数据过滤器，详情请参见组件过滤器使用说明。
数据响应结果	展示数据请求的响应结果。当数据源发生改变时，可单击右侧的图标，实时查看数据响应结果。

交互


交互事件	说明
单行点击响应事件	选中启用，开启组件交互功能。可单击轮播列表中的某一行抛出回调值，默认抛出数据中的所有自定义列字段。具体配置请参见组件回调ID配置。
数据翻动响应事件	选中启用，开启组件交互功能。当列表中的数据进行翻动时，会抛出回调值，默认抛出index（索引值）字段。具体配置请参见组件回调ID配置。

蓝图编辑器交互配置

在画布编辑器页面，右键单击组件，选择导出到蓝图编辑器。
单击页面左上角的图标。

在蓝图编辑器配置页面，单击导入节点栏内的轮播列表组件，在画布中可以看到如下图所示的轮播列表的蓝图编辑器配置参数。轮播列表蓝图编辑器参数

事件


事件	说明
当数据接口请求完成时	数据接口请求返回并经过过滤器处理后抛出的事件，同时抛出处理后的JSON格式的数据。具体数据请参见上文的数据示例。
当点击单行时	当单击轮播列表的某一行时抛出当前行的数据。
当数据滚动时	当轮播列表的数据行滚动时触发并抛出当前页的数据和索引值。

动作


动作	说明
请求数据接口	重新请求服务端数据，上游数据处理节点或图层节点抛出的数据将作为参数。例如轮播列表配置了API数据源为`http://api.test`，传到请求数据接口动作的数据为`{ 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" } }`