评论

[开盖即食]小程序图表插件 ECharts 实战

ECharts 图表(折线图,饼图,柱形图等)组件实战及一些注意事项

H5时代用来做图表的插件有很多比如:EChartsBizchartsJSCharts等,而这次的小程序本人选用了 ECharts 作为图表组件。

1、选择原因主要有3点:

  • 官方某度在持续维护这个插件
  • 官方推出了直接适配小程序的版本,且有demo,开盖即食,不用迁移
  • 简单实用,覆盖面广且可通过配置控制包的大小,小程序毕竟大小有限制~

eCharts来自BAT中的B前端团队,对应的小程序版本为:echarts-for-weixin

官网地址

https://echarts.apache.org/

github地址

https://github.com/ecomfe/echarts-for-weixin

小程序demo地址

https://github.com/ecomfe/echarts-examples

2、用法

(1)官方教程

index.json 配置如下:

{
  "usingComponents": {
    "ec-canvas": "../../ec-canvas/ec-canvas"
  }
}

这一配置的作用是,允许我们在 pages/bar/index.wxml 中使用 <ec-canvas> 组件。注意路径的相对位置要写对,如果目录结构和本例相同,就应该像上面这样配置。

index.wxml 中创建了一个 <ec-canvas> 组件:

<view class="container">
  <ec-canvas id="mychart-dom-bar" canvas-id="mychart-bar" ec="{{ ec }}"></ec-canvas>
</view>

其中 ec 是一个我们在 index.js 中定义的对象,它使得图表能够在页面加载后被初始化并设置。

index.js 配置:

function initChart(canvas, width, height, dpr) {
  const chart = echarts.init(canvas, null, {
    width: width,
    height: height,
    devicePixelRatio: dpr // 像素
  });
  canvas.setChart(chart);

  var option = {
    ...
  };
  chart.setOption(option);
  return chart;
}

Page({
  data: {
    ec: {
      onInit: initChart
    }
  }
});

这对于所有 ECharts 图表都是通用的,用户只需要修改上面 option 的内容,即可改变图表。option 的使用方法参见 ECharts 配置项文档

官方demo里的一些用法指导:

如何延迟加载图表?

参见 pages/lazyLoad 的例子,可以在获取数据后再初始化数据。

如何在一个页面中加载多个图表?

参见 pages/multiCharts 的例子。

如何使用 Tooltip?

目前,本项目已支持 ECharts Tooltip,但是由于 ECharts 相关功能尚未发版,因此需要使用当前本项目中 ec-canvas/echarts.js,这个文件包含了可以在微信中使用 Tooltip 的相关代码。目前在 ECharts 官网下载的 echarts.js 还不能直接替换使用,等 ECharts 正式发版后即可。
具体使用方法和 ECharts 相同,例子参见 pages/line/index.js

如何保存为图片?

参见 pages/saveCanvas 的例子。

(2)本人实战操作

import * as echarts from '../ec-canvas/echarts';
const app = getApp();
let chart;

function initChart(canvas, width, height, dpr) {
  chart = echarts.init(canvas, null, {
    width: width,
    height: height,
    devicePixelRatio: dpr // new
  });
  canvas.setChart(chart);

  chart.setOption(option);
  return chart;
}
var option = {
  title: {
    text: '智酷君 echarts 切换效果测试',
    left: 'center'
  },
  tooltip: {
      trigger: 'item',
      formatter: '{a} <br/>{b}: {c} ({d}%)'
  },
  legend: {
      orient: 'vertical',
      left: 10,
      data: ['AAA', 'BBB', 'CCC', 'DDD', 'EEE']
  },
  series: [
      {
          name: '访问来源',
          type: 'pie',
          radius: ['50%', '70%'],
          avoidLabelOverlap: false,
          label: {
              show: false,
              position: 'center'
          },
          emphasis: {
              label: {
                  show: true,
                  fontSize: '30',
                  fontWeight: 'bold'
              }
          },
          labelLine: {
              show: false
          },
          data: [
              {value: 335, name: 'AAA'},
              {value: 310, name: 'BBB'},
              {value: 234, name: 'CCC'},
              {value: 135, name: 'DDD'},
              {value: 1548, name: 'EEE'}
          ]
      }
  ]
};

Page({
  data: {
    ec: {
      onInit: initChart
    }
  },
  onLoad: function () {},
  //单曲线
  line() {
    let option2 = {
      title: {
        text: '同一canvas更新成折线图',
        left: 'center'
      },
      xAxis: {
        type: 'category',
        data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun']
      },
      yAxis: {
        type: 'value'
      },
      series: [{
        data: [820, 932, 901, 934, 1290, 1330, 1320],
        type: 'line'
      }]
    };
    chart.setOption(option2)
  },
  //切换柱状图
  bar(){
    let option3 = {
      title: {
        text: '直接更新数据,减少性能消耗',
        left: 'center'
      },
      xAxis: {
          type: 'category',
          data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun']
      },
      yAxis: {
          type: 'value'
      },
      series: [{
          data: [120, 200, 150, 80, 70, 110, 130],
          type: 'bar',
          showBackground: true,
          backgroundStyle: {
              color: 'rgba(220, 220, 220, 0.8)'
          }
      }]
    };
    chart.setOption(option3)
  }
})

建议大家尽量使用同一个canvas对象来切换不同的图表效果,而不是初始加载多个不同的,我们可以将 chart 对象设置为全局,然后通过 chart.setOption() 的方法来更新配置数据,可以减少性能消耗避免闪退等

(3)代码片段

代码段:https://developers.weixin.qq.com/s/OOTwnsms7Cin

建议将IDE工具升级到 1.02.18以上,避免一些BUG

3、Tips

(1)包大小可以配置

在线定制地址:

https://echarts.apache.org/zh/builder.html

通过选择和配置想要的功能,可以大大减少原本JS包的尺寸。

(2)Canvas 2d 版本要求

最新版的 ECharts 微信小程序支持微信 Canvas 2d,当用户的基础库版本 >= 2.9.0 且没有设置 force-use-old-canvas="true" 的情况下,使用新的 Canvas 2d(默认)。

使用新的 Canvas 2d 可以提升渲染性能,解决非同层渲染问题,强烈建议开启

如果仍需使用旧版 Canvas,使用方法如下:

<ec-canvas id="xxx" canvas-id="xxx" ec="{{ ec }}" force-use-old-canvas="true"></ec-canvas>

(3)数据点过多造成闪退和卡死

本人简单测试了下,iphone7p手机在1500个左右数据点的时候,出现了小程序闪退,iphoneX 测试下来大概在2500个左右,猜测可能由于微信本身给小程序的内存有限,所以建议大家控制数据点的个数

(4)单页面图表canvas加载过多卡死

建议单页面图表加载不要超过5个canvas,尽可能共用一个图表Canvas对象,通过动态更新数据的方式来展示内容(还有帅气的特效),如果一定要加载多个canvas的话,建议控制数量,提供复用性~

看完觉得有帮助记得点个赞哦~

你的赞是我继续分享的最大动力!^-^

最后一次编辑于  2020-06-29  
点赞 17
收藏
评论

15 个评论

  • Ocean🐬
    Ocean🐬
    2020-09-21

    我把基础库调整大于2.9的话,也没有使用force-use-old-canvas,页面就显示有问题,图标飘屏,这个force-use-old-canvas得使用只是版本强制使用旧版canvas吗?

    2020-09-21
    赞同
    回复
  • Ocean🐬
    Ocean🐬
    2020-09-21

    我把基础库调整大于2.9的话,也没有使用force-use-old-canvas,页面就显示有问题,图标飘屏,这个force-use-old-canvas得使用只是版本强制使用旧版canvas吗?

    2020-09-21
    赞同
    回复
  • .
    .
    2020-09-14

    现在有个问题,如果第一次编译出现了内容,第二次就不会出现,第三次才会又出现,一次类推,这个是什么情况?

    2020-09-14
    赞同
    回复 18
    • 圣殿骑士
      圣殿骑士
      2020-09-14
      报错吗?
      2020-09-14
      回复
    • .
      .
      2020-09-15回复圣殿骑士
      没报错,只是单纯的不显示,编译第一次显示的话,第二次百分百不会显示
      2020-09-15
      回复
    • .
      .
      2020-09-15回复圣殿骑士
      2020-09-15
      回复
    • .
      .
      2020-09-15
      2020-09-15
      回复
    • .
      .
      2020-09-15
      2020-09-15
      回复
    查看更多(13)
  • 许进
    许进
    2020-08-20

    不能共用一个图表,就没有其他办法了?dispose也不行?

    2020-08-20
    赞同
    回复 2
    • 圣殿骑士
      圣殿骑士
      2020-08-22
      这里是说不要多个,不是说只能一个,2-3个还好,主要和机器性能有关,具体用几个,可以通过用户分布来权衡,如果iphoneX和P/mate华为的人多,5个也问题不大
      2020-08-22
      回复
    • 许进
      许进
      2020-08-26回复圣殿骑士
      只能页面设计时,echarts图表最好为固定数量,每次加载重绘数据,而不是初始一个新的。ios系统上echarts表现不太好,感觉像插件的问题,因为我手绘canvas图表(是一个简单的图表),ios系统倒是没有出现闪退,发热现象。
      2020-08-26
      回复
  • xy
    xy
    2020-08-02

    这种操作可以减免

    2020-08-02
    赞同
    回复 4
    • 圣殿骑士
      圣殿骑士
      2020-08-02
      减免? 你是指引入指定的图表方法?
      2020-08-02
      回复
    • xy
      xy
      2020-08-02回复圣殿骑士
      这里可以做图表按需引入
      2020-08-02
      回复
    • 圣殿骑士
      圣殿骑士
      2020-08-02回复xy
      嗯嗯,是的
      2020-08-02
      回复
    • 阮蕊
      阮蕊
      2020-08-28回复圣殿骑士
      ?丶。。。
      2020-08-28
      回复

正在加载...

登录 后发表内容