echarts自定义tooltip提示框内容

秒速五厘米 2023-10-03 15:47 5阅读 0赞

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

先看效果和代码设置：

![watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamFja2xpbl8wMDE_size_20_color_FFFFFF_t_70_g_se_x_16][]

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][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` 是多个系列的数据数组。

打印如下：

![watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamFja2xpbl8wMDE_size_20_color_FFFFFF_t_70_g_se_x_16 1][]

由图可以看出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;  
\},

[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamFja2xpbl8wMDE_size_20_color_FFFFFF_t_70_g_se_x_16]: https://img-blog.csdnimg.cn/20210902114440129.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBAamFja2xpbl8wMDE=,size_20,color_FFFFFF,t_70,g_se,x_16
[https_echarts.apache.org_zh_option.html_tooltip.formatter]: https://echarts.apache.org/zh/option.html#tooltip.formatter
[trigger]: http://echarts.baidu.com/option.html#tooltip.trigger
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAamFja2xpbl8wMDE_size_20_color_FFFFFF_t_70_g_se_x_16 1]: https://img-blog.csdnimg.cn/20210902115247565.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBAamFja2xpbl8wMDE=,size_20,color_FFFFFF,t_70,g_se,x_16