設(shè)置yAxis坐標(biāo)軸刻度標(biāo)簽的屬性

2018-09-11 12:01 更新

本節(jié)介紹了 ECharts y 坐標(biāo)軸刻度標(biāo)簽的相關(guān)屬性設(shè)置,當(dāng)我們?cè)谠O(shè)置坐標(biāo)軸刻度標(biāo)簽的時(shí)候,首先要考慮的是要怎么才能將刻度標(biāo)簽給顯示出來,然后再考慮一些其它的屬性設(shè)置,這其中包含了:刻度標(biāo)簽的顯示間隔、刻度標(biāo)簽是朝內(nèi)還是朝外、怎么控制軸線與標(biāo)簽之間的距離、刻度標(biāo)簽的文本樣式該是怎樣的等等。詳細(xì)的設(shè)置介紹如下:

yAxis.axisLabel   |   Object

對(duì) y 坐標(biāo)軸的刻度標(biāo)簽進(jìn)行相關(guān)設(shè)置。

yAxis.axisLabel.show   |   boolean

[ default: true ]

是否顯示 y 坐標(biāo)軸的刻度標(biāo)簽。

yAxis.axisLabel.interval   |   number, Function

[ default: 'auto' ]

y 坐標(biāo)軸刻度標(biāo)簽的顯示間隔,在類目軸中有效。

默認(rèn)會(huì)采用標(biāo)簽不重疊的策略間隔顯示標(biāo)簽。
可以設(shè)置成 0 強(qiáng)制顯示所有標(biāo)簽。
如果設(shè)置為 1,表示『隔一個(gè)標(biāo)簽顯示一個(gè)標(biāo)簽』,如果值為 2,表示隔兩個(gè)標(biāo)簽顯示一個(gè)標(biāo)簽,以此類推。

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

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

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

yAxis.axisLabel.inside   |   boolean

[ default: false ]

設(shè)置 y 軸的刻度標(biāo)簽是否朝內(nèi),默認(rèn)情況下是朝外的。

yAxis.axisLabel.rotate   |   number

[ default: 0 ]

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

旋轉(zhuǎn)的角度的取值可以從 -90 度到 90 度。

yAxis.axisLabel.margin   |   number

[ default: 8 ]

控制刻度標(biāo)簽與軸線之間的距離。

yAxis.axisLabel.formatter   |   string, Function

[ default: null ]

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

示例:

// 使用字符串模板,模板變量為刻度默認(rèn)標(biāo)簽 {value}
formatter: '{value} kg'

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

yAxis.axisLabel.showMinLabel   |   boolean

[ default: null ]

表示是否顯示最小 tick 的 label??扇〉闹涤校簍rue, false, null。默認(rèn)自動(dòng)判定(即如果標(biāo)簽重疊,不會(huì)顯示最小 tick 的 label)。

yAxis.axisLabel.showMaxLabel   |   boolean

[ default: null ]

表示是否顯示最大 tick 的 label。可取的值有:true, false, null。默認(rèn)自動(dòng)判定(即如果標(biāo)簽重疊,不會(huì)顯示最大 tick 的 label)。

yAxis.axisLabel.color   |   Color, Function

設(shè)置 y 坐標(biāo)軸刻度標(biāo)簽文字的顏色,默認(rèn)取 axisLine.lineStyle.color。支持回調(diào)函數(shù),格式如下

(val: string) => Color

參數(shù)是標(biāo)簽的文本,返回顏色值,如下示例:

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

yAxis.axisLabel.fontStyle   |   string

[ default: 'normal' ]

設(shè)置 yAxis 刻度標(biāo)簽的文字字體的風(fēng)格

可選:

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

yAxis.axisLabel.fontWeight   |   string

[ default: normal ]

設(shè)置 y 軸刻度標(biāo)簽文字字體的粗細(xì)

可選:

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

yAxis.axisLabel.fontFamily   |   string

[ default: 'sans-serif' ]

設(shè)置 y 軸刻度標(biāo)簽文字的字體系列

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

yAxis.axisLabel.fontSize   |   number

[ default: 12 ]

文字的字體大小

yAxis.axisLabel.align   |   string

設(shè)置 y 軸刻度標(biāo)簽文字的水平對(duì)齊方式,默認(rèn)自動(dòng)。

可選:

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

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

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

yAxis.axisLabel.verticalAlign   |   string

設(shè)置 y 軸刻度標(biāo)簽文字的垂直對(duì)齊方式,默認(rèn)自動(dòng)。

可選:

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

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

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

yAxis.axisLabel.lineHeight   |   number

設(shè)置 y 軸刻度標(biāo)簽的行高。

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

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

yAxis.axisLabel.backgroundColor   |   string, Object

[ default: 'transparent' ]

設(shè)置 y 軸刻度標(biāo)簽文字塊的背景色。

  • 可以是直接的顏色值,例如:'#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)。

yAxis.axisLabel.borderColor   |   string

[ default: 'transparent' ]

設(shè)置 y 軸刻度標(biāo)簽文字塊的邊框顏色。

yAxis.axisLabel.borderWidth   |   number

[ default: 0 ]

設(shè)置 y 軸刻度標(biāo)簽文字塊的邊框?qū)挾取?/p>

yAxis.axisLabel.borderRadius   |   number, Array

[ default: 0 ]

設(shè)置 y 軸刻度標(biāo)簽文字塊的圓角。

yAxis.axisLabel.padding   |   number, Array

[ default: 0 ]

設(shè)置 y 軸刻度標(biāo)簽文字塊的內(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。

yAxis.axisLabel.shadowColor   |   string

[ default: 'transparent' ]

設(shè)置 y 軸刻度標(biāo)簽文字塊的背景陰影顏色。

yAxis.axisLabel.shadowBlur   |   number

[ default: 0 ]

設(shè)置 y 軸刻度標(biāo)簽文字塊的背景陰影長(zhǎng)度。

yAxis.axisLabel.shadowOffsetX   |   number

[ default: 0 ]

設(shè)置 y 軸刻度標(biāo)簽文字塊的背景陰影 X 偏移。

yAxis.axisLabel.shadowOffsetY   |   number

[ default: 0 ]

設(shè)置 y 軸刻度標(biāo)簽文字塊的背景陰影 Y 偏移。

yAxis.axisLabel.width   |   number, string

設(shè)置 y 軸刻度標(biāo)簽文字塊的寬度。

一般不用指定,不指定則自動(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。

yAxis.axisLabel.height   |   number, string

設(shè)置 y 軸刻度標(biāo)簽文字塊的高度。一般不用指定,不指定則自動(dòng)是文字的高度。在使用圖片(參見 backgroundColor)時(shí),可能會(huì)使用它。

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

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

yAxis.axisLabel.textBorderColor   |   string

[ default: 'transparent' ]

設(shè)置 y 軸刻度標(biāo)簽文字本身的描邊顏色。

yAxis.axisLabel.textBorderWidth   |   number

[ default: 0 ]

設(shè)置 y 軸刻度標(biāo)簽文字本身的描邊寬度。

yAxis.axisLabel.textShadowColor   |   string

[ default: 'transparent' ]

設(shè)置 y 軸刻度標(biāo)簽文字本身的陰影顏色。

yAxis.axisLabel.textShadowBlur   |   number

[ default: 0 ]

設(shè)置 y 軸刻度標(biāo)簽文字本身的陰影長(zhǎng)度。

yAxis.axisLabel.textShadowOffsetX   |   number

[ default: 0 ]

設(shè)置 y 軸刻度標(biāo)簽文字本身的陰影 X 偏移。

yAxis.axisLabel.textShadowOffsetY   |   number

[ default: 0 ]

設(shè)置 y 軸刻度標(biāo)簽文字本身的陰影 Y 偏移。

以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)