Taro3+ React小程序中实现echarts图表 ec-canvas(echarts-for-weixin)

一、环境准备与组件引入

1. 获取官方组件库

从GitHub下载 echarts-for-weixin 项目,将 ec-canvas 文件夹复制到Taro项目 /src/components 目录下(需保证路径层级合理)

2. 修复兼容性问题

在这里我们会遇到一个报错修改 ec-canvas/echarts.js 文件,找到以下代码:t.addEventListener(e, n, i)

改为:t.addEventListener?.(e, n, i) // 增加可选链操作符避免Taro编译报错

3.#### 定制化构建ECharts

  1. 访问 ECharts在线构建器

  2. 仅勾选需要的图表类型(如折线图、柱状图)

  3. 下载生成的 echarts.min.js 并替换项目中的 ec-canvas/echarts.js 可使包体积从1MB+降至300KB左右。选自己常用的图表。

二、Taro项目配置

在 config/index.js 中添加小程序编译配置:

javascript 复制代码
const config = { mini: { postcss: { /*...*/ }, // 允许引入原生小程序组件
                compile: { exclude: [ /src/components/ec-canvas/ // 排除ec-canvas编译 ] }
     } }

2. 页面组件声明

在需要使用图表的页面配置文件 页面名.config.js 中声明组件(一定是要用相对地址 不然就会报错或者渲染不出来):

arduino 复制代码
export default { navigationBarTitleText: '图表页',
  usingComponents: { "ec-canvas": "../../components/ec-canvas/ec-canvas" } 
 }

三、基础图表实现

1. WXML结构

2. 样式设置一定要设置高度

3. 图表初始化逻辑

五、性能优化技巧

1. 定制化构建ECharts

  1. 访问 ECharts在线构建器

  2. 仅勾选需要的图表类型(如折线图、柱状图)

  3. 下载生成的 echarts.min.js 并替换项目中的 ec-canvas/echarts.js 可使包体积从1MB+降至300KB左右 。

2. 分包加载策略

将 ec-canvas 组件放入分包目录:

配置分包路由后,主包体积可减少约1MB

六、常见问题解决

  1. 图表不渲染

    • 检查组件路径是否正确(90%的问题源于路径错误)

    • 确保容器设置了明确宽高

  2. 滑动时图表抖动 添加 force-use-old-canvas="true" 属性

  3. TypeError: t.addEventListener is not a function 修改 ec-canvas/echarts.js 文件,找到以下代码:t.addEventListener(e, n, i)修改为t.addEventListener?.(e, n, i)

  4. 包体积超标 使用定制构建+分包策略,可缩减至300-500KB

  5. TypeError: this.Chart.init is not a function Taro3 不能通过ref直接获取原生微信小程序组件,实际获取的是 TaroElement, 通过 getCurrentInstance().page.selectComponent('#mychart-area') 方式获取微信原生小程序

ini 复制代码
 // 初始化图表
  const initChart = useCallback(
    (canvas, width, height, dpr) => {
      const chart = echarts.init(canvas, undefined, {
        width,
        height,
        devicePixelRatio: dpr,
      });
      updateChart(chart);
      chartRef.current = chart;
      return chart;
    },
    [updateChart]
  );

 // 初始化逻辑调整
 useEffect(() => {
    const pageCtx = getCurrentInstance().page;
    setTimeout(() => {
      // 初始化雷达图
      ecCanvasRef.current = pageCtx.selectComponent("#radar-canvas");
      ecCanvasRef.current?.init(initChart);

      // 初始化柱状图
      barEcCanvasRef.current = pageCtx.selectComponent("#bar-canvas");
      barEcCanvasRef.current?.init(initBarChart);
    }, 300);

    return () => {
      chartRef.current?.dispose();
      barChartRef.current?.dispose();
    };
  }, [initChart, initBarChart]);
  1. tooltip在小程序中文字有黑色阴影 设置tooltip.shadowBlur = 0 7. 小程序里echarts生成的canvas层级太高 在微信开发工具中可能展示不出来 但是在真机调试中就有这问题 解决办法 去除force-use-old-canvas

通过以上步骤,开发者可在Taro3.0+框架中高效实现动态数据可视化。

相关推荐
泯泷4 分钟前
Cloudflare 出手抢 Astro:前端框架之战,底层逻辑变了
前端·javascript·前端框架
狮子座的男孩2 小时前
html+css基础:31、响应式布局(媒体类型,媒体特性,运算符,常用阈值)
前端·css·经验分享·html·响应式布局·媒体类型/特性·常用阈值
鲸鹏芯海微电子科技 (上海) 有限公司2 小时前
手机直连卫星,射频前端到底要解决什么?
前端·智能手机·低轨卫星·謓泽·鲸鹏芯海·毫米波射频·相控阵芯片
Flynt2 小时前
npm run dev --host 有风险?我把 Vite 这个 9.1 分漏洞复现了一遍
前端·vite
AI开源软件2 小时前
Vue3+SpringBoot3 业务配置统一管理:接管、保存与回退怎样保留有效值
java·前端·vue.js·spring boot·vue·ruoyi office
1-1=03 小时前
Vue 脚手架
前端·javascript·vue.js
snow@li3 小时前
node:读取本地文件/静态文件服务器/打开Axure原型/prototype-server
前端·node
狮子座的男孩3 小时前
html+css基础:32、BFC(父子元素防止 margin 塌陷,父子元素清除浮动,兄弟元素两栏布局)
前端·css·经验分享·html·bfc·margin塌陷·清除浮动
zhanlang02173 小时前
HTML 零基础入门到企业实战全套教程【第八章 8.3】HTML5 语义化标签|SEO 优化、页面布局实战应用
前端·html·html5
SameX4 小时前
HarmonyOS 保存组件截图到相册 componentSnapshot 到 photoAccessHelper 完整链
前端