轮播页面是基础交互组件的一种,仅支持在数据中配置页面的属性,包括id、页面名称和链接,适用于在大屏中轮播展示多个网页。本文档为您介绍轮播页面各配置项的含义,帮助您快速准确地使用轮播页面组件。

配置

该组件不需要配置样式。

数据

轮播页面组件的数据包括大屏轮播数据接口当前大屏数据接口

  • 大屏轮播数据接口
    大屏轮播数据接口

    上图中的示例数据如下:

    [
      {
        "id": 0,
        "serieName": "大屏一",
        "url": "https://m.aliyun.com/?utm_content=se_1435405"
      },
      {
        "id": 1,
        "serieName": "大屏二",
        "url": " https://hd.m.aliyun.com/act/detail-datav.html"
      },
      {
        "id": 2,
        "serieName": "大屏三",
        "url": " https://tianchi.aliyun.com/markets/tianchi/outsource/ai/mobile"
      }
    ]
    • id:大屏中各轮播页面的 id。
    • serieName:大屏中各轮播页面的名称。
    • url:大屏中各轮播页面的链接。
  • 当前大屏数据接口
    当前大屏数据接口

    id:大屏中各轮播页面的 id。

    • 当使用静态数据时,此id仅可定义轮播页面初始化时显示的页面,需要与数据接口中的页面id对应。
    • 当使用动态数据时,如数据库或 API 数据,可以通过交互组件(如时间轴、Tab列表等)动态获取此id值,实现改变交互组件中的某个元素,跳转到对应的轮播页面。其中动态数据返回的id值的格式要与此id保持一致,并与数据接口中的页面id对应。

    建议您使用动态数据,可参考DataV回调ID实现图表联动功能配置数字翻牌器组件的回调ID进行配置。

表 1. 配置项说明
配置项 说明
自动更新请求 勾选后可以设置动态轮询,还可以手动输入轮询的时间频次。
数据源 单击配置数据源,可在设置数据源页面中修改数据源类型和数据查询代码、预览数据源返回结果以及查看数据响应结果。详情请参见配置组件数据
数据过滤器 单击添加过滤器,可在设置数据源页面中配置数据过滤器,详情请参见组件过滤器使用说明
数据响应结果 展示数据请求的响应结果。当数据源发生改变时,可单击右侧的刷新图标,实时查看数据响应结果。

交互

该组件没有交互事件。

节点编程交互配置

在大屏编辑页面中,单击顶部菜单栏的配置节点编程图标,进入轮播页面的节点编程配置页面。可以看到如下图所示的轮播页面的节点编程配置参数。
节点编程参数配置
  • 事件
    • 当大屏轮播数据接口请求完成时

      数据接口请求返回并经过过滤器处理后抛出的事件,同时抛出处理后的JSON格式的数据。具体数据可参见上文的数据示例

    • 当当前大屏数据接口请求完成时

      回调接口请求返回并经过过滤器处理后抛出的事件,同时抛出处理后的JSON格式的数据。具体数据可参见上文的数据示例

  • 动作
    • 请求大屏轮播数据接口

      重新请求服务端数据,上游转换器或图层节点抛出的数据将作为参数。例如轮播页面配置了API数据源为http://api.test,传到请求大屏轮播数据接口动作的数据为{ id: '1'},则最终请求接口为http://api.test?id=1

    • 请求当前大屏数据接口

      重新请求当前大屏的接口数据,上游转换器或图层节点抛出的数据将作为参数。例如轮播页面配置了API数据源为http://api.test,传到请求当前大屏数据接口动作的数据为{ id: '1'},则最终请求接口为http://api.test?id=1

    • 导入大屏轮播数据接口

      按组件绘制格式处理数据后,导入组件,重新绘制。不需要重新请求服务端数据。具体数据可参见上文的数据示例

    • 导入当前大屏数据接口

      按组件绘制格式处理数据后,导入组件,重新绘制。不需要重新请求服务端数据。具体数据可参见上文的数据示例

    • 获取当前页面信息

      返回当前页面的idurl等参数值,具体数据可参见上文的数据示例

    • 更新组件配置

      动态更新组件的样式配置。需要首先在组件的配置面板中,单击复制配置到剪贴板,获取组件配置数据。再根据需要在节点编程配置页面的转换器中更改对应样式的字段值。

    • 显示

      显示组件,不需要参数。

    • 隐藏

      隐藏组件,不需要参数。