基於echarts 靈活封裝react餅圖組件

時間 2019-11-08

原文原文鏈接

基於echarts 靈活封裝react餅圖組件

這段時間比較忙，沒什麼時間封裝組件庫，同事都不怎麼會使用echarts，今天隨手封裝了一個echart的餅圖，百十來行的代碼同事用了都說好！
廢話很少說封裝組件以前，首先要考慮咱們的組件，都要包含哪些功能；react

窗口隨動，echart的窗口resize，是須要咱們本身寫的，這個確定封裝(注意要作防抖處理)；
每次設置畫布的元素的時候都須要傳入寬高，這也須要，省事嘛；
鬼知道會不會有事件，因此事件也是確定要的；
沒有數據的時候畫布不能空着，加一個暫無數據的展現；
我在代碼中添加一個名爲options的對象這裏能夠補充我沒有封裝的功能，好比須要圖例能夠本身定義，傳進去也是同樣的；
有增長天然就有刪除，刪除的屬性爲deleteOption，和5同樣都須要判斷是否屬性是否存在，存在則執行，不存在則忽略；

先看看完總體，有興趣您就繼續，沒興趣那就再見來不及握手：
echarts

看着仍是能夠的吧!別問我爲何沒有圖例，公司多數都是縮略圖，圖例基本用不上，爲了一個不用的多封裝一個功能沒什麼意思！
再看下聲明的propTypes和 defaultProp 儘量少的使用isRequired （我的意見，省得後續使用者，漏傳就會報錯）

是否是有點多？還好吧，畢竟這麼靈活！函數

做用看下注釋就ok了！別說你看不懂啊！s，記住這兩個必定有，由於你不知道後面的使用者或不會傳錯，註釋最好也留下，省得被挖墳！優化

再往下看，在componentDidMount週期中接受props的屬性，組裝本身的option:ui

注意：init的時候記住必定要接受key，保證頁面的id惟一的，若是兩個畫板的id重複了，會致使其餘處理第一個畫板之後其餘的畫板都是白色的，echarts不會覆蓋，因此加入你的畫板沒有東西，那就看下是否是畫板元素存在子元素，或者已經畫了圖形，其次在init以後咱們要clear清理畫板而且取消全部綁定函數（.off），否則下次刷新圖形的時候，事件會在掛載
最後在掛一下代碼吧，畢竟本身剛開始寫博客，技術屬實是不怎麼樣，雖然看的很少，萬一要是有人看呢哈哈！！this

import React, {PureComponent} from 'react';
import echarts from 'echarts/lib/echarts';
import 'echarts/lib/chart/pie';
import 'echarts/lib/component/title';
import 'echarts/lib/component/tooltip';
import 'echarts/lib/component/toolbox';
import 'echarts/lib/component/graphic';
import PropTypes from 'prop-types';

/*
* 餅圖組件可支持環形切換，
* 包含無數據展現，onresize重繪事件
* 能夠自定義option, 支持多種鼠標事件
* 暫時未封裝圖例，圖例等其餘功能可經過 options本身定義添加
* deleteOption: ['title', 'toolbox', 'tooltip', 'graphic'] 包含echarts含有的屬性
*
* */

/*
 * chartsData 數據格式
 * const chartsData = [
 *  {value: 335, name: '直接訪問'},
 *  {value: 310, name: '郵件營銷'},
 *  {value: 234, name: '聯盟廣告'},
 * ]
 * */

const _eventType = ['click', 'dblclick', 'mousedown', 'mousemove', 'mouseup', 'mouseover', 'mouseout', 'globalout', 'contextmenu'];

class PieChart extends PureComponent {
  constructor(props) {
    super(props);
    this.state = {}
  }

  static propTypes = {
    chartsData: PropTypes.array.isRequired, // 圖形數據
    idPrefix: PropTypes.oneOfType([
      PropTypes.string.isRequired, // 惟一標識區分多個餅圖，
      PropTypes.number.isRequired, // 惟一標識區分多個餅圖，
    ]),
    getCharts: PropTypes.func, // 把echarts 對象傳出去
    onResize: PropTypes.func, // 全局onResize事件，
    eChartsEvent: PropTypes.func, // 圖形點擊事件, 返回這各圖形的數據以及對應的param，echarts 對象

    title: PropTypes.string, // 標題欄，名字
    bgColor: PropTypes.string, // 背景色
    chartColor: PropTypes.array, // 扇形區域顏色
    radius: PropTypes.array, // 半徑內圈半徑不能夠調小否則暫無數據的時候字放不下
    center: PropTypes.array, // 位置調節
    label: PropTypes.bool, // 是否展現label
    maxShow: PropTypes.number, // 需 >= 0 最多展現幾個扇形，不傳則默認不處理，建議不要大於5
    options: PropTypes.object, // 修改 更新的想要的配置，直接那eCharts的就能夠
    deleteOption: PropTypes.array, // 刪除不須要的配置
    eventType: PropTypes.oneOf(_eventType), // 事件類型
  };

  static defaultProps = {
    title: '',
    bgColor: "#fff",
    chartColor: ['#1890ff', '#13c2c2', '#52c41a', '#faad14', '#f5222d', '#722ed1', '#eb2f96', '#faad14'],
    radius: ['0', '65%'],
    center: ['50%', '55%'],
    label: false,
    eventType: 'click',
  };

  componentDidMount() {
    const {
      chartsData, idPrefix, getCharts, onResize, title, bgColor,
      chartColor, radius, center, label, maxShow, deleteOption, options,
      eChartsEvent, eventType
    } = this.props;

    let newChartsData = [];
    if (maxShow && maxShow >= 0 && chartsData.length > maxShow) {
      chartsData.sort((a, b) => {
        return b.value - a.value;
      });

      newChartsData = chartsData.slice(0, maxShow);
      let total = 0;
      chartsData.map((item, index) => {
        if (index > 4) {
          total += item.value
        }
      });
      newChartsData = [...newChartsData, {value: total, name: '其餘'}];
    }
    else {
      newChartsData = [...chartsData]
    }

    let myCharts = echarts.init(document.getElementById(`${idPrefix}_pie`));

    if (getCharts && typeof func === 'function') {
      getCharts(myCharts);
    }
    myCharts.clear();

    _eventType.map(item => {
      myCharts.off(item);
    });

    let option = {
      color: newChartsData.length ? chartColor : '#bfbfbf',
      title: {
        text: title,
        top: 20,
        x: 'center'
      },
      toolbox: {
        feature: {
          saveAsImage: {
            type: 'png',
            title: '點擊下載',
          }
        },
        top: 13,
        right: 13
      },
      tooltip: {
        trigger: 'item',
        formatter: "{a} <br/>{b} : {c} ({d}%)"
      },
      series: [
        {
          name: title,
          type: 'pie',
          radius,
          center,
          avoidLabelOverlap: false,
          label: {
            show: label,
          },
          labelLine: {
            normal: {
              show: label
            }
          },
          itemStyle: {
            borderWidth: 2, //設置border的寬度有多大
            borderColor: bgColor,
          },
          hoverAnimation: false,
          hoverOffset: 0,
          data: newChartsData.length ? newChartsData : [{value: 0, name: '暫無數據'}],
        },
      ],
      graphic: newChartsData.length
        ? null
        : [{
          type: 'text',
          left: 'center',
          top: radius[0] === '0' ? 'auto' : center[1],
          bottom: 10,
          cursor: 'auto',
          style: {
            text: '暫無數據',
            textAlign: 'center',
            fill: '#bfbfbf',
            fontSize: 16,
            stroke: '#bfbfbf',
            lineWidth: 0
          }
        }]
    };

    if (deleteOption) {
      deleteOption.map(item => {
        delete option[item]
      });
    } // 刪除函數

    if (options) {
      option = {...option, ...options}
    } // 補充的options

    myCharts.setOption(option);

    if (eChartsEvent && typeof eChartsEvent === 'function') {
      myCharts.on(eventType, 'series', params => {
        eChartsEvent(params, chartsData, myCharts);
      });
    }

    window.onresize = () => {
      let target = this;
      if (target.resizeFlag) {
        clearTimeout(target.resizeFlag);
      }
      target.resizeFlag = setTimeout(function () {
        myCharts.resize();
        if (onResize && typeof onResize === 'function') {
          onResize();
        }
        target.resizeFlag = null;
      }, 100);
    }
  }

  render() {
    const {idPrefix} = this.props;
    return (
      <div
        id={`${idPrefix}_pie`}
        style={{width: '100%', height: '100%'}}/>
    )
  }
}

export default PieChart;

有興趣的朋友能夠關注下option中的graphic屬性，和D3比較相似，有時間分享一下用這屬性作的圖形！！！後期本身又優化了一下，代碼部分可能有所變更spa