在原生微信小程序中使用echarts

本文介绍: 现在越来越多的项目都在使用可视化的功能，那么使用 echarts 实现是一种不错的选择，本文将带给大家如何在原生微信小程序中使用 echarts，保姆级教程

在原生 微信 小程序中使用 echarts

现在越来越多的项目都在使用可视化的功能，那么使用 echarts 实现是一种不错的选择，本文将带给大家如何在原生微信小程序中使用 echarts，保姆级教程

一、下载 微信 小程序 版本 echarts 文件

文件地址：https://github.com/e com fe/echarts-for–weixin/tree/master

在这里插入图片描述

二、引入 echarts

创建一个微信小程序项目或打开已有的微信小程序项目，下述示例采用全新创建的方式，在电脑文件中创建一个空的文件夹，命名自定义即可
将下载好的 echarts 文件放入创建好的空文件中
使用微信开发者工具打开创建的文件夹
查看创建结果

三、使用前处理 事项（萌新看——老手略过）

需要找到 app.wxss 文件中，将默认给 container 的代码注释或清空，或者后续容器不使用 container 类名
如果是新建项目可以删除默认生成的页面文件
并修改 app.json 文件中的 page s 配置选项

四、在项目中使用 echarts 文件

在页面的 json文件中引入 echarts.js 文件

{
	"usingComponents":{
		// 引入目录以自己当前项目的路径为准，省略后缀.js
		"ec-canvas":"../../ec-canvas/ec-canvas" 
	}
}

在页面的 wxml 文件中创建 dom 结构及使用

&lt;!-- 创建容器-此区域用于展示图表 --&gt;
<view class="container"&gt;
  <!-- 使用 ec-canvas 组件，此处的命名为引入组件路径前面的定义 key 键的名字 --&gt;
  <!-- 需要设置 id canvas-id ec 三个属性 --&gt;
  <!-- id canvas-id ec名称可以自己定义，符合命名规范即可 --&gt;
  <ec-canvas id="myChart" canvas-id="myChart" ec="{{ec}}"></ec-canvas>
</view>

在页面的 wx ss 文件中为容器定义大小与样式

/* 定义容器大小 */
.container{
  width: 100%;
  height: 500rpx;
  background-color: bisque;
}

/* ec-canvas 组件宽高与父元素一致即可 */
ec-canvas{
  width: 100%;
  height: 500rpx;
}

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

// 引入 echarts 文件
import * as echarts from '../../ec-canvas/echarts';

// 定义 initChart 方法
// initChart 需要传递四个参数 canvas, width, height, dpr
function initChart(canvas, width, height, dpr) {
  // 使用引入的 echarts的init方法对 chart 变量赋值进行初始化
  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名称与wxml结构中命名保持一致
    ec: {
      // 使用 onInit 方法定义
      onInit: initChart
    }
  }
});

此时我们的 option 配置项还是为空，接下来我们可以配置一下，进入 echarts 官网，进入示例，https://echar ts.apache.org/examples/zh/index.html
选择自己需要的图表，点击进入，本示例使用柱形图作为示范
复制配置项

将复制的配置项放入我们代码的 option 配置项中

// 引入 echarts 文件
import * as echarts from '../../ec-canvas/echarts';

// 定义 initChart 方法
// initChart 需要传递四个参数 canvas, width, height, dpr
function initChart(canvas, width, height, dpr) {
  // 使用引入的 echarts的init方法对 chart 变量赋值进行初始化
  const chart = echarts.init(canvas, null, {
    width: width,
    height: height,
    devicePixelRatio: dpr // 像素
  });

  canvas.setChart(chart);

  var option =  {
    xAxis: {
      type: 'category',
      data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun']
    },
    yAxis: {
      type: 'value'
    },
    series: [
      {
        data: [150, 230, 224, 218, 135, 147, 260],
        type: 'line'
      }
    ]
  }

  chart.setOption(option);

  return chart;
}

Page({
  data: {
    // 此处的ec名称与wxml结构中命名保持一致
    ec: {
      // 使用 onInit 方法定义
      onInit: initChart
    }
  }
});