**
tooltip //提示框组件。
出现位置
**
- 可以设置在全局,即 tooltip
- 可以设置在坐标系中,即 grid.tooltip、polar.tooltip、single.tooltip
- 可以设置在系列中,即 series.tooltip
- 可以设置在系列的每个数据项中,即 series.data.tooltip
示例
下面是一个示例,只列举部分属性 最下方有其余配置项简介
tooltip: {
show: true, // 是否显示提示框组件
trigger: 'axis', // 触发类型('item',数据项图形触发,主要在散点图,饼图等无类目轴的图表中使用;'axis',坐标轴触发,主要在柱状图,折线图等会使用类目轴的图表中使用;'none',不触发。)
axisPointer: {
type: 'line', // 指示器类型('line' 直线指示器;'shadow' 阴影指示器;'none' 无指示器;'cross' 十字准星指示器。)
snap: false, // 坐标轴指示器是否自动吸附到点上。默认自动判断。
label: {
margin: 10, // label 距离轴的距离
color: '#FFF', // 文字的颜色
fontStyle: 'normal', // 文字字体的风格('normal',无样式;'italic',斜体;'oblique',倾斜字体)
fontWeight: 'normal', // 文字字体的粗细('normal',无样式;'bold',加粗;'bolder',加粗的基础上再加粗;'lighter',变细;数字定义粗细也可以,取值范围100至700)
fontSize: '20', // 文字字体大小
lineHeight: '50', // 行高
padding = [5, 7, 5, 7], // 内边距,单位px
backgroundColor = 'auto', // 文本标签的背景颜色
}
}
showContent: true, // 是否显示提示框浮层,默认显示
alwaysShowContent: true, // 是否永远显示提示框内容,默认情况下在移出可触发提示框区域后一定时间后隐藏
confine: true, // 是否将 tooltip 框限制在图表的区域内
textStyle: {
color: '#FFF', // 文字的颜色
fontStyle: 'normal', // 文字字体的风格('normal',无样式;'italic',斜体;'oblique',倾斜字体)
fontWeight: 'normal', // 文字字体的粗细('normal',无样式;'bold',加粗;'bolder',加粗的基础上再加粗;'lighter',变细;数字定义粗细也可以,取值范围100至700)
fontSize: '20', // 文字字体大小
lineHeight: '50', // 行高
},
formatter: function (params) {
return '2022年数据' + '<br/>'
+ params[0].marker + params[0].seriesName + ':' + params[0].data + '<br>'
+ params[1].marker + params[1].seriesName + ':' + params[1].data + '<br>'
+ params[2].marker + params[2].seriesName + ':' + params[2].data
}
}
属性简单介绍
以下是tooltip的相关属性和配置项
tooltip:{
show:true, // 是否显示提示框组件。(包括提示框浮层和 axisPointer) boolean值 默认为false 不显示状态
backgroundColor:'rgba(50,50,50,0.7)',//提示框浮层的背景颜色。color
triggerOn :'mousemove|click', //提示框触发的条件 ECharts 3.0 中新加 可选 [mousemove click mousemove|click none] 不在 'mousemove' 或 'click' 时触发,用户可以通过 action.tooltip.showTip 和 action.tooltip.hideTip 来手动触发和隐藏。也可以通过 axisPointer.handle 来触发或隐藏。
borderColor:'#333',提示框浮层的边框颜色,
borderWidth:2,//提示框浮层的边框宽。单位px
padding:2,//提示框浮层内边距,单位px,默认各方向内边距为5,接受数组分别设定上右下左边距。
confine: true,//是否将 tooltip 框限制在图表的区域内。boolean 图表外层的 dom 被设置为 'overflow: hidden',或者移动端窄屏,导致 tooltip 超出外界被截断时,此配置比较有用。
textStyle:{ //提示框浮层的文本样式。
color: '#fff', //文字的颜色。
fontStyle: 'normal', //文字字体的风格。
fontWeight: 'normal', // 文字字体的粗细 string [ normal bold bolder lighter] number
//参数太多参考官方文档 不一一列举
}
enterable:false, //鼠标是否可进入提示框浮层中, boolean 默认为false,如需详情内交互,如添加链接,按钮,可设置为 true。
trigger:'axis', //提示框触发类型。trigger设置后默认提示框显示,string 'item'(数据项图形触发) 'axis'(坐标轴触发) 'none'(什么都不触发)
// 绝对位置,相对于容器左侧 10px, 上侧 10 px
position: [10, 10], //提示框浮层的位置,默认不设置时位置会跟随鼠标的位置 string Array Function
// 相对位置,放置在容器正中间 如采用function 可查看官方文档 内有详细的定位参数
// position: ['50%', '50%']
formatter:{ //提示框浮层内容格式器,支持字符串模板和回调函数两种形式。
//相关参数变量过多,建议查看官方文档
}
//tooltip.axisPointer 中诸配置项的优先级低于轴上的 axisPointer 的配置项。(例如 xAxis.axisPointer 或 angleAxis.axisPointer)
axisPointer:{ //坐标轴指示器。坐标轴触发有效 作用:提示图表中鼠标在各坐标轴当前刻度。
show:true,
type :'line',//指示器类型。 type设置后默认提示框显示 string 直线指示器 'line' 直线指示器 'shadow' 阴影指示器 'none' 无指示器 'cross' 十字准星指示器。
axis :'y',//指示器指向的坐标轴。string 默认自动取类目轴或者时间轴。 可选 'x', 'y', 'radius', 'angle'
snap:true,//坐标轴指示器是否自动吸附到点上。 boolean默认自动判断。这个功能在数值轴和时间轴上比较有意义,可以自动寻找细小的数值点。
z:99, //控制图形的前后顺序。z值小的图形会被z值大的图形覆盖。类似z-index
//文本标签
label:{ //坐标轴指示器的文本标签。
show:true ,//是否显示
//label属性太多就不展示了 可自己细看官方文档 { show , precision , formatter , margin , color , fontStyle , fontWeight , fontFamily , fontSize , lineHeight , width , height , textBorderColor , textBorderWidth , textBorderType , textBorderDashOffset , textShadowColor , textShadowBlur , textShadowOffsetX , textShadowOffsetY , overflow , ellipsis , padding , backgroundColor , borderColor , borderWidth , shadowBlur , shadowColor , shadowOffsetX , shadowOffsetY }
},
//指示器类型
lineStyle:{ // 指示器类型的样式 axisPointer.type 为 'line' 时有效。
//同样属性太多就不展示了 color , width , type , dashOffset , cap , join , miterLimit , shadowBlur , shadowColor , shadowOffsetX , shadowOffsetY , opacity
},
同样type为 'shadow' 'cross'时,也有对应样式
// shadowStyle:{
// //指示器类型的样式 axisPointer.type 为 'shadow' 时有效。
// }
// crossStyle:{
// //指示器类型的样式 axisPointer.type 为 'cross' 时有效。
// }
//动画效果
animation: true , //是否开启动画 boolean
animationThreshold :2000, //是否开启动画的阈值, num 当单个系列显示的图形数量大于这个阈值时会关闭动画。
animationDuration :1000,//初始动画的时长,num Function 支持回调函数,
// animationDuration : function (idx) {
// // 越往后的数据时长越大
// return idx * 100;
// }
animationEasing:'cubicOut',//初始动画的缓动效果 string
animationDelay:1000,//初始动画的延迟,number Function支持回调函数
animationDurationUpdate:1000,//数据更新动画的时长。number Function支持回调函数
animationEasingUpdate :'exponentialOut' ,//数据更新动画的缓动效果。 string
animationDelayUpdate:1000,//数据更新动画的延迟,支持回调函数,number Function
},
showContent:true,//是否显示提示框浮层,默认显示 boolean
alwaysShowContent:true,//是否永远显示提示框内容,该属性为 ECharts 3.0 中新加,默认情况下在移出可触发提示框区域后 一定时间 后隐藏,设置为 true 可以保证一直显示提示框内容。
showDelay:500, //浮层显示的延迟,num 单位为 ms,默认没有延迟,也不建议设置。在 triggerOn 为 'mousemove' 时有效。
hideDelay:500,//浮层隐藏的延迟,num 单位为 ms,在 alwaysShowContent 为 true 的时候无效。
enterable:false, //鼠标是否可进入提示框浮层中, boolean 默认为false,如需详情内交互,如添加链接,按钮,可设置为 true。
renderMode:'html',// 浮层的渲染模式,string 默认以 'html 即额外的 DOM 节点展示 tooltip; 还可以设置为 'richText' 表示以富文本的形式渲染,对于一些没有 DOM 的环境(如微信小程序)有更好的支持。
appendToBody:true,//是否将 tooltip 的 DOM 节点添加为 HTML 的 <body> 的子节点 从 v4.7.0 开始支持 boolean
transitionDuration:0.3,//提示框浮层的移动动画过渡时间,单位是 s,设置为 0 的时候会紧跟着鼠标移动。
extraCssText:'box-shadow: 0 0 3px rgba(0, 0, 0, 0.3);' , //额外附加到浮层的 css 样式 string,
order://多系列提示框浮层排列顺序。 string 默认值为 'seriesAsc' 可选[seriesAsc seriesDesc valueAsc valueDesc]
},