"ECharts 入门教程"的目录
ECharts 入门教程 Treemap层级设置
series[i]-treemap.levels[i] Object
配置 ECharts 图表中 Treemap 的多个层级。
treemap 中采用『三级配置』：
『每个节点』->『每个层级』->『每个系列』。
即我们可以对每个节点进行配置，也可以对树的每个层级进行配置，也可以 series 上设置全局配置。节点上的设置，优先级最高。
最常用的是『每个层级进行配置』，levels 配置项就是每个层级的配置。例如：
// 注意，这个数据结构实际不是"tree"而是"forest"
data: [
{
name: 'nodeA',
children: [
{name: 'nodeAA'},
{name: 'nodeAB'},
]
},
{
name: 'nodeB',
children: [
{name: 'nodeBA'}
]
}
],
levels: [
{...}, // "forest"的顶层配置。即含有 'nodeA', 'nodeB' 的这层。
{...}, // 下一层配置，即含有 'nodeAA', 'nodeAB', 'nodeBA' 的这层。
{...}, // 再下一层配置。
...
]
视觉映射的规则
treemap 中首要关注的是如何在视觉上较好得区分『不同层级』、『同层级中不同类别』。这需要合理得设置不同层级的『矩形颜色』、『边界粗细』、『边界颜色』甚至『矩形颜色饱和度』等。
参见这个例子，最顶层级用颜色区分，分成了『红』『绿』『蓝』等大块。每个颜色块中是下一个层级，使用颜色的饱和度来区分（参见 colorSaturation）。最外层的矩形边界是『白色』，下层级的矩形边界是当前区块颜色加上饱和度处理（参见 borderColorSaturation）。
treemap 是通过这样的规则来支持这种配置的：每个层级计算用户配置的 color、colorSaturation、borderColor、colorSaturation等视觉信息（在levels中配置）。如果子节点没有配置，则继承父的配置，否则使用自己的配置）。
这样，可以做到：父层级配置 color 列表，子层级配置 colorSaturation。父层级的每个节点会从 color 列表中得到一个颜色，子层级的节点会从 colorSaturation 中得到一个值，并且继承父节点得到的颜色，合成得到自己的最终颜色。
维度与额外的视觉映射
例子：每一个 value 字段是一个 Array，其中每个项对应一个维度（dimension）。
[
{
value: [434, 6969, 8382],
children: [
{
value: [1212, 4943, 5453],
id: 'someid-1',
name: 'description of this node',
children: [...]
},
{
value: [4545, 192, 439],
id: 'someid-2',
name: 'description of this node',
children: [...]
},
...
]
},
{
value: [23, 59, 12],
children: [...]
},
...
]
treemap 默认把第一个维度（Array 第一项）映射到『面积』上。而如果想表达更多信息，用户可以把其他的某一个维度（series-treemap.visualDimension），映射到其他的『视觉元素』上，比如颜色明暗等。参见例子中，legend选择 Growth时的状态。
矩形边框（border）/缝隙（gap）设置如何避免混淆
如果统一用一种颜色设置矩形的缝隙（gap），那么当不同层级的矩形同时展示时可能会出现混淆。
参见 例子，注意其中红色的区块中的子矩形其实是更深层级，和其他用白色缝隙区分的矩形不是在一个层级。所以，红色区块中矩形的分割线的颜色，我们在 borderColorSaturation 中设置为『加了饱和度变化的红颜色』，以示区别。
borderWidth, gapWidth, borderColor 的解释
visualDimension
treemap 中支持对数据其他维度进行视觉映射。
首先，treemap 的数据格式（参见 series-treemap.data）中，每个节点的 value 都可以是数组。数组每项是一个『维度』（dimension）。visualDimension 指定了额外的『视觉映射』使用的是数组的哪一项。默认为第 0 项。
关于视觉设置，详见 series-treemap.levels。
注：treemap中 visualDimension 属性可能在多处地方存在：
- 可以存在于 sereis-treemap 根下，表示本系列全局的统一设置。
- 可以存在于 series-treemap.levels 的每个数组元素中，表示树每个层级的统一设置。
- 存在于 series-treemap.data 的每个节点中，表示每个节点的特定设置。
visualMin
当前层级的最小 value 值。如果不设置则自动统计。
手动指定 visualMin、visualMax ，即手动控制了 visual mapping 的值域（当 colorMappingBy 为 'value' 时有意义）。
visualMax
当前层级的最大 value 值。如果不设置则自动统计。
手动指定 visualMin、visualMax ，即手动控制了 visual mapping 的值域（当 colorMappingBy 为 'value' 时有意义）。
color
这是一个 Array 值，表示同一层级的节点的颜色选取列表（选择规则见 colorMappingBy）。默认为空时，选取系统 color 列表。
关于视觉设置，详见 series-treemap.levels。
注：treemap中 color 属性可能在多处地方存在：
- 可以存在于 series-treemap.levels 的每个数组元素中，表示树每个层级的统一设置。
- 存在于 series-treemap.data 的每个节点中，表示每个节点的特定设置。
colorAlpha
表示同一层级的节点的 颜色透明度 选取范围。数值范围 0 ~ 1。
例如, colorAlpha 可以是 [0.3, 1].
关于视觉设置，详见 series-treemap.levels。
注：treemap中 colorAlpha 属性可能在多处地方存在：
- 可以存在于 sereis-treemap 根下，表示本系列全局的统一设置。
- 可以存在于 series-treemap.levels 的每个数组元素中，表示树每个层级的统一设置。
- 存在于 series-treemap.data 的每个节点中，表示每个节点的特定设置。
colorSaturation
表示同一层级的节点的颜色饱和度的选取范围。数值范围 0 ~ 1。
例如, colorSaturation 可以是 [0.3, 1].
关于视觉设置，详见 series-treemap.levels。
注：treemap中 colorSaturation 属性可能在多处地方存在：
- 可以存在于 sereis-treemap 根下，表示本系列全局的统一设置。
- 可以存在于 series-treemap.levels 的每个数组元素中，表示树每个层级的统一设置。
- 存在于 series-treemap.data 的每个节点中，表示每个节点的特定设置。
colorMappingBy
表示同一层级节点，在颜色列表中（参见 color 属性）选择时，按照什么来选择。可选值：
- 'value'：
将节点的值（即 series-treemap.data.value）映射到颜色列表中。
这样得到的颜色，反应了节点值的大小。
可以使用 visualDimension 属性来设置，用 data 中哪个纬度的值来映射。
- 'index'：
将节点的 index（序号）映射到颜色列表中。即同一层级中，第一个节点取颜色列表中第一个颜色，第二个节点取第二个。
这样得到的颜色，便于区分相邻节点。
- 'id'：
将节点的 id（即 series-treemap.data.id）映射到颜色列表中。id 是用户指定的，这样能够使得，在treemap 通过 setOption 变化数值时，同一 id 映射到同一颜色，保持一致性。参见 例子。
关于视觉设置，详见 series-treemap.levels。
注：treemap中 colorMappingBy 属性可能在多处地方存在：
- 可以存在于 sereis-treemap 根下，表示本系列全局的统一设置。
- 可以存在于 series-treemap.levels 的每个数组元素中，表示树每个层级的统一设置。
- 存在于 series-treemap.data 的每个节点中，表示每个节点的特定设置。
visibleMin
如果某个节点的矩形的面积，小于这个数值（单位：px平方），这个节点就不显示。
如果不加这个限制，很小的节点会影响显示效果。
关于视觉设置，详见 series-treemap.levels。
注：treemap中 visibleMin 属性可能在多处地方存在：
- 可以存在于 sereis-treemap 根下，表示本系列全局的统一设置。
- 可以存在于 series-treemap.levels 的每个数组元素中，表示树每个层级的统一设置。
- 存在于 series-treemap.data 的每个节点中，表示每个节点的特定设置。
childrenVisibleMin
如果某个节点的矩形面积，小于这个数值（单位：px平方），则不显示这个节点的子节点。
这能够在矩形面积不足够大时候，隐藏节点的细节。当用户用鼠标缩放节点时，如果面积大于此阈值，又会显示子节点。
关于视觉设置，详见 series-treemap.levels。
注：treemap中 childrenVisibleMin 属性可能在多处地方存在：
- 可以存在于 sereis-treemap 根下，表示本系列全局的统一设置。
- 可以存在于 series-treemap.levels 的每个数组元素中，表示树每个层级的统一设置。
- 存在于 series-treemap.data 的每个节点中，表示每个节点的特定设置。
label
label 描述了每个矩形中，文本标签的样式。
注：treemap中 label 属性可能在多处地方存在：
- 可以存在于 sereis-treemap 根下，表示本系列全局的统一设置。
- 可以存在于 series-treemap.levels 的每个数组元素中，表示树每个层级的统一设置。
- 存在于 series-treemap.data 的每个节点中，表示每个节点的特定设置。
upperLabel
upperLabel 用于显示矩形的父节点的标签。当 upperLabel.normal.show 为 true 的时候，『显示父节点标签』功能开启。
同 series-treemap.label 一样，upperLabel 可以存在于 series-treemap 的根节点，或者 series-treemap.level 中，或者 series-treemap.data 的每个数据项中。
series-treemap.label 描述的是，当前节点为叶节点时标签的样式；upperLabel 描述的是，当前节点为非叶节点（即含有子节点）时标签的样式。（此时标签一般会被显示在节点的最上部）
参见：
itemStyle
注：treemap中 itemStyle 属性可能在多处地方存在：
- 可以存在于 sereis-treemap 根下，表示本系列全局的统一设置。
- 可以存在于 series-treemap.levels 的每个数组元素中，表示树每个层级的统一设置。
- 存在于 series-treemap.data 的每个节点中，表示每个节点的特定设置。