操作技巧

2025年1月17日大约 7 分钟

操作技巧

操作步骤

可从大屏设计器右上方菜单栏上的【节点编程】按钮进入节点编程页面；
从左侧节点列表把要编辑的组件拖入画布中；
根据交互逻辑进行节点连线；
在右侧的配置面板中，完成逻辑节点配置，包括上下游事件/动作以及处理方法等；
配置完成后，点击保存，在预览界面查看交互效果。

节点介绍

左侧组件节点

在左侧组件节点面板中，可以查看在大屏设计器中添加的所有组件节点。
单击节点拖动到画布中，可添加节点。
在画布中选中某个节点，右键单击该节点，选择删除，可移除该节点。

由于组件拥有巨量的事件和动作，为优化显示，默认仅显示 实际用到的 事件和动作。
点击添加到画布中的节点右上角图标，可导入要使用的事件和动作。

左侧逻辑节点

在左侧面板中可切换显示【逻辑节点】，详见逻辑节点。

右侧属性面板

右侧属性面板主要用于显示：

组件节点说明；

逻辑节点说明及配置；

连线动作配置（仅在使用【隐藏/显示】动作时提供）。

事件与动作

通过在节点编程中配置相应的事件和动作，可与大屏中的组件进行交互。

提示

本节仅列出组件所有通用的事件和动作说明，组件特有的事件与动作，详见 组件指南 中各组件 节点编程 部分的文档。

事件

查看事件说明

选中转换器，点击右侧面板中上游组件事件说明中的查看按钮

事件说明：事件的简要介绍。
数据定义：上游事件抛出的数据格式，在转换器中可以使用data调用。
数据示例：上游事件抛出的数据示例。

通用事件参数说明

当数据请求发送前： 当数据请求发送前触发。

抛出的参数为：

{
  "filterParam": {}, // 过滤参数
  "queryParam": {} // 查询参数
}

当数据请求发送后： 当数据请求发送后触发。
抛出的参数为：组件所携带的数据。

当上卷时（支持上卷下钻的组件）： 当组件上卷时触发。

抛出的参数为：

{
  // 当前维度字段
  "currentField": {
    "fieldAlias": "",
    "fieldName": "",
    "fieldType": ""
  },
  // 点击维度字段
  "triggerField": {
    "fieldAlias": "",
    "fieldName": "",
    "fieldType": ""
  },
  // 图表事件参数
  "eventParams": {}
}

当下钻时（支持上卷下钻的组件）： 当组件下钻时触发。

抛出的参数为：

{
  // 当前维度字段
  "currentField": {
    "fieldAlias": "",
    "fieldName": "",
    "fieldType": ""
  },
  // 下一级维度字段
  "nextField": {
    "fieldAlias": "",
    "fieldName": "",
    "fieldType": ""
  },
  // 数据
  "data": {
    "name": "",
    "value": ""
  },
  // 图表事件参数
  "eventParams": {}
}

高亮事件（支持高亮的组件）： 当高亮指定的数据图形时触发。 4.3+

抛出的参数为：

高亮系列：

{
   // 用 index 或 id 或 name 来指定系列。
   // 可以使用数组指定多个系列。
   seriesIndex?: number | number[],
   seriesId?: string | string[],
   seriesName?: string | string[],

   // 数据项的 index，如果不指定也可以通过 name 属性根据名称指定数据项
   dataIndex?: number | number[],
   // 可选，数据项名称，在有 dataIndex 的时候忽略
   name?: string | string[]
 }

高亮地图组件地理坐标系：

 {
   // 用 index 或 id 或 name 来指定地图组件地理坐标系。
   // 可以用数组指定多个地图组件地理坐标系。
   geoIndex?: number | number[],
   geoId?: string | string[],
   geoName?: string | string[],

   // 地图组件地理坐标系中 region 名称。
   // 可以是一个数组指定多个名称。
   name?: string | string[]
 }

取消高亮事件（支持取消高亮的组件）： 当取消高亮指定的数据图形时触发。 4.3+

抛出的参数为：

取消高亮系列：

{
 // 用 index 或 id 或 name 来指定系列。
 // 可以使用数组指定多个系列。
 seriesIndex?: number | number[],
 seriesId?: string | string[],
 seriesName?: string | string[],

 // 数据项的 index，如果不指定也可以通过 name 属性根据名称指定数据项
 dataIndex?: number | number[],
 // 可选，数据项名称，在有 dataIndex 的时候忽略
 name?: string | string[]
}

取消高亮地图组件地理坐标系：

{
 // 用 index 或 id 或 name 来指定地图组件地理坐标系。
 // 可以用数组指定多个地图组件地理坐标系。
 geoIndex?: number | number[],
 geoId?: string | string[],
 geoName?: string | string[],

 // 地图组件地理坐标系中 region 名称。
 // 可以是一个数组指定多个名称。
 name?: string | string[]
}

动作

查看动作说明

选中转换器，点击右侧面板中下游组件动作说明中的查看按钮

动作说明：动作的简要介绍。
数据定义：下游动作接收的数据格式，也就是 return 的参数。
数据示例：下游动作接收的数据示例。

通用动作参数说明

请求数据接口： 重新请求服务端数据，上游转换器或图层节点抛出的数据将作为参数。排序参数。4.4+

接收的参数为：

{
  "filter": {}, // 过滤参数
  "query": {}, // 查询参数
  "sort": {
    // 排序参数
    "fieldName": "ASC" // key：字段名 value: ASC | DESC
  }
}

导入数据接口： 按组件绘制格式处理数据后，导入组件，重新绘制。不需要重新请求服务端数据。
接收的参数为：组件所携带的数据。
更新组件配置： 再次更新组件配置。需要首先在组件的配置面板中，单击复制配置到剪贴板，获取组件配置数据。再根据需要，在节点编程配置页面的数据处理节点中，更改对应样式的字段值。
接收的参数为：组件的配置数据。
显示： 显示组件。
隐藏： 隐藏组件。

上卷（支持上卷下钻的组件）： 组件上卷。

接收的参数为：

{
  "fieldName": "", // 字段名
  "fieldAlias": "" // 中文名
}

下钻（支持上卷下钻的组件）： 组件下钻。

接收的参数为：

{
  "name": "", // 下钻字段名称
  "seriesIndex": 0 // 系列下标
}

高亮图形（支持数据图形高亮的组件）： 数据图形高亮。 4.3+

接收的参数为：

高亮系列：

{
   // 用 index 或 id 或 name 来指定系列。
   // 可以使用数组指定多个系列。
   seriesIndex?: number | number[],
   seriesId?: string | string[],
   seriesName?: string | string[],

   // 数据项的 index，如果不指定也可以通过 name 属性根据名称指定数据项
   dataIndex?: number | number[],
   // 可选，数据项名称，在有 dataIndex 的时候忽略
   name?: string | string[]
 }

高亮地图组件地理坐标系：

 {
   // 用 index 或 id 或 name 来指定地图组件地理坐标系。
   // 可以用数组指定多个地图组件地理坐标系。
   geoIndex?: number | number[],
   geoId?: string | string[],
   geoName?: string | string[],

   // 地图组件地理坐标系中 region 名称。
   // 可以是一个数组指定多个名称。
   name?: string | string[]
 }

取消高亮图形（支持取消数据图形高亮的组件）： 取消数据图形高亮。 4.3+

接收的参数为：

取消高亮系列：

{
 // 用 index 或 id 或 name 来指定系列。
 // 可以使用数组指定多个系列。
 seriesIndex?: number | number[],
 seriesId?: string | string[],
 seriesName?: string | string[],

 // 数据项的 index，如果不指定也可以通过 name 属性根据名称指定数据项
 dataIndex?: number | number[],
 // 可选，数据项名称，在有 dataIndex 的时候忽略
 name?: string | string[]
}

取消地图组件地理坐标系高亮：

{
 // 用 index 或 id 或 name 来指定地图组件地理坐标系。
 // 可以用数组指定多个地图组件地理坐标系。
 geoIndex?: number | number[],
 geoId?: string | string[],
 geoName?: string | string[],

 // 地图组件地理坐标系中 region 名称。
 // 可以是一个数组指定多个名称。
 name?: string | string[]
}