炫意html5
最早CSS3和HTML5移动技术网站之一

ECharts – tooltip详解(2)——trigger

本文包含echarts中自定义提示框触发方式及其对应的方法和实例。

提示框触发方式:trigge

在提示框组件tooltip详解(1)中我们说过:

提示框触发方式trigger的取值可以有两种分别为:

  • ‘item’:数据项图形触发,主要在散点图,饼图等无类目轴的图表中使用。
  • ‘axis’:坐标轴触发,主要在柱状图,折线图等会使用类目轴的图表中使用

结合实例举例说明

下面我们以之前写过的树懒课堂总部一周气温变化这个实例为例:

完整代码如下:

<html>
<head>
<script src="https://www.shulanxt.com/visualization/echarts/tooltip-trigger/echarts.js"></script>
</head>
<body>
<!-- 为ECharts准备一个具备大小(宽高)的Dom -->
<div></div>
<script type="text/javascript">
// 基于准备好的dom,初始化echarts实例
var myChart = echarts.init(document.getElementById('main'));
// 指定图表的配置项和数据
var option = {
title: {
text: '树懒课堂总部一周气温变化', //标题
subtext: '纯属虚构' //子标题
},
tooltip: {//提示框,鼠标悬浮交互时的信息提示
trigger: 'item'//值为axis显示该列下所有坐标轴对应数据,值为item时只显示该点数据
},
legend: { //图例,每个图表最多仅有一个图例
data: ['最高气温', '最低气温']
},
toolbox: {//工具栏
show: true,
feature: {
mark: {
show: true
},
dataView: { //数据视图
show: true,
readOnly: false//是否只读
},
magicType: {//切换图表
show: true,
type: ['line', 'bar', 'stack', 'tiled']//图表
},
restore: {//还原原始图表
show: true
},
saveAsImage: {//保存图片
show: true
}
}
},
calculable: true,//是否启用拖拽重计算特性
xAxis: [{
type: 'category',  //坐标轴类型,横轴默认为类目型'category'
boundaryGap: false,
data: ['周一', '周二', '周三', '周四', '周五', '周六', '周日']//数据项
}],
yAxis: [{
type: 'value', //坐标轴类型,纵轴默认为数值型'value'
axisLabel: {
formatter: '{value} °C' //加上单位
}
}],
series: [{//设置图表数据
name: '最高气温', //系列名称,如果启用legend,该值将被legend.data索引相关
type: 'line',//图表类型
data: [11, 11, 15, 13, 12, 13, 10],
markPoint: {  //系列中的数据标注内容
data: [{
type: 'max',
name: '最大值'
},
{
type: 'min',
name: '最小值'
}]
},
markLine: {//系列中的数据标线内容
data: [{
type: 'average',
name: '平均值'
}]
}
},
{
name: '最低气温',
type: 'line',
data: [1, -2, 2, 5, 3, 2, 0],
markPoint: {
data: [{
name: '周最低',
value: -2,
xAxis: 1,
yAxis: -1.5
}]
},
markLine: {
data: [{
type: 'average',
name: '平均值'
}]
}
}]
};
// 使用刚指定的配置项和数据显示图表。
myChart.setOption(option);</script>
</body>
</html>

其中与提示框tooltip有关的为如下代码,提示框即鼠标悬浮交互时的信息提示:

tooltip: {
trigger: 'item'
}

上述代码只设置了一个trigger属性,设置了提示框触发方式

实例1:当trigger属性的值为 ‘item’时:

提示框只显示该点数据,如下图所示:

我们可以看到当从当鼠标移至蓝圈所示位置时,提示框显示的内容如红框内所示,提示框只显示该点的数据即周四的最高气温为13℃。

实例2:当trigger属性的值为 ‘axis’时:

当提示框触发方式为‘axis’时图表又是什么样的呢?下面我们来修改代码一探究竟:

我们将与提示框tooltip有关的代码改为如下代码(只修改了trigger属性):

tooltip: {
trigger: 'axis'
}

运行实例效果如下图所示:

我们可以看到当鼠标移至与上次相同的位置(蓝圈所示位置)时,提示框显示的内容与上次显示的内容不同,提示框显示了鼠标所在的那一列下所有坐标轴对应数据(最高温13,最低温5)。与上文对trigger属性的解释相对应。

还需注意的时:trigger的·默认值为‘item’。

tigger属性的两种取值的应用场景

综上,我们可以得出‘item’适用于显示当前单个数据项的提示框,‘axis’适用于显示当前横坐标下多个数据项的提示框。大家在使用的时候要根据自己的实际需求使用。

炫意HTML5 » ECharts – tooltip详解(2)——trigger

Java基础教程Android基础教程