手拉手，用Vue開發動態刷新Echarts組件

時間 2019-11-08

標籤手拉手 vue 開發動態刷新 echarts 組件简体版

原文原文鏈接

從幾年前流行的jQuery插件，到如今React和Vue的組件，在業務需求的開發中抽象通用出通用的模塊，一直都是一個對我的技術提升很是有幫助的事情。本文從一個真實業務組件的開發，來介紹封裝一個組件應該如何從哪些方面去思考，以及在使用框架開發的今天，核心基礎知識的重要性。

需求背景

dashboard做爲目前企業中後臺產品的「門面」，如何更加實時、高效、炫酷的對統計數據進行展現，是值得前端開發工程師和UI設計師共同思考的一個問題。今天就從0開始，封裝一個動態渲染數據的Echarts折線圖組件，拋磚引玉，一塊兒來思考更多有意思的組件。javascript

準備工做

項目結構搭建

由於生產須要（實際上是懶），因此本教程使用了 ==vue-cli==進行了項目的基礎結構搭建。前端

npm install -g vue-cli
vue init webpack vue-charts
cd vue-charts
npm run dev

安裝Echarts

直接使用npm進行安裝。vue

npm install echarts --save

引入Echarts

//在main.js加入下面兩行代碼
import echarts from 'echarts'
Vue.prototype.$echarts = echarts //將echarts註冊成Vue的全局屬性

到此，準備工做已經完成了。java

靜態組件開發

由於被《React編程思想》這篇文章毒害太深，因此筆者開發組件也習慣從基礎到高級逐步迭代。webpack

靜態組件要實現的目的很簡單，就是把Echarts圖表，渲染到頁面上。web

新建Chart.vue文件

<template>
  <div :id="id" :style="style"></div>
</template>
<script>
export default {
  name: "Chart",
  data() {
    return {
      //echarts實例
      chart: ""
    };
  },
  props: {
    //父組件須要傳遞的參數：id，width，height，option
    id: {
      type: String
    },
    width: {
      type: String,
      default: "100%"
    },
    height: {
      type: String,
      default: "300px"
    },
    option: {
      type: Object,
      //Object類型的prop值必定要用函數return出來，否則會報錯。原理和data是同樣的，
      //使用閉包保證一個vue實例擁有本身的一份props
      default() {
        return {
          title: {
            text: "vue-Echarts"
          },
          legend: {
            data: ["銷量"]
          },
          xAxis: {
            data: ["襯衫", "羊毛衫", "雪紡衫", "褲子", "高跟鞋", "襪子"]
          },
          yAxis: [
            {
              type: "value"
            }
          ],
          series: [
            {
              name: "銷量",
              type: "line",
              data: [5, 20, 36, 10, 10, 70]
            }
          ]
        };
      }
    }
  },
  computed: {
    style() {
      return {
        height: this.height,
        width: this.width
      };
    }
  },
  mounted() {
    this.init();
  },
  methods: {
    init() {
      this.chart = this.$echarts.init(document.getElementById(this.id));
      this.chart.setOption(this.option);
    }
  }
};
</script>

上述文件就實現了將一個簡單折線圖渲染到頁面的組件，怎麼樣是否是很簡單？最簡使用方法以下：ajax

App.vue

<template>
  <div id="app">
    <Chart id="test"/>
  </div>
</template>

<script>
import Chart from "./components/Chart";
export default {
  name: "App",
  data() {},
  components: {
    Chart
  }
}
</script>

至此，運行程序你應該能看到如下效果：
vue-cli

第一次迭代

如今咱們已經有了一個基礎版本，讓咱們來看看哪些方面作的還不盡如人意：npm

圖表沒法根據窗口大小進行自動縮放，雖然設置了寬度爲100%，可是隻有刷新頁面圖表纔會從新進行渲染，這會讓用戶體驗變得不好。
圖表目前沒法實現數據自動刷新

下面咱們來實現這兩點：編程

自動縮放

Echarts自己是不支持自動縮放的，可是Echarts爲咱們提供了resize方法。

//在init方法中加入下面這行代碼
window.addEventListener("resize", this.chart.resize);

只須要這一句，咱們就實現了圖表跟隨窗口大小自適應的需求。

支持數據自動刷新

由於Echarts是數據驅動的，這意味着只要咱們從新設置數據，那麼圖表就會隨之從新渲染，這是實現本需求的基礎。咱們再設想一下，若是想要支持數據的自動刷新，必然須要一個監聽器可以實時監聽到數據的變化而後告知Echarts從新設置數據。所幸Vue爲咱們提供了watcher功能，經過它咱們能夠很方便的實現上述功能：

//在Chart.vue中加入watch
  watch: {
    //觀察option的變化
    option: {
      handler(newVal, oldVal) {
        if (this.chart) {
          if (newVal) {
            this.chart.setOption(newVal);
          } else {
            this.chart.setOption(oldVal);
          }
        } else {
            this.init();
        }
      },
      deep: true //對象內部屬性的監聽，關鍵。
    }
  }

上面代碼就實現了咱們對option對象中屬性變化的監聽，一旦option中的數據有了變化，那麼圖表就會從新渲染。

實現動態刷新

下一步我想你們都知道了，就是定時從後臺拉取數據，而後更新父組件的option就好。這個地方有兩個問題須要思考一下：

若是圖表要求每秒增長一個數據，應該如何進行數據的請求才能達到性能與用戶體驗的平衡？
動態更新數據的代碼，應該放在父組件仍是子組件？

對第一個問題，每秒實時獲取服務器的數據，確定是最精確的，這就有兩種方案：

每秒向後臺請求一次
保持長鏈接，後臺每秒向前端推送一次數據

第一種方案無疑對性能和資源產生了極大的浪費；除非實時性要求特別高（股票系統），不然不推薦這種方式；

第二種方案須要使用web Socket，但在服務端須要進行額外的開發工做。

筆者基於項目的實際需求（實時性要求不高，且後臺生成數據也有必定的延遲性），採用瞭如下方案：

前端每隔一分鐘向後臺請求一次數據，且爲當前時間的上一分鐘的數據；
前端將上述數據每隔一秒向圖表set一次數據

關於第二個問題：筆者更傾向於將Chart組件設計成純組件，即只接收父組件傳遞的數據進行變化，不在內部進行復雜操做；這也符合目前前端MVVM框架的最佳實踐；並且若將數據傳遞到Chart組件內部再進行處理，一是遇到不須要動態渲染的需求還須要對組件進行額外處理，二是要在Chart內部作ajax操做，這樣就致使Chart徹底沒有了可複用性。

接下來咱們修改App.vue

<template>
  <div id="app">
    <Chart id="test" :option="option"/>
  </div>
</template>

<template>
  <div id="app">
    <Chart id="test" :option="option"/>
  </div>
</template>

<script>
import Chart from "./components/Chart";
export default {
  name: "App",
  data() {
    return {
      //筆者使用了mock數據表明從服務器獲取的數據
      chartData: {
        xData: ["襯衫", "羊毛衫", "雪紡衫", "褲子", "高跟鞋", "襪子"],
        sData: [5, 20, 36, 10, 10, 70]
      },
      option: {
        title: {
          text: "vue-Echarts"
        },
        legend: {
          data: ["銷量"]
        },
        xAxis: {
          data: ["襯衫", "羊毛衫", "雪紡衫", "褲子", "高跟鞋", "襪子"]
        },
        yAxis: [
          {
            type: "value"
          }
        ],
        series: [
          {
            name: "銷量",
            type: "line",
            data: [5, 20, 36, 10, 10, 70]
          }
        ]
      }
    };
  },
  components: {
    Chart
  },
  mounted() {
    this.refreshData();
  },
  methods: {
    //添加refreshData方法進行自動設置數據
    refreshData() {
      //橫軸數據
      let xData = this.chartData.xData,
        //系列值
        sData = this.chartData.sData;
      for (let i = 0; i < xData.length; i++) {
        //此處使用let是關鍵，也可使用閉包。原理再也不贅述
        setTimeout(() => {
          this.option.xAxis.data.push(xData[i]);
          this.option.series[0].data.push(sData[i]);
        }, 1000 * i); //此處要理解爲何是1000*i
      }
    }
  }
};
</script>

至此咱們就實現了圖表動態數據加載，效果以下圖：