设置y轴坐标轴指示器的文本标签

本节我们一起来学习 ECharts 中 yAxis 是如何设置其坐标轴指示器的文本标签的。首先，需要将文本标签显示出来，使用的是 axisPointer.label.show，然后就可以对坐标轴指示器的文本标签进行设置了，详细内容如下：

yAxis.axisPointer.label

Object 坐标轴指示器的文本标签。

yAxis.axisPointer.label.show

boolean [ 默认值: false ]

是否显示 y 轴坐标轴指示器的文本标签。如果 tooltip.axisPointer.type 设置为 'cross' 则默认显示标签，否则默认不显示。

yAxis.axisPointer.label.precision

number, string [ 默认值: 'auto' ]

yAxis 坐标轴指示器文本标签中数值的小数点精度。默认根据当前轴的值自动判断。也可以指定如 2 表示保留两位小数。

yAxis.axisPointer.label.formatter

string, Function [ 默认值: null ]

坐标轴指示器文本标签文字的格式化器。

如果为 string，可以是例如：

formatter: 'some text {value} some text

其中 {value} 会被自动替换为轴的值。

如果为 function，可以是例如：

参数：

{Object} params: 含有：

{Object} params.value: 轴当前值，如果 axis.type 为 'category' 时，其值为 axis.data 里的数值。如果 axis.type 为 'time'，其值为时间戳。

{Array.<Object>} params.seriesData: 一个数组，是当前 axisPointer 最近的点的信息，每项内容为：

{
    componentType: 'series',
    // 系列类型
    seriesType: string,
    // 系列在传入的 option.series 中的 index
    seriesIndex: number,
    // 系列名称
    seriesName: string,
    // 数据名，类目名
    name: string,
    // 数据在传入的 data 数组中的 index
    dataIndex: number,
    // 传入的原始数据项
    data: Object,
    // 传入的数据值
    value: number|Array,
    // 数据图形的颜色
    color: string,

}

每项内容还包括轴的信息：

{
    axisDim: 'x', // 'x', 'y', 'angle', 'radius', 'single'
    axisId: 'xxx',
    axisName: 'xxx',
    axisIndex: 3,
    axisValue: 121, // 当前 axisPointer 对应的 value。
    axisValueLabel: '文本'
}

返回值： 显示的 string。

例如：

formatter: function (params) {
    // 假设此轴的 type 为 'time'。
    return 'some text' + echarts.format.formatTime(params.value);
}

yAxis.axisPointer.label.margin

boolean [ 默认值: 3 ]

yAxis 坐标轴指示器的文本标签距离 y 轴的距离。

yAxis.axisPointer.label.backgroundColor

string [ 默认值: 'auto' ]

yAxis 坐标轴指示器文本标签的背景颜色，默认是和 axis.axisLine.lineStyle.color 相同。

yAxis.axisPointer.label.borderColor

string [ 默认值: null ]

yAxis 坐标轴指示器文本标签的边框颜色。

yAxis.axisPointer.label.borderWidth

string [ 默认值: 0 ]

yAxis 坐标轴指示器文本标签的边框宽度。

yAxis.axisPointer.label.shadowBlur

number [ 默认值: 3 ]

yAxis 坐标轴指示器图形阴影的模糊大小。

该属性配合 shadowColor,shadowOffsetX, shadowOffsetY 一起设置图形的阴影效果。

示例：

{
    shadowColor: 'rgba(0, 0, 0, 0.5)',
    shadowBlur: 10
}

yAxis.axisPointer.label.shadowColor

Color [ 默认值: #aaa ]

yAxis 坐标轴指示器阴影的颜色。支持的格式同color。

yAxis.axisPointer.label.shadowOffsetX

number [ 默认值: 0 ]

yAxis 坐标轴指示器阴影在水平方向上的偏移距离。

yAxis.axisPointer.label.shadowOffsetY

number [ 默认值: 0 ]

yAxis 坐标轴指示器阴影在垂直方向上的偏移距离。