设置ECharts提示框组件指示器的文本标签

2018-09-21 10:16 更新

tooltip.axisPointer.label   |   Object

提示框组件中坐标轴指示器的文本标签。

tooltip.axisPointer.label.show   |   boolean

[ default: false ]

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

tooltip.axisPointer.label.precision   |   number, string

[ default: 'auto' ]

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

tooltip.axisPointer.label.formatter   |   string, Function

[ default: 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);
}

tooltip.axisPointer.label.margin   |   boolean

[ default: 3 ]

设置 label 距离轴的距离。

tooltip.axisPointer.label.textStyle   |   boolean

设置提示框组件指示器文本标签的文字样式。更多内容见下节

tooltip.axisPointer.label.padding   |   string, Array

[ default: [5, 7, 5, 7] ]

axisPointer 的内边距,单位px,默认各方向内边距为5,接受数组分别设定上右下左边距。

使用示例:

// 设置内边距为 5
padding: 5
// 设置上下的内边距为 5,左右的内边距为 10
padding: [5, 10]
// 分别设置四个方向的内边距
padding: [
    5,  // 上
    10, // 右
    5,  // 下
    10, // 左
]

tooltip.axisPointer.label.backgroundColor   |   string

[ default: 'auto' ]

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

tooltip.axisPointer.label.borderColor   |   string

[ default: null ]

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

tooltip.axisPointer.label.borderWidth   |   string

[ default: 0 ]

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

tooltip.axisPointer.label.shadowBlur   |   number

[ default: 3 ]

指示器文本标签的图形阴影的模糊大小。该属性配合 shadowColor,shadowOffsetX, shadowOffsetY 一起设置图形的阴影效果。

示例:

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

tooltip.axisPointer.label.shadowColor   |   Color

[ default: #aaa ]

指示器文本标签的阴影颜色。支持的格式同color。

tooltip.axisPointer.label.shadowOffsetX   |   number

[ default: 0 ]

提示框组件指示器阴影在水平方向上的偏移距离。

tooltip.axisPointer.label.shadowOffsetY   |   number

[ default: 0 ]

提示框组件指示器阴影在垂直方向上的偏移距离。


以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号