mpx-echarts v1.0.0

MPX-Echarts

在MPX项目中更方便地使用echarts，提供跨平台抹平，目前同时支持微信和支付宝两个小程序平台。

Getting Started

Install

npm install mpx-echarts -S

Usage

在app.mpx中作为mpx插件进行注册

<script>
  import mpx from '@mpxjs/core'
  import apiProxy from '@mpxjs/api-proxy'
  import mpxEcharts from 'mpx-echarts'

  mpx.use(apiProxy, { usePromise: true }).use(mpxEcharts)
  // app.js
  App({})
</script>

在 页面/组件 中使用

<template>
  <view class="bar-container">
    <ec-canvas id="mychart-dom-bar" canvasId="mychart-bar" ec="{{ ec }}"></ec-canvas>
  </view>
</template>

<script>
  import mpx, { createComponent } from '@mpxjs/core'

  let chart = null

  createComponent({
    data: {
      ec: {
        onInit (canvas, width, height) {
          chart = mpx.echarts.init(canvas, null, {
            width: width,
            height: height
          })
          canvas.setChart(chart)

          var option = {
            xAxis: {
              type: 'category',
              data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun']
            },
            yAxis: {
              type: 'value'
            },
            series: [{
              data: [820, 932, 901, 934, 1290, 1330, 1320],
              type: 'line',
              smooth: true
            }]
          }

          chart.setOption(option)
          return chart
        }
      }
    }
  })
</script>

<style lang="stylus" scoped>
  .bar-container
    width 100%
    height 300px
    background #fff
</style>

<script type="application/json">
  {
    "component": true,
    "usingComponents": {
      "ec-canvas": "mpx-echarts/src/ecCanvas"
    }
  }
</script>

以上用法是初始有数据的场景，如果期望先发ajax请求拿到数据再渲染，可以参考示例项目中饼图的代码

注意： 本组件默认提供了echarts文件，此文件为比较完整的图表集合，下面的示例也针对使用默认提供的图表。如果希望仅引入部分组件，请参考高阶使用部分。

示例项目

本项目提供了一个示例可供运行参考。

# 安装依赖
npm i

# 开发前预备项
npm run predev

# 构建
npm run watch:cross

使用小程序开发者工具打开dist/对应平台即可

高阶使用

目前仅微信支持这样操作，因为echarts依赖的zrender里进行环境判断的代码里仅有微信小程序平台判断。

如果希望仅引入部分组件，可以参考echarts官方文档自定义echarts文件定制echarts文件。引入方式如下（也可以参考本文demo）：

在app.mpx文件中引入install文件并在注册时以参数的形式传入echarts：

<script>
import mpx from '@mpxjs/core'
import apiProxy from '@mpxjs/api-proxy'
import echarts from './lib/echarts'
import mpxEcharts from 'mpx-echarts/src/install'
mpx.use(apiProxy, { usePromise: true }).use(mpxEcharts, { echarts })
// app.js
App({})
</script>

定制的echarts文件，可以是打包好的echarts文件，也可以用以下方式引入(参考本文demo)：

// 引入 echarts 主模块。
export * from 'echarts/lib/echarts';
// 引入饼图。
import 'echarts/lib/chart/pie';
// 柱状图
import 'echarts/lib/chart/bar';

// 引入提示框组件、标题组件、工具箱组件。
import 'echarts/lib/component/tooltip';
import 'echarts/lib/component/title';
import 'echarts/lib/component/toolbox';
import 'echarts/lib/component/legend';

其在组件中的使用和上面的示例相同。

FAQ

1、使用时报以下错误信息是为什么？

thirdScriptError
t.addEventListener is not a function;at SelectorQuery callback function
TypeError: t.addEventListener is not a function

答： 这是你使用的mpx版本问题，使用一下命令更新到最新版本就好啦

npm i @mpxjs/core@latest @mpxjs/webpack-plugin@latest