tooltip 的formatter

最新推荐文章于 2025-03-13 10:54:35 发布

原创最新推荐文章于 2025-03-13 10:54:35 发布 · 1.3w 阅读

12 ·

CC 4.0 BY-SA版权

echarts 专栏收录该内容

2 篇文章

订阅专栏

本文深入讲解ECharts中的Tooltip组件，探讨其在不同场景下的应用，包括全集、坐标系及系列数据项中的设置方法。特别关注formatter属性，介绍字符串模板与回调函数的使用技巧，并提供自定义内容展示的实例。

tooltip 就是echarts 中的提示框组件

下图中框起来的部分就是通过tooltip 显示的东东。

使用起来，参考官方API，可以设置在全集，可以设置在坐标系中也可以设置在系列中，还可以设置在系列的每个数据项中。

tooltip有很多属性，其中一个属性就是formatter ，它是提示框浮层内容格式器，也就是具体显示的数值信息哪个框里的内容。

它支持字符串模板和回调函数两种形式。

官方：

字符串模板就比较容易，直接使用即可。回调函数，使用过，因为需要在浮动框中添加我们自定义的一句话。官方：其中具体参数的属性，请翻官方文档，写的很全。

下面给出我们添加自定义的一句话，以及实现原本的默认样式的例子：

        option = {
            title: {
                text: "",
            },
            tooltip: {
                trigger: "axis",
                confine: true,
                enterable: true,
                formatter: function (params, ticket, callback) {
                    var tipString = params[0].axisValue + "<br />";
                    var indexColor;
                    for (var i = 0, length = params.length; i < length; i++) {
                        indexColor = params[i].color;
                        tipString += '<span style="display:inline-block;margin-right:5px;border-radius:10px;width:9px;height:9px;background:'+ indexColor +'"></span>';
                        tipString += params[i].seriesName + '：' + params[i].value + '<br />';
                    }
                    if (!isEmptyObject(counterArr)) {
                        if (counterArr.length > 0) {
                            if (counterArr.indexOf(v.counter) != -1) {
                                tipString += "[ 点击查看进程详情 ]"
                            }
                        }
                    }
                    return tipString;
                }
            }
        }