ECharts如何使用平行坐標軸組件刻度標簽

本節(jié)幫助您了解在 ECharts 中如何通過平行坐標軸組件來使用刻度標簽，其中設(shè)置內(nèi)容較多，主要包括：

• 刻度標簽的顯示
  
• 刻度標簽的顯示間隔
  
• 刻度標簽旋轉(zhuǎn)的角度
  
• 刻度標簽的內(nèi)容格式器
  
• 刻度標簽文字的相關(guān)設(shè)置
  

parallelAxis.axisLabel   |  Object

坐標軸刻度標簽的相關(guān)設(shè)置。

parallelAxis.axisLabel.show   |   boolean

[ default: true ]

是否顯示刻度標簽。

parallelAxis.axisLabel.interval   |   number, Function

[ default: 'auto' ]

坐標軸刻度標簽的顯示間隔，在類目軸中有效。

默認會采用標簽不重疊的策略間隔顯示標簽。

可以設(shè)置成 0 強制顯示所有標簽。

如果設(shè)置為 1，表示『隔一個標簽顯示一個標簽』，如果值為 2，表示隔兩個標簽顯示一個標簽，以此類推。

可以用數(shù)值表示間隔的數(shù)據(jù)，也可以通過回調(diào)函數(shù)控制?；卣{(diào)函數(shù)格式如下：

(index:number, value: string) => boolean

第一個參數(shù)是類目的 index，第二個值是類目名稱，如果跳過則返回 false。

parallelAxis.axisLabel.inside   |   boolean

[ default: false ]

刻度標簽是否朝內(nèi)，默認朝外。

parallelAxis.axisLabel.rotate   |   number

[ default: 0 ]

刻度標簽旋轉(zhuǎn)的角度，在類目軸的類目標簽顯示不下的時候可以通過旋轉(zhuǎn)防止標簽之間重疊。

旋轉(zhuǎn)的角度從 -90 度到 90 度。

parallelAxis.axisLabel.margin   |   number

[ default: 8 ]

刻度標簽與軸線之間的距離。

parallelAxis.axisLabel.formatter   |   string, Function

[ default: null ]

刻度標簽的內(nèi)容格式器，支持字符串模板和回調(diào)函數(shù)兩種形式。

示例:

// 使用字符串模板，模板變量為刻度默認標簽 {value}
formatter: '{value} kg'
// 使用函數(shù)模板，函數(shù)參數(shù)分別為刻度數(shù)值（類目），刻度的索引
formatter: function (value, index) {
    // 格式化成月/日，只在第一個刻度顯示年份
    var date = new Date(value);
    var texts = [(date.getMonth() + 1), date.getDate()];
    if (index === 0) {
        texts.unshift(date.getYear());
    }
    return texts.join('/');
}

parallelAxis.axisLabel.showMinLabel   |   boolean

[ default: null ]

是否顯示最小 tick 的 label?？扇≈?nbsp;true, false, null。默認自動判定（即如果標簽重疊，不會顯示最小 tick 的 label）。

parallelAxis.axisLabel.showMaxLabel   |   boolean

[ default: null ]

是否顯示最大 tick 的 label?？扇≈?nbsp;true, false, null。默認自動判定（即如果標簽重疊，不會顯示最大 tick 的 label）。

parallelAxis.axisLabel.color   |   Color, Function

刻度標簽文字的顏色，默認取 axisLine.lineStyle.color。支持回調(diào)函數(shù)，格式如下

(val: string) => Color

參數(shù)是標簽的文本，返回顏色值，如下示例：

textStyle: {
    color: function (value, index) {
        return value >= 0 ? 'green' : 'red';
    }
}

parallelAxis.axisLabel.fontStyle   |   string

[ default: 'normal' ]

文字字體的風(fēng)格

可選：

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

parallelAxis.axisLabel.fontWeight   |   string

[ default: normal ]

文字字體的粗細

可選：

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

parallelAxis.axisLabel.fontFamily   |   string

[ default: 'sans-serif' ]

文字的字體系列

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

parallelAxis.axisLabel.fontSize   |   number

[ default: 12 ]

文字的字體大小

parallelAxis.axisLabel.align   |   string

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

可選：

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

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

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

parallelAxis.axisLabel.verticalAlign   |   string

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

可選：

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

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

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

parallelAxis.axisLabel.lineHeight   |   number

行高。

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

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

parallelAxis.axisLabel.backgroundColor   |   string, Object

[ default: 'transparent' ]

文字塊背景色。

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

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

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

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

parallelAxis.axisLabel.borderColor   |   string

[ default: 'transparent' ]

文字塊邊框顏色。

parallelAxis.axisLabel.borderWidth   |   number

[ default: 0 ]

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

parallelAxis.axisLabel.borderRadius   |   number, Array

[ default: 0 ]

文字塊的圓角。

parallelAxis.axisLabel.padding   |   number, Array

[ default: 0 ]

文字塊的內(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。

parallelAxis.axisLabel.shadowColor   |   string

[ default: 'transparent' ]

文字塊的背景陰影顏色。

parallelAxis.axisLabel.shadowBlur   |   number

[ default: 0 ]

文字塊的背景陰影長度。

parallelAxis.axisLabel.shadowOffsetX   |   number

[ default: 0 ]

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

parallelAxis.axisLabel.shadowOffsetY   |   number

[ default: 0 ]

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

parallelAxis.axisLabel.width   |   number, string

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

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

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

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

parallelAxis.axisLabel.height   |   number, string

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

注意，文字塊的 width 和 height 指定的是內(nèi)容高寬，不包含 padding；如果不定義 rich 屬性，則不能指定 width 和 height。

parallelAxis.axisLabel.textBorderColor   |   string

[ default: 'transparent' ]

文字本身的描邊顏色。

parallelAxis.axisLabel.textBorderWidth   |   number

[ default: 0 ]

文字本身的描邊寬度。

parallelAxis.axisLabel.textShadowColor   |   string

[ default: 'transparent' ]

文字本身的陰影顏色。

parallelAxis.axisLabel.textShadowBlur   |   number

[ default: 0 ]

文字本身的陰影長度。

parallelAxis.axisLabel.textShadowOffsetX   |   number

[ default: 0 ]

文字本身的陰影 X 偏移。

parallelAxis.axisLabel.textShadowOffsetY   |   number

[ default: 0 ]

文字本身的陰影 Y 偏移。

同樣，所有有關(guān)于標簽的設(shè)置，我們都可以使用 rich，即自定義富文本樣式來添加更多豐富的效果，因此 ECharts 平行坐標軸組件刻度標簽也可以使用富文本樣式，設(shè)置方法與之前介紹的標簽設(shè)置相同，這里不做過多的贅述。有關(guān) rich 的設(shè)置，請參考富文本標簽。