echarts自定义tooltip提示框内容

最近做一个展示需要在显示的tooltip上加上单位。。。需要自定义tooltip提示框内容效果如下

先看效果和代码设置：

tooltip: {
                    trigger: 'axis',
                    axisPointer: {            // 坐标轴指示器，坐标轴触发有效
                        type: 'cross',        // 默认为直线，可选为：'line' | 'shadow' 'cross'
                        lable:{

                        }
                    },
                    formatter:function (params) {
                        return '<div>'+params[0].name + '<br>' + params[0].marker+params[0].seriesName + ':' + '<span style="color: #00B83F;">'+params[0].value + '</span>MHZ'+'</div>';
                    }
                },

 本文主要是对echarts的tooltip提示功能的一个总结

官方参考链接：https://echarts.apache.org/zh/option.html#tooltip.formatter

tooltip的一些常用属性：

（1）提示内容对其方式：textStyle。

textStyle:{
align:'left'
},

tooltip的align的值可以有“center”、left、right，分别代表“居中对齐“、“左对齐”、“右对齐”。

（2）提示框触发方式：trigger

tooltip的trigger的值可以有'item'、'axis'。

'item':数据项图形触发，主要在散点图，饼图等无类目轴的图表中使用。

'axis':坐标轴触发，主要在柱状图，折线图等会使用类目轴的图表中使用

（3）提示框的格式：formatter

1. 字符串模板

2. 回调函数

回调函数格式：

(params: Object|Array, ticket: string, callback: (ticket: string, html: string)) => string | HTMLElement | HTMLElement[]

支持返回 HTML 字符串或者创建的 DOM 实例。

第一个参数 params 是 formatter 需要的数据集。格式如下：

{
    componentType: 'series',
    // 系列类型
    seriesType: string,
    // 系列在传入的 option.series 中的 index
    seriesIndex: number,
    // 系列名称
    seriesName: string,
    // 数据名，类目名
    name: string,
    // 数据在传入的 data 数组中的 index
    dataIndex: number,
    // 传入的原始数据项
    data: Object,
    // 传入的数据值。在多数系列下它和 data 相同。在一些系列下是 data 中的分量（如 map、radar 中）
    value: number|Array|Object,
    // 坐标轴 encode 映射信息，
    // key 为坐标轴（如 'x' 'y' 'radius' 'angle' 等）
    // value 必然为数组，不会为 null/undefied，表示 dimension index 。
    // 其内容如：
    // {
    //     x: [2] // dimension index 为 2 的数据映射到 x 轴
    //     y: [0] // dimension index 为 0 的数据映射到 y 轴
    // }
    encode: Object,
    // 维度名列表
    dimensionNames: Array<String>,
    // 数据的维度 index，如 0 或 1 或 2 ...
    // 仅在雷达图中使用。
    dimensionIndex: number,
    // 数据图形的颜色
    color: string,


    // 饼图的百分比
    percent: number,


}

 

这里主要是明白params代表的含义，可以使用console.log(params)或者alert(JSON.stringify(params));

在 trigger 为 'axis' 的时候 params 是多个系列的数据数组。

打印如下：

 

由图可以看出params主要是对象数组，params和echarts的series是关联的。这里数组的个数取决于series的个数，当series只有一个时，params也就是只有一个对象的数组。

由parmas的结构我们可以自由定义想要展示的提示数据。

例如：

formatter: function (params) {

var res='<div><p>时间：'+params[0].name+'</p></div>' 
for(var i=0;i<params.length;i++){
res+='<p>'+params[i].seriesName+':'+params[i].data+'</p>'
}
return res;
},