[]
        
在线Demo 免费试用
(Showing Draft Content)

组件命令

1.概述

通过配置组件的命令实现多样化的功能,包括更新组件的状态、切换页面以及控制3D组件的漫游路径等。这种方式赋予了灵活操控数据大屏的能力,能够实现动态交互、页面导航以及复杂的三维组件动态数据展示,满足从状态管理到视觉呈现的多种设计需求。

1.1功能概述

本节为您详细介绍如何通过命令来执行特定的操作。

2.操作步骤

2.1支持命令的组件

  • 图表

  • 表格

  • 图片组件

  • 按钮组件

2.2为组件添加命令

2.2.1添加组件并绑定数据

image

2.2.2将鼠标左键行为设置为“命令”

打开组件的属性面板,在数据交互中找到“鼠标左键选项”,将该选项设定为“命令”。

image

2.2.3添加命令

点击“添加项目”,在弹出的对话框中选择命令的种类,并根据选项设置命令。

image

type=info

注意:

  • 不同种类的可视化组件支持的命令种类不完全一样。

  • 每种命令的设置项目不完全相同,将在“3.常用命令说明”中为您一一介绍

2.3命令的执行

为组件添加命令之后,在仪表板的运行时(预览报表、在门户站点中查看报表),通过点击鼠标左键,即可触发命令并执行相应操作。

例如,为按钮组件添加了一个命令,用来控制柱状图组件的显示与隐藏。

image

在仪表板设计器中预览该仪表板,或者保存该仪表板之后在门户站点中查看该仪表板,点击按钮,执行命令,隐藏或显示柱状图。

command

type=info

注意:

可以为组件添加多个命令,命令执行的时候,将按照命令项目的顺序依次执行。

3.常用命令说明

3.1更新组件显示状态

用于控制组件的显示及隐藏,点击“+”添加需要控制的组件,可同时添加多个组件。

image

3.2切换页面

指定切换的目标页面,运行时点击按钮组件,将切换到指定页面。

image

3.3切换选项卡

用于切换指定选项卡组件的页签。用户需要选择选项卡容器及需要切换的目标页签。

image

3.4关闭跳转

当跳转的目标页面中,包含一个按钮组件,且设定该按钮组件的命令为“关闭跳转”。当通过跳转打开目标页面,点击该按钮,将关闭跳转的目标仪表板。

image

3.5跳转

在命令中实现跳转的行为。

为按钮添加跳转设置项目。在命令设置对话框中,指定跳转项目。运行时点击按钮,执行跳转行为。

image

3.6设置参数

通过点击组件,为仪表板参数赋值。

为仪表板添加参数,在命令对话中,选定参数并为这个参数赋值。

image

type=info

注意:

无法通过命令为多值参数及多维数据参数赋值。

3.7调用外部API

通过点击组件,调用外部API。

以下通过点击按钮向推送数据集添加数据的示例,展示如何调用外部API。

  1. 创建一个推送数据集,获得端点地址。

  2. 在仪表板中添加一个外部API,并将获得的推送数据集端点地址填入其中。

    image

  3. 保存该外部API

  4. 在仪表板中添加一个按钮组件,并设置命令为“调用外部API”,并选择刚刚创建的外部API,并填入要发送的数据。数据的格式请参考推送数据集的请求体。

    image

  5. 添加一个数据表,并绑定该推送数据集,并将该数据集设置为实时刷新。

    image

  6. 保存仪表板并返回至文档门户站点。

  7. 查看该仪表板,点击按钮,可以看到每点击一次向推送数据集中推送一笔数据。

    push data

type=warning

注意:

以上仅结合示例向您展示如何通过点击按钮调用外部API,您可根据自身需求灵活应用此功能。

3.8导出

通过点击导出对应组件。

在命令设置对话框中,选择“导出”,在组件下拉列表中选择需要导出的的组件(可选范围为图表及表格组件)。根据实际需求选择导出类型。

image

3.9 3D场景自定义脚本

通过点击组件来执行3D场景的自定义脚本。

在命令设置对话框中,选择“3D场景自定义脚本”,绑定当前仪表板中的3D场景,选择该场景中包含的自定脚本。如何创建3D场景的自定义脚本,请参考:3D模型自定义脚本

image

3.10 3D场景数据点漫游

通过按钮来控制3D场景数据漫游的开启或停止。

在命令设置对话框中,选择“3D场景数据点漫游”,绑定当前仪表板中的3D场景,设置数据点漫游动作,提供三个数据点漫游动作供用户选择:

  • 开始数据漫游:点击按钮开始数据点漫游。

  • 停止数据点漫游:点击按钮停止数据点漫游。

  • 暂停/恢复 数据点漫游:点击按钮开始执行数据点漫游,再次点击暂停数据点漫游,再次点击恢复执行数据点漫游,依此类推。

image

3.11 3D场景路径漫游

通过按钮来控制3D场景路径漫游的开启或停止。

在命令设置对话框中,选择“3D场景路径漫游”,绑定当前仪表板中的3D场景,设置路径漫游动作,提供三个路径漫游动作供用户选择:

  • 开始路径漫游:指定路径漫游名称,运行时,点击按钮开始路径漫游。

  • 停止路径漫游:点击按钮停止路径漫游。

  • 暂停/恢复 路径漫游:点击按钮开始执行路径漫游,再次点击暂停路径漫游,再次点击恢复执行路径漫游,依此类推。

image

3.12 3D场景动画

通过按钮来控制3D场景中动画的开启与停止。

在命令设置对话框中,选择“3D场景动画”,绑定当前仪表板中的3D场景,选择动画名称,设置动画执行动作,提供三个动画动作供用户选择:

  • 开始动画:运行时,点击按钮开始播放动画。

  • 停止动画:点击按钮停止播放动画。

  • 暂停/恢复 动画:点击按钮开始播放动画,再次点击暂停播放动画,再次点击恢复播放动画,依此类推。

image

type=info

注意:

在3D模型中,动画的执行时机必须是“手动触发”。手动触发的动画才能在仪表板中通过命令来控制它的执行状态。

image

3.13更新复合地图图层

通过组件来控制复合地图中各个图层的显示或隐藏。

在命令设置对话框中,选择“更新复合地图图层”,绑定当前仪表板中的复合地图,指定图层,并为各个图层添加动作来控制该图层的显示状态。

image

3.14钻取

为图表组件添加钻取命令,可以通过单击鼠标左键来实现钻取的功能。

image