在微信小程序中使用 ECharts

    因此,我们和微信小程序官方团队合作,提供了 ECharts 的微信小程序版本。开发者可以通过熟悉的 ECharts 配置方式,快速开发图表,满足各种可视化需求。

    在微信中扫描下面的二维码即可体验 ECharts Demo:

    为了兼容小程序 Canvas,我们提供了一个小程序的组件,用这种方式可以方便地使用 ECharts。

    首先,下载 GitHub 上的 项目。

    其中, 是我们提供的组件,其他文件是如何使用该组件的示例。

    微信小程序的项目创建可以参见微信公众平台官方文档

    在创建项目之后,可以将下载的 项目完全替换新建的项目,然后将修改代码;或者仅拷贝 ec-canvas 目录到新建的项目下,然后做相应的调整。

    如果采用完全替换的方式,需要将 project.config.json 中的 appid 替换成在公众平台申请的项目 id。pages 目录下的每个文件夹是一个页面,可以根据情况删除不需要的页面,并且在 app.json 中删除对应页面。

    如果仅拷贝 目录,则可以参考 pages/bar 目录下的几个文件的写法。下面,我们具体地说明。

    首先,在 pages/bar 目录下新建以下几个文件:index.jsindex.jsonindex.wxmlindex.wxss。并且在 app.jsonpages 中增加 。

    index.json 配置如下:

    index.wxml 中,我们创建了一个 <ec-canvas> 组件,内容如下:

    其中 ec 是一个我们在 index.js 中定义的对象,它使得图表能够在页面加载后被初始化并设置。index.js 的结构如下:

    这对于所有 ECharts 图表都是通用的,用户只需要修改上面 的内容,即可改变图表。option 的使用方法参见 ECharts 配置项文档。对于不熟悉 ECharts 的用户,可以参见 教程。

    完整的例子请参见 ecomfe/echarts-for-weixin 项目。

    ECharts 中的绝大部分功能都支持小程序版本,因此这里仅说明不支持的功能,以及存在的问题。

    以下功能尚不支持,如果有相关需求请在 中向我们反馈,对于反馈人数多的需求将优先支持:

    • Tooltip
    • 图片
    • 安卓平台:transform 的问题(会影响关系图边两端的标记位置、旭日图文字位置等)
    • iOS 平台:半透明略有变深的问题
    • iOS 平台:渐变色出现在定义区域之外的地方

    如有其它问题,也欢迎在 issue 中向我们反馈,谢谢!