echarts自定义信息提示框内容

默认情况下echarts的图表会提供鼠标移入每个数据标签时的数据提示功能。我们也可以用echarts的 tooltip 配置项来自定义提示框。

这里是 tooltip 官方文档

触发模式

主要有两个触发模式（每个模式触发时可展示的数据数量不同）：

1. 数据项图形触发（即鼠标移到某一个图形时出现信息提示框，多用于单项数据显示；会接收一个对应图形的数据对象）

1. 坐标轴触发（鼠标只要是移动到X坐标轴某项范围之内就会弹出信息提示框，常用于多项数据展示；会接收X轴某列的数据对象数组）

配置项tooltip

提示框组件可以设置在多种地方：

• 可以设置在全局，即 tooltip
• 可以设置在坐标系中，即 grid.tooltip、polar.tooltip、single.tooltip
• 可以设置在系列中，即 series.tooltip
• 可以设置在系列的每个数据项中，即 series.data.tooltip

tooltip中 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,

}

注意:

主要使用的属性有

• seriesName（类目名）
• marker（提示圆点）
• value（对应数据）

1. 数据项图形触发（单项数据展示）

单项数据展示时回调函数的参数是一个数据对象。

可以通过字符串拼接html片段进行自定义展示数据内容，也可以加自己的HTML字符串片段。

  tooltip: {
    trigger: 'axis',
    formatter: function (data) {
      return data[i].marker + data[i].seriesName  + ': '+ data[i].value+'<br/>';
    },
  },

2. 坐标轴触发（多项数据展示）

注意：其中的回调函数的参数是一个数组，所以想要数组每项的数据都展示需要遍历拼接html片段。

  tooltip: {
    trigger: 'axis',
    formatter: function (data) {
      var text = data[0].name + '<br/>', val;
      for(var i =0; i<data.length; i++){
        text += data[i].marker + data[i].seriesName  + ': '+ data[i].value+'<br/>';
      }
      return text;
    },
  },