评论

[开盖即食]小程序图表插件 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 中使用 组件。注意路径的相对位置要写对,如果目录结构和本例相同,就应该像上面这样配置。

index.wxml 中创建了一个 组件:

<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} 
{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的话,建议控制数量,提供复用性~

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

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

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

1 个评论

  • xy
    xy
    08-02

    这种操作可以减免

    08-02
    赞同
    回复 3
登录 后发表内容