体验示例小程序
在微信中扫描下面的二维码即可体验 ECharts Demo:
下载
为了兼容小程序 Canvas,我们提供了一个小程序的组件,用这种方式可以方便地使用 ECharts。
首先,下载本项目。
其中,ec-canvas
是我们提供的组件,其他文件是如何使用该组件的示例。
ec-canvas
目录下有一个 echarts.js
,默认我们会在每次 echarts-for-weixin
项目发版的时候替换成最新版的 ECharts。如有必要,可以自行从 ECharts 项目中下载最新发布版,或者从官网自定义构建以减小文件大小。
引入组件
微信小程序的项目创建可以参见微信公众平台官方文档。
在创建项目之后,可以将下载的 ecomfe/echarts-for-weixin 项目完全替换新建的项目,然后将修改代码;或者仅拷贝 ec-canvas
目录到新建的项目下,然后做相应的调整。
如果采用完全替换的方式,需要将 project.config.json
中的 appid
替换成在公众平台申请的项目 id。pages
目录下的每个文件夹是一个页面,可以根据情况删除不需要的页面,并且在 app.json
中删除对应页面。
如果仅拷贝 ec-canvas
目录,则可以参考 pages/bar
目录下的几个文件的写法。下面,我们具体地说明。
创建图表
首先,在 pages/bar
目录下新建以下几个文件:index.js
、 index.json
、 index.wxml
、 index.wxss
。并且在 app.json
的 pages
中增加 'pages/bar/index'
。
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) { const chart = echarts.init(canvas, null, { width: width, height: height }); canvas.setChart(chart); var option = { ... }; chart.setOption(option); return chart; }Page({ data: { ec: { onInit: initChart } } });