利用富文本樣式設置geo組件文本標簽

geo.label.normal.rich   |   Object

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

例如：

label: {
    normal: {

        // 在文本中，可以對部分文本采用 rich 中定義樣式。
        // 這里需要在文本中使用標記符號：
        // `{styleName|text content text content}` 標記樣式名。
        // 注意，換行仍是使用 '\n'。
        formatter: [
            '{a|這段文本采用樣式a}',
            '{b|這段文本采用樣式b}這段用默認樣式{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
            },
            ...
        }
    }
}

詳情參見教程：富文本標簽

geo.label.normal.rich.<user defined style name>   |   Object

geo.label.normal.rich.<user defined style name>.color   |   Color

[ default: "#fff" ]

文字的顏色。

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

geo.label.normal.rich.<user defined style name>.fontStyle   |   string

[ default: 'normal' ]

文字字體的風格

可選：

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

geo.label.normal.rich.<user defined style name>.fontWeight   |   string

[ default: normal ]

文字字體的粗細

可選：

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

geo.label.normal.rich.<user defined style name>.fontFamily   |   string

[ default: 'sans-serif' ]

文字的字體系列

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

geo.label.normal.rich.<user defined style name>.fontSize   |   number

[ default: 12 ]

文字的字體大小

geo.label.normal.rich.<user defined style name>.align   |   string

文字水平對齊方式，默認自動。

可選：

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

rich 中如果沒有設置 align，則會取父層級的 align。例如：

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

geo.label.normal.rich.<user defined style name>.verticalAlign   |   string

文字垂直對齊方式，默認自動。

可選：

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

rich 中如果沒有設置 verticalAlign，則會取父層級的 verticalAlign。例如：

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

geo.label.normal.rich.<user defined style name>.lineHeight   |   number

行高。

rich 中如果沒有設置 lineHeight，則會取父層級的 lineHeight。例如：

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

geo.label.normal.rich.<user defined style name>.backgroundColor   |   string, Object

[ default: 'transparent' ]

文字塊背景色。

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

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

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

當使用圖片的時候，可以使用 width 或 height 指定高寬，也可以不指定自適應。

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

geo.label.normal.rich.<user defined style name>.borderColor   |   string

[ default: 'transparent' ]

文字塊邊框顏色。

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

geo.label.normal.rich.<user defined style name>.borderWidth   |   number

[ default: 0 ]

文字塊邊框寬度。

geo.label.normal.rich.<user defined style name>.borderRadius   |   number, Array

[ default: 0 ]

文字塊的圓角。

geo.label.normal.rich.<user defined style name>.padding   |   number, Array

[ default: 0 ]

文字塊的內邊距。例如：

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

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

geo.label.normal.rich.<user defined style name>.shadowColor   |   string

[ default: 'transparent' ]

文字塊的背景陰影顏色。

geo.label.normal.rich.<user defined style name>.shadowBlur   |   number

[ default: 0 ]

文字塊的背景陰影長度。

geo.label.normal.rich.<user defined style name>.shadowOffsetX   |   number

[ default: 0 ]

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

geo.label.normal.rich.<user defined style name>.shadowOffsetY   |   number

[ default: 0 ]

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

geo.label.normal.rich.<user defined style name>.width   |   number, string

文字塊的寬度。一般不用指定，不指定則自動是文字的寬度。在想做表格項或者使用圖片（參見 backgroundColor）時，可能會使用它。

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

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

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

geo.label.normal.rich.<user defined style name>.height   |   number, string

文字塊的高度。一般不用指定，不指定則自動是文字的高度。在使用圖片（參見 backgroundColor）時，可能會使用它。

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

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

geo.label.normal.rich.<user defined style name>.textBorderColor   |   string

[ default: 'transparent' ]

文字本身的描邊顏色。

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

geo.label.normal.rich.<user defined style name>.textBorderWidth   |   number

[ default: 0 ]

文字本身的描邊寬度。

geo.label.normal.rich.<user defined style name>.textShadowColor   |   string

[ default: 'transparent' ]

文字本身的陰影顏色。

geo.label.normal.rich.<user defined style name>.textShadowBlur   |   number

[ default: 0 ]

文字本身的陰影長度。

geo.label.normal.rich.<user defined style name>.textShadowOffsetX   |   number

[ default: 0 ]

文字本身的陰影 X 偏移。

geo.label.normal.rich.<user defined style name>.textShadowOffsetY   |   number

[ default: 0 ]

文字本身的陰影 Y 偏移。

其實，在 ECharts 圖表中還可以使用 emphasis 來設置 geo 組件的文本標簽，該方法與 nomal 方法的使用方式相似，因此，這里就不再做過多的描述，有興趣的朋友可以參照 normal 方法進行設置。