如何在微信小程序开发中使用echarts

2026-01-08前端3 分钟270 次阅读
AI 摘要salmon-ai

本文详细解析了微信小程序中接入 ECharts 的完整流程,包括引入 `echarts-for-weixin` 组件、通过官网定制并替换精简版 `echarts.min.js`、

一、Echarts 简介

Echarts是一个基于JavaScript的开源可视化图表库,可以用于创建各种类型的图表,包括折线图、柱状图、散点图、饼图、地图等。Echarts具有丰富的交互功能,可以通过鼠标滚轮缩放、拖拽、点击等方式与图表进行交互,同时也支持动态数据更新和多图表联动等高级功能。Echarts的使用非常灵活,可以通过简单的配置实现各种复杂的图表效果,同时也支持自定义主题和扩展插件。Echarts广泛应用于数据可视化、商业分析、地理信息系统等领域。

二、在小程序中引入echarts

那如何将 echarts 引入到微信小程序项目中呢?

1.下载echarts插件

官网中介绍到:echarts-for-weixin 项目提供了一个小程序组件,用这种方式可以方便地使用 ECharts。
 
echarts-for-weixin 下载地址:https://github.com/ecomfe/echarts-for-weixin

下载下来后解压后目录文件如下:

将 ec-canvas 文件夹放置小程序的项目目录下

2.定制图形,生成 echarts.min.js 文件

因为小程序限制大小的原因 用 ec-canvas 目录中的 echarts.js 有些大,小程序后期上线对文件大小有要求,所以建议进行定制下载导入可减少文件大小占比。

接下来就是找到官网,去定制自己需要的图表
官网地址:https://echarts.apache.org/zh/builder.html

进入官网后,选择要打包的图表,其它默认,如下图所示:

翻到最下面,点击下载按钮,生成 echarts.min.js 文件,如下图:

3、替换 echarts.js 文件

下载完成后, 找到你下载的文件:echarts.min.js;然后把项目中 ec-canvas 目录中的 echarts.js 文件替换为 echarts.min.js;

注意: ec-canvas.js 的 import 引入的是原来的 echarts.js文件,你需要自己改成刚才下载的文件,如下图所示:

4、解决 addEventListener 报错问题

如果使用官网下载的 echarts.min.js 后报错:

复制代码
TypeError: t.domTarget.addEventListener is not a function

这是因为官网下载的是标准版 echarts,会调用 DOM API,而小程序没有 DOM 环境。

解决方案:在 wx-canvas.js 文件的 WxCanvas 类中添加空方法:

javascript 复制代码
export default class WxCanvas {
  // ... 其他代码

  addEventListener() {}
  
  // .... 其他代码
}

添加后即可正常使用官网定制的精简版 echarts。

三、小程序中使用 Echarts

上面我们已经将echarts引入到项目中了,接下来就是如何去使用它生成图表。下面我将以代码的形式详细阐述用法:

1、注册组件

在 app.json 中全局注册组件(也可以在页面的 json 中单独注册):

json 复制代码
{
  "usingComponents": {
    "ec-canvas": "/components/ec-canvas/ec-canvas"
  }
}

2、页面结构 (demo.wxml)

html 复制代码
<view class="container">
  <view class="chart-box">
    <ec-canvas id="myChart" canvas-id="myChart" ec="{{ ec }}"></ec-canvas>
  </view>
  <button bindtap="changeData">切换数据</button>
</view>

3、页面样式 (demo.wxss)

css 复制代码
.container {
  width: 100%;
  padding: 20rpx;
}
.chart-box {
  width: 100%;
  height: 500rpx;
}
/* 重要:ec-canvas 需要设置宽高 */
ec-canvas {
  width: 100%;
  height: 100%;
}

4、页面逻辑 (demo.js)

javascript 复制代码
// 引入 echarts
import * as echarts from '../../components/ec-canvas/echarts.min';

Page({
  data: {
    ec: {
      lazyLoad: true // 使用懒加载模式
    }
  },

  onLoad() {
    // 初始化图表数据
    const data = [120, 200, 150, 80, 70, 110, 130];
    this.initChart(data);
  },

  // 初始化图表
  initChart(data) {
    // 获取 ec-canvas 组件
    const ecComponent = this.selectComponent('#myChart');
    if (!ecComponent) {
      console.error('找不到 ec-canvas 组件');
      return;
    }

    // 调用组件的 init 方法
    ecComponent.init((canvas, width, height, dpr) => {
      // 初始化 echarts 实例
      const chart = echarts.init(canvas, null, {
        width: width,
        height: height,
        devicePixelRatio: dpr
      });

      // 配置图表选项
      const option = {
        xAxis: {
          type: 'category',
          data: ['周一', '周二', '周三', '周四', '周五', '周六', '周日']
        },
        yAxis: {
          type: 'value'
        },
        series: [{
          data: data,
          type: 'bar',
          itemStyle: {
            color: '#07c160'
          }
        }]
      };

      chart.setOption(option);

      // 保存 chart 实例,用于后续更新
      this.chartInstance = chart;

      // 必须返回 chart 实例
      return chart;
    });
  },

  // 动态更新数据
  changeData() {
    if (!this.chartInstance) return;

    // 生成新的随机数据
    const newData = Array.from({ length: 7 }, () => 
      Math.floor(Math.random() * 200) + 50
    );

    // 更新图表
    this.chartInstance.setOption({
      series: [{
        data: newData
      }]
    });
  }
});

5、折线图示例

javascript 复制代码
// 折线图配置
const lineOption = {
  grid: {
    left: 50,
    right: 20,
    top: 20,
    bottom: 30
  },
  xAxis: {
    type: 'category',
    data: ['1月', '2月', '3月', '4月', '5月', '6月'],
    axisLine: { lineStyle: { color: '#E5E5EA' } },
    axisLabel: { color: '#8E8E93', fontSize: 10 }
  },
  yAxis: {
    type: 'value',
    axisLine: { show: false },
    splitLine: { lineStyle: { color: '#F2F2F7', type: 'dashed' } }
  },
  series: [{
    data: [5.2, 5.3, 5.1, 5.4, 5.2, 5.5],
    type: 'line',
    smooth: true,
    symbol: 'circle',
    symbolSize: 8,
    lineStyle: { color: '#FF9500', width: 3 },
    itemStyle: { color: '#FF9500', borderColor: '#fff', borderWidth: 2 },
    areaStyle: {
      color: new echarts.graphic.LinearGradient(0, 0, 0, 1, [
        { offset: 0, color: 'rgba(255, 149, 0, 0.3)' },
        { offset: 1, color: 'rgba(255, 149, 0, 0.05)' }
      ])
    }
  }]
};

6、注意事项

  1. 必须设置宽高:ec-canvas 组件及其父容器必须设置明确的宽高,否则图表无法渲染
  2. 懒加载模式:推荐使用 lazyLoad: true,可以在数据准备好后再初始化图表
  3. 返回 chart 实例:init 回调函数必须返回 chart 实例
  4. 动态更新:保存 chart 实例后,可通过 chart.setOption() 动态更新数据
  5. 组件路径:确保 ec-canvas 组件路径正确,文件名要与 json 配置一致

四、效果

以下是我自己小程序运行的效果

觉得有用就点个赞,不用登录也能读

评论

0 条
登录 之后才能评论
—
还没有评论,来说第一句