# 树图

树图是一种用节点来表达当前节点和子节点关系的图形。

# 属性

# 基础

组件标题： 用于在图层中显示组件的名称。1.1+
组件尺寸： 组件的宽度和高度，单位为px。
组件位置： 组件在大屏中的位置，通过横纵坐标来定义，单位为px。
背景颜色： 组件的背景颜色。

# 系列

平移缩放： 是否开启平移缩放。
关闭节点： 为false时，所有节点打开且所有节点不能打开关闭。
初始展开层级： 组件初始展开的层数。
标记设置： 对组件节点标记的设置。
- 标记图形： 标记的图形样式。
- 标记图片： 标记的图片样式。
- 标记宽： 标记的宽度。
- 标记高： 标记的高度。
- 缩放比例： 标记大小的缩放比例。
- 最大值： 缩放后的最大值。
- 最小值： 缩放后的最小值。
- 标记旋转： 标记的旋转角度。
提示：

当节点标记为空时，此时节点图形的设置由标记图形，标记图片控制，节点标记不为空时，图形是由节点标记里的值所控制。

当节点数据只有一个字段时，节点的大小是由标记大小配置控制全部节点标记的大小，此时组件的缩放比例，最大值，最小值配置不生效。如果想设置各节点标记大小不同，可将数据中的一个量度值拖入节点数据第二个字段中，此时标记大小配置不生效，节点标记的大小由缩放比例，数值的值，最大值，最小值配置控制。

文本标签： 对节点文本的设置。
- 显示： 是否显示文本。
- 位置： 文本的位置。
- 距离： 文本距节点的位置。
- 内容格式器： 标签内容格式器，支持字符串模板和回调函数两种形式，字符串模板与回调函数返回的字符串均支持用 \n 换行。
  
  字符串模板变量
  - {a} : 系列名。
  - {b} : 数据名。
  - {c} : 数据值。
  例如：
```
{b}: {c}
```
  回调函数
  
  可用参数为data。
  
  示例：
```
return data.data[i];
```
  参数 data是内容格式器需要的单个数据资源。格式如下：
```
{
    // i的值，代表的数据
    0: x值,
    1: y值,
    2: 系列值,
    3: 大小,
    4: name值
}
```
- 字体颜色： 文本标签字体颜色。
- 字体大小： 文本标签字体大小。
- 字体粗细： 文本标签字体粗细。
- 字体： 文本标签字体样式。
- 字体旋转： 文本标签字体的旋转角度。

节点样式： 对节点样式的设置。
- 图形颜色： 节点的颜色。
- 描边颜色： 节点描边的颜色。
- 描边线宽： 节点描边的宽度。
- 描边类型： 节点描边的类型。
  - 实线
  - 虚线
  - 点状线
树线样式： 对组件边线的设置。
- 树线颜色： 节点的颜色。
- 树线宽度： 节点描边的宽度。
- 树线曲度： 节点描边的类型。
  - 实线
  - 虚线
  - 点状线

叶子节点： 对叶子节点的设置。
- 文本标签： 对叶子节点文本的设置。
  - 显示： 是否显示文本。
  - 位置： 文本的位置。
  - 距离： 文本距节点的位置。
  - 内容格式器： 标签内容格式器，支持字符串模板和回调函数两种形式，字符串模板与回调函数返回的字符串均支持用 \n 换行。
    
    字符串模板变量
    - {a} : 系列名。
    - {b} : 数据名。
    - {c} : 数据值。
    例如：
```
{b}: {c}
```
    回调函数
    
    可用参数为data。
    
    示例：
```
return data.data[i];
```
    参数 data是内容格式器需要的单个数据资源。格式如下：
```
{
    // i的值，代表的数据
    0: x值,
    1: y值,
    2: 系列值,
    3: 大小,
    4: name值
}
```
  - 字体颜色： 文本标签字体颜色。
  - 字体大小： 文本标签字体大小。
  - 字体粗细： 文本标签字体粗细。
  - 字体： 文本标签字体样式。
- 节点样式： 对叶子节点样式的设置。
  - 节点样式： 对叶子节点样式的设置。
  - 图形颜色： 叶子节点的颜色。
  - 描边颜色： 叶子节点描边的颜色。
  - 描边线宽： 叶子节点描边的宽度。
  - 描边类型： 叶子节点描边的类型。
    - 实线
    - 虚线
    - 点状线

单个节点： 对单个节点的设置。
- 显示节点标识： 显示每个节点的标识。
- 节点标识： 输入要修改节点的节点标识，以逗号分隔。
- 关闭节点： 关闭当前节点。
- 节点样式： 对当前节点样式的设置。
  - 图形颜色： 节点的颜色。
  - 描边颜色： 节点描边的颜色。
  - 描边线宽： 节点描边的宽度。
  - 描边类型： 节点描边的类型。
    - 实线
    - 虚线
    - 点状线
- 标记设置： 对当前节点标记的设置。
  - 标记图形： 标记的图形样式。
  - 标记图片： 标记的图片样式。
  - 标记宽： 标记的宽度。
  - 标记高： 标记的高度。
  - 缩放比例： 标记大小的缩放比例。
  - 最大值： 缩放后的最大值。
  - 最小值： 缩放后的最小值。
  - 标记旋转： 标记的旋转角度。
  提示：
  
  当节点标记中无值时，单个节点的标记图形，标记图片配置不生效。
- 文本标签： 对当前节点文本的设置。
  - 显示： 是否显示文本。
  - 位置： 文本的位置。
  - 距离： 文本距节点的位置。
  - 字体颜色： 文本标签字体颜色。
  - 字体大小： 文本标签字体大小。
  - 字体粗细： 文本标签字体粗细。
  - 字体： 文本标签字体样式。

# 视区

树图布局： 正交布局/径向布局。
树边形状： 正交布局树边的形状。
- 曲线
- 折线
方向： 正交布局组件的方向。

提示：

树边形状，方向配置只有在树图布局为正交布局时生效。

左边距： 离容器左侧的距离。
右边距： 离容器上侧的距离。
上边距： 离容器右侧的距离。
下边距： 离容器下侧的距离。

# 标题

显示标题： 是否显示标题
内容：
- 标题
  - 主：主标题内容。
  - 副：副标题内容。
- 超链接
  - 主：主标题超链接。
  - 副：副标题超链接。
位置
- 水平对齐
- 垂直对齐
外观
- 内边距
- 主副间隔

主标题文本样式
- 字体颜色： 主标题字体颜色。
- 字体大小： 主标题字体大小。
- 字体粗细： 主标题字体粗细。
- 字体： 主标题字体样式。

副标题文本样式
- 字体颜色： 副标题字体颜色。
- 字体大小： 副标题字体大小。
- 字体粗细： 副标题字体粗细。
- 字体： 副标题字体样式。

# 图例

显示图例： 是否显示图例。
选中模式： 图例选择的模式，控制是否可以通过点击图例改变系列的显示状态。
内容格式器： 用来格式化图例文本，支持字符串模板和回调函数两种形式。
- 字符串模板： {name}
- 回调函数：
```
return data;
```
位置
- 排列方式： 图例列表的布局朝向。
- 水平位置： 水平排列。
- 垂直位置： 垂直排列。

文字样式
- 字体颜色： 图例字体颜色。
- 字体大小： 图例字体大小。
- 字体粗细： 图例字体粗细。
- 字体： 图例字体样式。

# 提示框

显示提示框： 是否显示提示框。
提示模板 ：提示框浮层内容格式器，支持字符串模板和回调函数两种形式。
- 字符串模板
  
  模板变量有 {a}, {b}，{c}，{d}，{e}，分别表示系列名，数据名，数据值等。在触发点为坐标轴的时候，会有多个系列的数据，此时可以通过 {a0}, {a1}, {a2} 这种后面加索引的方式表示系列的索引。不同图表类型下的 {a}，{b}，{c}，{d} 含义不一样。其中变量{a}, {b}, {c}, {d}在不同图表类型下代表数据含义为：
  - 折线（区域）图、柱状（条形）图、K 线图 : {a}（系列名称），{b}（类目值），{c}（数值）, {d}（无）
  - 散点图（气泡）图 : {a}（系列名称），{b}（数据名称），{c}（数值数组）, {d}（无）
  - 地图 : {a}（系列名称），{b}（区域名称），{c}（合并数值）, {d}（无）
  - 饼图、仪表盘、漏斗图: {a}（系列名称），{b}（数据项名称），{c}（数值）, {d}（百分比）
- 回调函数
```
"return data;"
```

触发点：
- 坐标轴： 坐标轴触发，主要在柱状图，折线图等会使用类目轴的图表中使用。
- 数据项： 数据项图形触发，主要在散点图，饼图等无类目轴的图表中使用。

提示外观
- 背景颜色： 提示框浮层的背景颜色。
- 边框颜色： 提示框浮层的边框颜色。
- 边框宽度： 提示框浮层的边框宽度。
- 内边距： 提示框浮层内边距。

文本样式
- 字体颜色： 提示框字体颜色。
- 字体大小： 提示框字体大小。
- 字体粗细： 提示框字体粗细。
- 字体： 提示框字体样式。

# 工具栏

显示工具栏： 是否显示工具栏。
功能按钮
- 保存为图片按钮
- 还原按钮
- 数据视图按钮

位置朝向
- 排列方式： 功能按钮的布局朝向。
- 水平位置： 水平排列。
- 垂直位置： 垂直排列。

图表尺寸
- 图标大小
- 间隔

# 数据

# 静态数据

上图中的示例JSON代码如下：

[
  {
    "id": 1,
    "name": "flare",
    "value": 35,
    "parentId": 0,
    "symbol": "circle"
  },
  {
    "id": 2,
    "name": "analytics",
    "value": 30,
    "parentId": 1,
    "symbol": "roundRect"
  },
  {
    "id": 3,
    "name": "animate",
    "value": 30,
    "parentId": 1,
    "symbol": "roundRect"
  },
  {
    "id": 4,
    "name": "data",
    "value": 30,
    "parentId": 1,
    "symbol": "roundRect"
  },
  {
    "id": 5,
    "name": "cluster",
    "value": 20,
    "parentId": 2,
    "symbol": "rect"
  },
  {
    "id": 6,
    "name": "Eas",
    "value": 20,
    "parentId": 3,
    "symbol": "rect"
  },
  {
    "id": 7,
    "name": "Fun",
    "value": 20,
    "parentId": 3,
    "symbol": "rect"
  },
  {
    "id": 8,
    "name": "inter",
    "value": 20,
    "parentId": 3,
    "symbol": "rect"
  },
  {
    "id": 9,
    "name": "ISche",
    "value": 20,
    "parentId": 3,
    "symbol": "rect"
  },
  {
    "id": 10,
    "name": "parallel",
    "value": 20,
    "parentId": 3,
    "symbol": "rect"
  },
  {
    "id": 11,
    "name": "Pause",
    "value": 20,
    "parentId": 3,
    "symbol": "rect"
  },
  {
    "id": 12,
    "name": "Sche",
    "value": 20,
    "parentId": 3,
    "symbol": "rect"
  },
  {
    "id": 13,
    "name": "Seq",
    "value": 20,
    "parentId": 3,
    "symbol": "rect"
  },
  {
    "id": 14,
    "name": "Tran",
    "value": 20,
    "parentId": 3,
    "symbol": "rect"
  },
  {
    "id": 15,
    "name": "Trans",
    "value": 20,
    "parentId": 3,
    "symbol": "rect"
  },
  {
    "id": 16,
    "name": "conver",
    "value": 20,
    "parentId": 4,
    "symbol": "rect"
  }
]

id 量度，当前节点标识。
name 维度，节点的名称。
value 量度，节点的大小。
parentId 量度，上级节点标识。
symbol 维度，节点的形状。

提示：

数据中parentId为 0，""或"0"的配置为根节点，symbol的值可为emptyCircle，circle, rect, roundRect, triangle, diamond, pin, arrow, none

# 数据资源

# 交互

# 单击节点交互事件

勾选启用，开启组件交互功能。当单击树图节点时，绑定字段中数据会推送到变量中。关联此变量的组件将携带此变量值，触发数据请求，查询相关数据，更新组件。具体配置请参考组件交互。

# 数据响应

树图支持数据响应配置。

# 节点编程

# 事件

单击节点交互事件： 节点单击触发事件。
- 抛出的参数： 节点所携带的数据。
图表配置转换完成后： 图表 Option 配置转换完成后事件。
- 抛出的参数： 配置完成后的 Option 。
图例切换事件： 图表图例切换时触发。
- 抛出的参数： 切换的图例名称及选中状态。

# 动作

导入图表配置： 可导入 Echarts 图表 Option 配置。
- 接收的参数： 修改后的 Option 。

设置图例： 设置图例的选中状态。

接收的参数：

  {
    "类型一": true,
    "类型二": false,
    "类型三": false
  }

← 气泡图径向树图 →