100字范文,内容丰富有趣,生活中的好帮手!
100字范文 > 在echarts中自定义提示框内容

在echarts中自定义提示框内容

时间:2019-07-03 07:46:04

相关推荐

在echarts中自定义提示框内容

1、期望效果

以柱状图为例,在鼠标滑过每个数据标签时,为了更友好地显示数据内容,需要对显示的数据内容作格式化处理,添加自定义内容。

如下图,鼠标滑过每个数据项时,

第1张是默认提示框;

第2张是处理成百分比数据后,显示当前单个数据项的提示框;

第3张是处理成百分比数据后,显示当前横坐标下多个数据项的提示框。

图1、默认提示框.jpg 图2、单项提示框.jpg 图3、多项提示框.jpg

2、实现

(本文代码只涉及配置项的部分代码)

上述图片的效果可用echarts的tooltip组件中的一个formatter方法实现,formatter支持字符串和回调函数两种配置方式(本文只描述回调函数的实现方式)。

(具体参考:/option.html#tooltip.formatter)。

2.1 显示单项数据内容

(处理上图2提示框的效果)

/*** tooltip配置项示例*///用formatter回调函数显示单项数据内容tooltip: {trigger: 'item', formatter: function(data) { return data.name + '<br/>' +data.seriesName + ':'+(data.value * 100)+'%'; //将小数转化为百分数显示 } }

2.2 显示多项数据内容

(处理上图3提示框的效果)

/*** tooltip配置项示例*///用formatter回调函数显示多项数据内容tooltip: {trigger: 'axis', formatter: function(datas) { var res = datas[0].name + '<br/>', val; for(var i = 0, length = datas.length; i < length; i++) { val = (datas[i].value*100) + '%'; res += datas[i].seriesName + ':' + val + '<br/>'; } return res; } }

2.3 formatter回调函数的传参

formatter回调函数的传参格式为:

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

描述:

1、params:

(1)当tooltip的trigger为‘item’时,显示单项数据内容。formatter回调函数的第一个参数传入一个数据项对象;

(2)当tooltip的trigger为‘axis’时,显示多项数据内容数组。formatter回调函数的第一个参数传入当前类目下的数据项对象数组。

2、ticket:异步回调标识,无需关心,用作callback的传参。

3、callback:异步回调函数,传递ticket与填充内容的html两个参数。

当tooltip的trigger为‘item’时,在控制台中输出的单项数据示例对象为:

{$vars: ["seriesName", "name", "value"],color: "#c23531", componentSubType: "bar", componentType: "series", data: 0.6, dataIndex: 2, dataType: undefine, dname: "1月3日", seriesIndex: 0, seriesName: "iphone6", seriesType: "bar", value: 0.6 }

其中,几个重要的data对象属性如下:

seriesName:系列名称

value:当前数据值

name:数据名,类目名(上述柱状图中表示当前横坐标数据名)

模拟异步返回提示框内容如下:

//用formatter回调函数模拟异步返回提示框内容tooltip: {trigger: 'item', formatter: function(param, ticket, callback) { //用定时器模拟异步事件 setTimeout(function() { var res = param.name + '<br/>' +param.seriesName + ':'+(param.value * 100)+'%'; callback(ticket, res); }, 1000); return '';//内容还没返回时显示的内容 } }

3、扩展-其他配置项的formatter

3.1 直角坐标轴(xAxis/yAxis)中axisLabel的formatter

显示效果为上图2-单项提示框的y轴刻度数据。

//yAxis/xAxis配置项示例——用axisLabel 的formatter回调函数处理数据格式yAxis: {name: '销量占比',axisLabel : { formatter: function(value) { if(value == 0) { return value; }else { return value*100+'%'; } } } }

链接:/p/aa585c304660

本内容不代表本网观点和政治立场,如有侵犯你的权益请联系我们处理。
网友评论
网友评论仅供其表达个人看法,并不表明网站立场。