层级设置

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 中首要关注的是如何在视觉上较好得区分『不同层级』、『同层级中不同类别』。这需要合理得设置不同层级的『矩形颜色』、『边界粗细』、『边界颜色』甚至『矩形颜色饱和度』等。

参见这个例子，最顶层级用颜色区分，分成了『红』『绿』『蓝』等大块。每个颜色块中是下一个层级，使用颜色的饱和度来区分。最外层的矩形边界是『白色』，下层级的矩形边界是当前区块颜色加上饱和度处理。

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），映射到其他的『视觉元素』上，比如颜色明暗等。

矩形边框（border）/缝隙（gap）设置如何避免混淆

如果统一用一种颜色设置矩形的缝隙（gap），那么当不同层级的矩形同时展示时可能会出现混淆。

注意其中红色的区块中的子矩形其实是更深层级，和其他用白色缝隙区分的矩形不是在一个层级。所以，红色区块中矩形的分割线的颜色，我们在 borderColorSaturation 中设置为『加了饱和度变化的红颜色』，以示区别。

borderWidth, gapWidth, borderColor 的解释

visualDimension

treemap 中支持对数据其他维度进行视觉映射。

首先，treemap 的数据格式（参见 series-treemap.data）中，每个节点的 value 都可以是数组。数组每项是一个『维度』（dimension）。visualDimension 指定了额外的『视觉映射』使用的是数组的哪一项。默认为第 0 项。

注：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 列表。

注：treemap中 color 属性可能在多处地方存在：

• 可以存在于 series-treemap.levels 的每个数组元素中，表示树每个层级的统一设置。

• 存在于 series-treemap.data 的每个节点中，表示每个节点的特定设置。

colorAlpha

表示同一层级的节点的 颜色透明度 选取范围。数值范围 0 ~ 1。

例如, colorAlpha 可以是 [0.3, 1].

注：treemap中 colorAlpha 属性可能在多处地方存在：

• 可以存在于 sereis-treemap 根下，表示本系列全局的统一设置。

• 可以存在于 series-treemap.levels 的每个数组元素中，表示树每个层级的统一设置。

• 存在于 series-treemap.data 的每个节点中，表示每个节点的特定设置。

colorSaturation

表示同一层级的节点的颜色饱和度的选取范围。数值范围 0 ~ 1。

例如, colorSaturation 可以是 [0.3, 1].

注：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 映射到同一颜色，保持一致性。

注：treemap中 colorMappingBy 属性可能在多处地方存在：

• 可以存在于 sereis-treemap 根下，表示本系列全局的统一设置。

• 可以存在于 series-treemap.levels 的每个数组元素中，表示树每个层级的统一设置。

• 存在于 series-treemap.data 的每个节点中，表示每个节点的特定设置。

visibleMin

如果某个节点的矩形的面积，小于这个数值（单位：px平方），这个节点就不显示。

如果不加这个限制，很小的节点会影响显示效果。

注：treemap中 visibleMin 属性可能在多处地方存在：

• 可以存在于 sereis-treemap 根下，表示本系列全局的统一设置。

• 可以存在于 series-treemap.levels 的每个数组元素中，表示树每个层级的统一设置。

• 存在于 series-treemap.data 的每个节点中，表示每个节点的特定设置。

childrenVisibleMin

如果某个节点的矩形面积，小于这个数值（单位：px平方），则不显示这个节点的子节点。

这能够在矩形面积不足够大时候，隐藏节点的细节。当用户用鼠标缩放节点时，如果面积大于此阈值，又会显示子节点。

注：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 的每个节点中，表示每个节点的特定设置。