提供了编程的基础技术教程

zl程序教程

您现在的位置是：首页 >  其他

当前栏目

ECharts 提示框组件Tooltip属性详解

属性echarts组件 详解 提示框 tooltip
2023-09-27 14:29:07 时间 
tooltip: {                                                      // 提示框组件:可以设置在全局(tooltip)，可以设置在坐标系中(grid.tooltip、polar.tooltip、single.tooltip)，可以设置在系列中(series.tooltip)，可以设置在系列的每个数据项中(series.data.tooltip)
    show: true,                                                 // 是否显示提示框组件。包括提示框浮层和 axisPointer。
    trigger: 'item',                                            // 触发类型,'item'数据项图形触发，主要在散点图，饼图等无类目轴的图表中使用。 'axis'坐标轴触发，主要在柱状图，折线图等会使用类目轴的图表中使用。'none' 什么都不触发
    triggerOn: 'mousemove',                                     // 提示框触发的条件,'mousemove'鼠标移动时触发。'click'鼠标点击时触发。'mousemove|click'同时鼠标移动和点击时触发。'none'不在 'mousemove' 或 'click' 时触发
    showContent: true,                                          // 是否显示提示框浮层，默认显示。只需tooltip触发事件或显示axisPointer而不需要显示内容时可配置该项为false
    alwaysShowContent: true,                                    // 是否永远显示提示框内容，默认情况下在移出可触发提示框区域后一定时间(见下方hideDelay睡醒)后隐藏，设置为true可以保证一直显示提示框内容
    showDelay: 0,                                               // 浮层显示的延迟，单位为 ms，默认没有延迟，也不建议设置。在triggerOn(提示框触发的条件)为 'mousemove' 时有效
    hideDelay: 100,                                             // 浮层隐藏的延迟，单位为 ms，在alwaysShowContent为true的时候无效
    enterable: false,                                           // 鼠标是否可进入提示框浮层中，默认为false，如需详情内交互，如添加链接，按钮，可设置为true
    renderMode: 'html',                                         // 浮层的渲染模式，默认以'html'即额外的DOM节点展示tooltip；此外还可以设置为'richText'表示以富文本的形式渲染，渲染的结果在图表对应的Canvas中（目前SVG尚未支持富文本），这对于一些没有DOM的环境（如微信小程序）有更好的支持。
    confine: false,                                             // 是否将tooltip框限制在图表的区域内。当图表外层的dom被设置为'overflow:hidden'，或者移动端窄屏，导致tooltip超出外界被截断时，此配置比较有用
    appendToBody: false,                                        // (从v4.7.0开始支持)是否将tooltip的DOM节点添加为HTML的<body>的子节点。只有当renderMode为'html'是有意义的
    className: 'echarts-tooltip echarts-tooltip-dark'           // (从v5.0.0开始支持)指定 tooltip 的 DOM 节点的 CSS 类。（只在 html 模式下生效）
    transitionDuration: 0.4,                                    // 提示框浮层的移动动画过渡时间，单位是s，设置为0的时候会紧跟着鼠标移动。
    position: ['50%', '50%'],                                   // (这里是相对位置，放置在容器正中间)提示框浮层的位置，默认不设置时位置会跟随鼠标的位置,[10, 10],回掉函数，inside鼠标所在图形的内部中心位置，top、left、bottom、right鼠标所在图形上侧，左侧，下侧，右侧，
    //formatter: '{b0}: {c0}<br />{b1}: {c1}',                    // 提示框浮层内容格式器，支持字符串模板和回调函数两种形式,模板变量有 {a}, {b}，{c}，{d}，{e}，分别表示系列名，数据名，数据值等，具体见下图
    formatter: function (params) {
      console.log("--x轴类目对应的参数数组--", params); // 比如当鼠标hover到孙悟空同学这一列的时候，这个params数组存放的每一项数据分别是语数外三门成绩的具体信息
      var res = // 字符串形式的html标签会被echarts转换渲染成数据，这个res主要是画的tooltip里的上部分的标题部分
        "<div style='margin-bottom:5px;padding:0 12px;width:100%;height:24px;line-height:24px;background:pink;border-radius:3px;'><p>" +
        params[0].name +
        " </p></div>";
      for (var i = 0; i < params.length; i++) {
        //因为是个数组，所以要遍历拿到里面的数据，并加入到tooltip的数据内容部分里面去
        res += `<div style="color: #fff;font-size: 14px; padding:0 12px;line-height: 24px">
            <span style="display:inline-block;margin-right:5px;border-radius:2px;width:10px;height:10px;background-color:${[
              params[i].color, // 默认是小圆点，我们将其修改成有圆角的正方形，这里用的是模板字符串。并拿到对应颜色、名字、数据
            ]};"></span>
            ${params[i].seriesName}
            ${params[i].data}分
          </div>`;
      }
      return res; // 经过这么一加工，最终返回出去并渲染，最终就出现了我们所看的效果
    },
    backgroundColor: 'rgba(50,50,50,0.7)',                      // 提示框浮层的背景颜色
    borderColor: '#333',                                        // 提示框浮层的边框颜色
    borderWidth: 0,                                             // 提示框浮层的边框宽
    padding: [
        5,  // 上
        10, // 右
        5,  // 下
        10, // 左
    ],                                                          // 提示框浮层内边距，单位px，默认各方向内边距为5，接受数组分别设定上右下左边距
    textStyle: {                                                // 提示框浮层的文本样式
        color: '#fff',                                          // 文字的颜色
        fontStyle: 'normal',                                    // 文字字体的风格 可选：'normal'(常规) 'italic'(斜体) 'oblique'(倾斜)
        fontWeight: 'normal',                                   // 文字字体的粗细 可选：'normal'(常规) 'bold'(粗体) 'bolder'(加粗) 'lighter'(细体) 100 | 200 | 300 | 400...(像素)
        fontFamily: 'sans-serif',                               // 文字的字体系列 'serif' , 'monospace', 'Arial', 'Courier New', 'Microsoft YaHei', ...
        fontSize: 14,                                           // 文字的字体大小
        lineHeight: 56,                                         // 行高
        width: 15,                                              // 文本显示宽度
        height: 15,                                             // 文本显示高度
        textBorderColor: '#333',                                // 文字本身的描边颜色
        textBorderWidth: 2,                                     // 文字本身的描边宽度
        textBorderType: 'solid',                                // 文字本身的描边类型  可选：'solid'(实线) 'dashed'(虚线) 'dotted' 自v5.0.0开始，也可以是number或者number数组 如：textBorderType: [5, 10]，用以指定线条的 dash array，配合textBorderDashOffset可实现更灵活的虚线效果
        textBorderDashOffset: 5,                                // (从v5.0.0开始支持)用于设置虚线的偏移量，可搭配 textBorderType 指定 dash array 实现灵活的虚线效果
        textShadowColor: 'transparent',                         // 文字本身的阴影颜色
        textShadowBlur: 0,                                      // 文字本身的阴影长度
        textShadowOffsetX: 0,                                   // 文字本身的阴影X偏移
        textShadowOffsetY: 0,                                   // 文字本身的阴影Y偏移
        overflow: 'none',                                       // 文字超出宽度是否截断或者换行。配置width时有效'truncate'截断，并在末尾显示ellipsis配置的文本，默认为... 'break' 换行'breakAll'换行，跟'break'不同的是，在英语等拉丁文中，'breakAll'还会强制单词内换行
        textShadowBlur: 0,                                      // 文字本身的阴影长度
        ellipsis: '这里是末尾显示的文本',                        // 在overflow配置为'truncate'的时候，可以通过该属性配置末尾显示的文本
        extraCssText: 'box-shadow: 0 0 3px rgba(0, 0, 0, 0.3);',// 额外附加到浮层的css样式。如左面为浮层添加阴影的示例
        order: 'seriesAsc',                                     // (从v5.0.0开始支持)多系列提示框浮层排列顺序。默认值为 'seriesAsc' 提示框排列顺序可选值:'seriesAsc'根据系列声明, 升序排列。 'seriesDesc'根据系列声明, 降序排列。 'valueAsc'根据数据值, 升序排列。 'valueDesc'根据数据值, 降序排列。
    },                                   
    extraCssText: 'box-shadow: 0 0 3px rgba(0, 0, 0, 0.3);' ,   // 额外附加到浮层的css样式。如左面为浮层添加阴影的示例
    order：'seriesAsc'，                                        // (从v5.0.0开始支持)多系列提示框浮层排列顺序。默认值为 'seriesAsc'
    // 注意版本支持
};

附图：提示框浮层内容格式器 formatter: ‘{b0}: {c0} {b1}: {c1}’ 格式化
在这里插入图片描述

相关文章