小程序引入e-charts图表

小程序引入e-charts图表

前言:运营助手,见名知意,没有图表数据的展示,看上去是有多空白。因此,俺们UI做了很好的交互,一个页面来了4个e-charts图表,且基本都不一样。身为一个职业前端,怎么能猥琐呢?

干就完了~

实现思路

因为一个页面要引入多个图表,所以需要对e-charts图表进行封装。然鹅问题来了,怎么引入呢?

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

其中,ec-canvas 是ECharts提供的组件,其他文件是如何使用该组件的示例。

ec-canvas 目录下有一个 echarts.js,默认ECharts会在每次 echarts-for-weixin 项目发版的时候替换成最新版的 ECharts。如有必要,可以自行从 ECharts 项目中下载最新发布版,或者从官网自定义构建以减小文件大小

这里引入,我们只需要引入ec-canvas目录到小程序项目即可。

单页面引入

一个页面只需要引入一个图表的,我们在相关的js文件书写即可。这样引入比较简单,也可以减少不必要的很多问题。但只限于一个页面引入一个图表 ,如果有一种情况,正如狗尾草所要完成的,一个页面4个图表,各不相同。则就需要封装组件了

话不多说,直接撸~

index.json配置

{
  "usingComponents": {
    "ec-canvas": "../../ec-canvas/ec-canvas"
  }
}

index.wxml

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

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
    }
  }
});

以上为单页面引入图表,需要注意的是,

  1. 引入文件的路径,改成自己项目中的实际路径。

  2. option配置可查看e-charts官方文档按需配置。

  3. 小程序的层级因为是原生组件,所以小程序的层级无法修改。

  4. 由于原生组件脱离在 WebView 渲染流程外,因此在使用时有以下限制:
    组件的层级是最高的,所以页面中的其他组件无论设置 z-index 为多少,都无法盖在原生组件上。
    后插入的原生组件可以覆盖之前的原生组件。
    原生组件还无法在 scroll-view、swiper、picker-view、movable-view 中使用。
    部分CSS样式无法应用于原生组件,例如:
    无法对原生组件设置 CSS 动画
    无法定义原生组件为 position: fixed
    不能在父级节点使用 overflow:hidden 来裁剪原生组件的显示区域,

因此在使用时,可能遇到这个问题,图表的层级很高,而且不会跟随屏幕滚动。大概就是以上原因造成的。

这里狗尾草的解决是通过修改布局。因为这里本人造成图表不随屏幕滚动的原因是采用了,圣杯布局。因此在将圣杯布局去掉后。采用本来的默认布局,就修改了这个问题。

虽然问题得到了解决,但需求比较急,还没有查找到完美的解决方案,小伙伴有的话,可以告知一下,在这里先说一声谢谢啦~

引入多个图表

狗尾草的完成,页面引入多个图表,如果还如上面所示,在单页面中引入多个方法,配置会更加复杂。

这里,需要引入竖向柱状图,横向柱状图,饼状图。

因此将每个类型的图标单独放到一个组件中,在需要引入的页面只引入这些个组件就够。

在父组件得到数据后,将数据传入子组件。子组件更新view即可。但是会遇到这么一个问题

子组件在得到传递的值后,并不会更新view。因此狗尾草是通过修改引入的ec-canvas组件来完成视图的更新。

听着可能有点懵逼,理一下。

  1. 父组件给子组件传递数据
  2. 子组件做视图的option配置
  3. 源码组件接受数据

大概就是这么个意思

先来看一下目录结构

image-20190226101929750

这里只给大家引用一下饼状图

###父组件

Wxml

<view class='echarts-department'>
    <echarts-depart oData="{{echarts.departNumber}}"></echarts-depart>
</view>

Wxss

.echarts-department {
  width: 100%;
  height: 498rpx;
}

Json

{
  "usingComponents": {
    "echarts-depart": "/components/eChartsSubDepartment/index"
  }
}

Js

// 数据日报
const $api = require('../../api/index.js');
const $util = require('../../utils/utils.js');
const regeneratorRuntime = require('../../utils/runtime.js');
Page({
  onShareAppMessage: function (res) {
    return {
      title: '数据日报',
      path: '/pages/eCharts/index',
      success: function () { },
      fail: function () { }
    }
  },
  data: {
    subParams: {
      distCode: "",
      beginTime: $util.formatDate(new Date()),
      endTime: $util.formatDate(new Date())
    }, //获取除过审医生数外的其他的所有api params
    echarts: {
      departNumber: [],
    }               //图标传入的数据
  },
  // 获取二级科室诊疗统计
  getDepartNumber() {
    $api.DATADAILY.getDepartNumber(this.data.subParams)
    .then(res => {
      if(res.length == 0) {
        this.setData({
          "echarts.departNumber": [{name:'',value:''}]
        })
        return ;
      }
      let arr = [];
      res.map(item => {
        let obj = {};
        obj.value = item.count;
        obj.name = item.date;
        arr.push(obj);
      })
      this.setData({
        "echarts.departNumber":arr
      })
    })
  },
  onReady() {
    this.getDepartNumber();      //获取二级科室诊疗总排行
  },
});

这里就是父组件的引入

封装的子组件

wxml

<!-- 数据日报 二级科室诊疗排行 -->
<view class='box'>
  <ec-canvas id="mychart-dom-bar" oData = "{{oData}}" canvas-id="mychart-bar" ec="{{ ec }}"></ec-canvas>
</view>

需要注意的是oData就是传递过来的数据

wx.json

{
  "component": true,
  "usingComponents": {
    "ec-canvas": "/ec-canvas/ec-canvas"
  }
}

js

// 数据日报 二级科室诊疗统计
// 1、引入依赖脚本
import * as echarts from '../../ec-canvas/echarts';

let chart = null;
// 2、进行初始化数据
function initChart(canvas, width, height,data) {
  chart = echarts.init(canvas, null, {
    width: width,
    height: height
  });
  canvas.setChart(chart);

  var option = {
    tooltip: {
      position: function (px) {
        return [px[0], '20%'];
      }
    },
    color: ['#48C6EB', '#60E3CA', '#5E9ED5', '#9F9FF5', '#72C7FD'],
    grid: {
      x: 0,
      y: 0,
      x2: 0,
      y2: 0
    }, //图标距离上下左右的距离
    series: [{
      // name: 'pie',
      type: 'pie',
      // selectedMode: 'single', //点击的时候是否区域进行分离
      // selectedOffset: 30, //区域分离的距离
      clockwise: true,
      label: {
        normal: {
          show: false,
          textStyle: {
            fontSize: '14px',
            color: '#333333'
          },
          // backgroundColor: '#061F3D',
        }
      },
      // labelLine: {
      //   normal: {
      //     lineStyle: {
      //       color: '#999999'
      //     }
      //   }
      // }, //label线条的颜色
      data: data,
      itemStyle: {
        normal: {
          borderWidth: 2,
          borderColor: '#ffffff',
          opacity: .7
        }
      }
    }]
  };

  chart.setOption(option);
  return chart;
}


Component({
  /**
   * Component properties
   */
  properties: {
    oData: {
      type: Array,
      value: [],
      observer: function (newVal, oldVal, changedPath) {
        // 属性被改变时执行的函数(可选),也可以写成在methods段中定义的方法名字符串, 如:'_propertyChange'
        // 通常 newVal 就是新设置的数据, oldVal 是旧数据
      }
    }
  },

  /**
   * Component initial data
   */
  data: {
    ec: {
      onInit: initChart // 3、将数据放入到里面
    }
  },

  /**
   * Component methods
   */
  methods: {
  },
})

需要修改的源码组件

ec-canvas > ec-canvas.js

properties: {
  canvasId: {
    type: String,
    value: 'ec-canvas'
  },

  ec: {
    type: Object
  },
  oData: {
    type: Object,
    observer: function(newVal,oldVal) {
      if(newVal.length == 0) {
        return ;
      }
      this.init();
    }
  } //oData为父传子,子传这里
},

在这里将传的数据作为参数

image-20190226105646698

啊,噗~

至此,一条数据流就算完成。其他类型的图标也按照这种方式引入即可

###补充,让小程序支持ES7

因为引入多个图表的话,更多的需要控制顺序,因此,这里给大家补充一下ES7的引入

npm install regenerator

引用:

const regeneratorRuntime = require('../../libs/regenerator-runtime')

这里就可以放心使用async和await来控制api请求的顺序了。

当然大家可以引入相关的js文件也是可以的。