Treemap父節(jié)點(diǎn)標(biāo)簽

series[i]-treemap.upperLabel

upperLabel 用于顯示矩形的父節(jié)點(diǎn)的標(biāo)簽。當(dāng) upperLabel.normal.show 為 true 的時(shí)候，“顯示父節(jié)點(diǎn)標(biāo)簽”功能開啟。

同 series-treemap.label 一樣，upperLabel 可以存在于 series-treemap 的根節(jié)點(diǎn)，或者 series-treemap.level 中，或者 series-treemap.data 的每個(gè)數(shù)據(jù)項(xiàng)中。

series-treemap.label 描述的是，當(dāng)前節(jié)點(diǎn)為葉節(jié)點(diǎn)時(shí)標(biāo)簽的樣式；upperLabel 描述的是，當(dāng)前節(jié)點(diǎn)為非葉節(jié)點(diǎn)（即含有子節(jié)點(diǎn)）時(shí)標(biāo)簽的樣式。（此時(shí)標(biāo)簽一般會(huì)被顯示在節(jié)點(diǎn)的最上部）

參見：

點(diǎn)擊編輯實(shí)例 》》

注：treemap中 label 屬性可能在多處地方存在：

• 可以存在于 sereis-treemap 根下，表示本系列全局的統(tǒng)一設(shè)置。
  
• 可以存在于 series-treemap.levels 的每個(gè)數(shù)組元素中，表示樹每個(gè)層級(jí)的統(tǒng)一設(shè)置。
  
• 存在于 series-treemap.data 的每個(gè)節(jié)點(diǎn)中，表示每個(gè)節(jié)點(diǎn)的特定設(shè)置。
  

series[i]-treemap.upperLabel.normal

在 ECharts 中通過(guò) normal 狀態(tài)設(shè)置 Treemap 父節(jié)點(diǎn)標(biāo)簽。

show

通過(guò)該屬性設(shè)置是否顯示 Treemap 父節(jié)點(diǎn)標(biāo)簽，默認(rèn)為 false。

position

設(shè)置父節(jié)點(diǎn)標(biāo)簽的位置。

可選值如下：

• [x, y]通過(guò)相對(duì)的百分比或者絕對(duì)像素值表示標(biāo)簽相對(duì)于圖形包圍盒左上角的位置。 示例： 

  // 絕對(duì)的像素值
    position: [10, 10],
  // 相對(duì)的百分比
    position: ['50%', '50%']

• 'top'
• 'left'
• 'right'
• 'bottom'
• 'inside'
• 'insideLeft'
• 'insideRight'
• 'insideTop'
• 'insideBottom'
• 'insideTopLeft'
• 'insideBottomLeft'
• 'insideTopRight'
• 'insideBottomRight'

參見：label position。

distance

距離圖形元素的距離，值類型為 number，默認(rèn)值為 5。當(dāng) position 為字符描述值（如 'top'、'insideRight'）時(shí)候有效。

參見：label position。

rotate

設(shè)置標(biāo)簽旋轉(zhuǎn)的角度。從 -90 度到 90 度。正值是逆時(shí)針。

參見：label rotation。

offset

是否對(duì)文字進(jìn)行偏移。默認(rèn)不偏移。例如：[30, 40] 表示文字在橫向上偏移 30，縱向上偏移 40。

formatter

標(biāo)簽內(nèi)容格式器，支持字符串模板和回調(diào)函數(shù)兩種形式，字符串模板與回調(diào)函數(shù)返回的字符串均支持用 \n 換行。

字符串模板：模板變量有 {a}、、{c}，分別表示系列名，數(shù)據(jù)名，數(shù)據(jù)值。

示例：

formatter: ': {c}'

回調(diào)函數(shù)

回調(diào)函數(shù)格式：

(params: Object|Array) => string

參數(shù) params 是 formatter 需要的單個(gè)數(shù)據(jù)集。格式如下：

{
    componentType: 'series',
    // 系列類型
    seriesType: string,
    // 系列在傳入的 option.series 中的 index
    seriesIndex: number,
    // 系列名稱
    seriesName: string,
    // 數(shù)據(jù)名，類目名
    name: string,
    // 數(shù)據(jù)在傳入的 data 數(shù)組中的 index
    dataIndex: number,
    // 傳入的原始數(shù)據(jù)項(xiàng)
    data: Object,
    // 傳入的數(shù)據(jù)值
    value: number|Array,
    // 數(shù)據(jù)圖形的顏色
    color: string,
}

color

設(shè)置標(biāo)簽文字的顏色，默認(rèn)值為 #fff。

如果設(shè)置為 'auto'，則為視覺映射得到的顏色，如系列色。

fontStyle

父節(jié)點(diǎn)標(biāo)簽文字字體的風(fēng)格。

可選值如下：

• 'normal'
• 'italic'
• 'oblique'

fontWeight

文字字體的粗細(xì)

可選值：

• 'normal'
• 'bold'
• 'bolder'
• 'lighter'
• 100 | 200 | 300 | 400...

fontFamily

文字的字體系列，默認(rèn)值為 sans-serif。

還可以是 'serif' , 'monospace', 'Arial', 'Courier New', 'Microsoft YaHei', ...

fontSize

文字的字體大小，默認(rèn)值為 12。

align

文字水平對(duì)齊方式，默認(rèn)自動(dòng)。

可選：

• 'left'
• 'center'
• 'right'

rich 中如果沒有設(shè)置 align，則會(huì)取父層級(jí)的 align。例如：

{
    align: right,
    rich: {
        a: {
            // 沒有設(shè)置 `align`，則 `align` 為 right
        }
    }
}

verticalAlign

文字垂直對(duì)齊方式，默認(rèn)自動(dòng)。

可選值：

• 'top'
• 'middle'
• 'bottom'

rich 中如果沒有設(shè)置 verticalAlign，則會(huì)取父層級(jí)的 verticalAlign。例如：

{
    verticalAlign: bottom,
    rich: {
        a: {
            // 沒有設(shè)置 `verticalAlign`，則 `verticalAlign` 為 bottom
        }
    }
}

lineHeight

標(biāo)簽行高。

rich 中如果沒有設(shè)置 lineHeight，則會(huì)取父層級(jí)的 lineHeight。例如：

{
    lineHeight: 56,
    rich: {
        a: {
            // 沒有設(shè)置 `lineHeight`，則 `lineHeight` 為 56
        }
    }
}

backgroundColor

文字塊背景色。

可以是直接的顏色值，例如：'#123234', 'red', rgba(0,23,11,0.3)'。

可以支持使用圖片，例如：

backgroundColor: {
    image: 'xxx/xxx.png'
    // 這里可以是圖片的 URL，
    // 或者圖片的 dataURI，
    // 或者 HTMLImageElement 對(duì)象，
    // 或者 HTMLCanvasElement 對(duì)象。
}

當(dāng)使用圖片的時(shí)候，可以使用 width 或 height 指定高寬，也可以不指定自適應(yīng)。

如果設(shè)置為 'auto'，則為視覺映射得到的顏色，如系列色。

borderColor

文字塊邊框顏色。

如果設(shè)置為 'auto'，則為視覺映射得到的顏色，如系列色。

borderWidth

文字塊邊框?qū)挾取?/p>

borderRadius

文字塊的圓角。

padding

文字塊的內(nèi)邊距。例如：

• padding: [3, 4, 5, 6]：表示 [上, 右, 下, 左] 的邊距。
• padding: 4：表示 padding: [4, 4, 4, 4]。
• padding: [3, 4]：表示 padding: [3, 4, 3, 4]。

注意，文字塊的 width 和 height 指定的是內(nèi)容高寬，不包含 padding。

shadowColor

文字塊的背景陰影顏色。

shadowBlur

文字塊的背景陰影長(zhǎng)度。

shadowOffsetX

文字塊的背景陰影 X 偏移。

shadowOffsetY

文字塊的背景陰影 Y 偏移。

width

文字塊的寬度。一般不用指定，不指定則自動(dòng)是文字的寬度。在想做表格項(xiàng)或者使用圖片（參見 backgroundColor）時(shí)，可能會(huì)使用它。

注意，文字塊的 width 和 height 指定的是內(nèi)容高寬，不包含 padding。

width 也可以是百分比字符串，如 '100%'。表示的是所在文本塊的 contentWidth（即不包含文本塊的 padding）的百分之多少。之所以以 contentWidth 做基數(shù)，因?yàn)槊總€(gè)文本片段只能基于 content box 布局。如果以 outerWidth 做基數(shù)，則百分比的計(jì)算在實(shí)用中不具有意義，可能會(huì)超出。

注意，如果不定義 rich 屬性，則不能指定 width 和 height。

height

父節(jié)點(diǎn)標(biāo)簽區(qū)的高度，默認(rèn)為 20。

textBorderColor

文字本身的描邊顏色。

如果設(shè)置為 'auto'，則為視覺映射得到的顏色，如系列色。

textBorderWidth

文字本身的描邊寬度。

textShadowColor

文字本身的陰影顏色。

textShadowBlur

文字本身的陰影長(zhǎng)度。

textShadowOffsetX

文字本身的陰影 X 偏移。

textShadowOffsetY

文字本身的陰影 Y 偏移。

rich

在 rich 里面，可以自定義富文本樣式。利用富文本樣式，可以在標(biāo)簽中做出非常豐富的效果。

例如：

label: {
    normal: {

        // 在文本中，可以對(duì)部分文本采用 rich 中定義樣式。
        // 這里需要在文本中使用標(biāo)記符號(hào)：
        // `{styleName|text content text content}` 標(biāo)記樣式名。
        // 注意，換行仍是使用 '\n'。
        formatter: [
            '{a|這段文本采用樣式a}',
            '{b|這段文本采用樣式b}這段用默認(rèn)樣式{x|這段用樣式x}'
        ].join('\n'),

        rich: {
            a: {
                color: 'red',
                lineHeight: 10
            },
            b: {
                backgroundColor: {
                    image: 'xxx/xxx.jpg'
                },
                height: 40
            },
            x: {
                fontSize: 18,
                fontFamily: 'Microsoft YaHei',
                borderColor: '#449933',
                borderRadius: 4
            },
            ...
        }
    }
}

詳情參見教程：富文本標(biāo)簽

ellipsis

當(dāng)文字超出的時(shí)候，是否超出部分替換為省略號(hào)，默認(rèn)為 true。