在小程序中使用echart-广州芦苇科技

小程序中使用echart

最近有几个小程序用到了图表，把我一顿折腾。所以来讲一下使用图表时所遇到的问题。

我们所用到的是ECharts 的微信小程序版本;它提供了一个小程序原生的组件，然后我们只需要在相关页面引用改组件就好了。

使用前准备

先下载ecomfe/echarts-for-weixin 中 ec-canvas 整个文件夹里面的文件
引用：然后在你的页面中的 json文件中引用。当然你也可以作为全局组件写在app.json 中。
```
{ 
  "usingComponents": {
    "ec-canvas": "../../components/ec-canvas/ec-canvas"
  }
}
```

注意： 上面的 ec-canvas 引用组件名不能随意改变，因为在封装的组件 ec-canvas.js 中，需要找到<ec-canvas /> 该节点。

使用

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

我们要手动给我们的图表设置宽高，不然页面只会显示空白。也就是给.container 设置宽高。
其中 ec 是一个我们在我们页面中定义的对象，它使得图表能够在页面加载后被初始化并设置。初始化图表的方法如下：
```
function initChart(canvas, width, height, dpr) {
  const chart = echarts.init(canvas, null, {
    width: width,
    height: height,
    devicePixelRatio: dpr // 像素
  });
  canvas.setChart(chart);
// 图表数据初始化
  var option = {
    ...
  };
  chart.setOption(option);
  return chart;
}
```
这对于所有 ECharts 图表都是通用的，用户只需要修改上面 option 的内容，即可改变图表。option 的使用方法参见 ECharts 配置项文档。对于不熟悉 ECharts 的用户，可以参见 [5 分钟上手 ECharts](http://echarts.baidu.com/tutorial.html#5 分钟上手 ECharts) 教程。

因为我们一般都是需要延迟加载的，也就是获取数据后才加载图表的,所以我们不能直接使用,

我们需要在获取数据重新设置 options 之后才能使用。

代码入下:

*.wxml 文件 *

<view class="echart-map">
    <view class="echart-title">全国疫情新趋势</view>
    <ec-canvas wx:if="{{hasGetOption}}" class="map-chart" id="map-chart" canvas-id="map-chart" ec="{{ ec }}"></ec-canvas>
  </view>

.js 文件

// 页面中需要引入 ec-canvas 文件夹中的 echcrts.js
import * as echarts from '../../components/ec-canvas/echarts';  
page({
  data: {
    hasGetOption: false,
    ec: {
      // 当我们设置lazyLoad 为true 的时候，我们需要手动初始化图表。
      lazyLoad: true,
    }
  },
  ready() {
    // 在ready 的时候获取组件的实例。否则可能获取不到。
    this.echartInstance = this.selectComponent('.map-chart');
  },

  setOption () {
    let option = {
      title: {
        // text: '全国疫情新增趋势'
      },
      tooltip: {
        trigger: 'axis'
      },
      legend: {
        data: [ '确诊']
      },
      grid: {
        left: '3%',
        right: '4%',
        bottom: '3%',
        containLabel: true
      },
      xAxis: {
        type: 'category',
        boundaryGap: false,
        data: []
      },
      yAxis: {
        type: 'value'
      },
      series: [{
          name: '确诊',
          type: 'line',
          stack: '总量',
          data: [120, 132, 101, 134, 90, 230, 210],
          smooth: true
        }
      ]
    }
  },

  initChart(canvas, width, height, dpr) {
    const chart = echarts.init(canvas, null, {
      width: width,
      height: height,
      devicePixelRatio: dpr // new
    });
    canvas.setChart(chart);

    let option = this.getOption();

    chart.setOption(option);
    return chart;
  },

  getPageData() {
    wx.request({
      ...
      success: (res) => {
        // 获取到数据后再手动初始化
        this.echartInstance.init(this.initChart);
        this.setData({
          hasGetOption: true,
          ...
        })
      }
    })
  }
})

在之前的版本中会出现这么一个问题： error 因为最新基础库版本中支持 Canvas 2d，这个可以提升渲染性能，解决非同层渲染问题。

解决这个问题只需要在 ec-cnavas.js 的data 中将 isUseNewCanvas 设为true即可。

在 Taro 中使用

因为 Taro 中可以使用微信中的原生组件，以及微信中的自定义组件。所以使用方法同微信小程序类似。

下载

页面引用

  config = {
    navigationBarTitleText: '首页',
    usingComponents: {
      "ec-canvas": "../../components/ec-canvas/ec-canvas"
    }
  }

使用：

state = {
  ec: {
    lazyLoad: true,
  }
};

// 获取组件实例。
setCanvasRef = node => this.canvasRef = node;
render () {
return (
   <View className="line-chart">
      <ec-canvas id="price-chart" canvas-id="price-chart" ref={this.setCanvasRef} ec={ec} />
    </View>
)
}

然后在数据请求完后再图表初始化。 init 是再组件中定义的

this.canvasRef.init (this.initChart);

扩展阅读：

Echarts 配置文档 5分钟快速上手 Echarts

【作者简介：】 Mars 芦苇科技web前端开发工程师喜欢看电影，撸铁还有学习。擅长微信小程序开发，系统管理后台。访问 www.talkmoney.cn 了解更多。作者主页： github

blog