用Vue開發動態刷新Echarts組件(以及修改時遇到的問題)


參考文章:https://segmentfault.com/a/1190000013903264

通過這篇文章我學習了vue集成echarts,嘗試了一下demo沒問題,但是在修改我預期效果時,卻出了一點問題,最后解決思路見最后

 

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

需求背景

dashboard作為目前企業中后台產品的“門面”,如何更加實時、高效、炫酷的對統計數據進行展示,是值得前端開發工程師和UI設計師共同思考的一個問題。今天就從0開始,封裝一個動態渲染數據的Echarts折線圖組件,拋磚引玉,一起來思考更多有意思的組件。

准備工作

項目結構搭建

因為生產需要(其實是懶),所以本教程使用了 ==vue-cli==進行了項目的基礎結構搭建。

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

 

安裝Echarts

直接使用npm進行安裝。

npm install echarts --save

 

引入Echarts

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

 

到此,准備工作已經完成了。

靜態組件開發

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

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

新建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>

 

上述文件就實現了將一個簡單折線圖渲染到頁面的組件,怎么樣是不是很簡單?最簡使用方法如下:

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>

 

至此,運行程序你應該能看到以下效果:
圖片描述

第一次迭代

現在我們已經有了一個基礎版本,讓我們來看看哪些方面做的還不盡如人意:

  1. 圖表無法根據窗口大小進行自動縮放,雖然設置了寬度為100%,但是只有刷新頁面圖表才會重新進行渲染,這會讓用戶體驗變得很差。
  2. 圖表目前無法實現數據自動刷新

下面我們來實現這兩點:

自動縮放

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就好。這個地方有兩個問題需要思考一下:

  1. 如果圖表要求每秒增加一個數據,應該如何進行數據的請求才能達到性能與用戶體驗的平衡?
  2. 動態更新數據的代碼,應該放在父組件還是子組件?

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

  • 每秒向后台請求一次
  • 保持長連接,后台每秒向前端推送一次數據

第一種方案無疑對性能和資源產生了極大的浪費;除非實時性要求特別高(股票系統),否則不推薦這種方式;

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

筆者基於項目的實際需求(實時性要求不高,且后台生成數據也有一定的延遲性),采用了以下方案:

  1. 前端每隔一分鍾向后台請求一次數據,且為當前時間的上一分鍾的數據;
  2. 前端將上述數據每隔一秒向圖表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>

 

至此我們就實現了圖表動態數據加載,效果如下圖:

圖片描述

總結

這篇教程通過一個動態圖表的開發,傳遞了以下信息:

  • Echarts如何與Vue結合使用
  • Vue組件開發、純組件與“臟”組件的區別
  • Vue watch的用法
  • let的特性
  • JavaScript EventLoop特性
  • ...

大家可以根據這個列表查漏補缺。

后續優化

這個組件還有需要需要優化的點,比如:

  1. 間隔時間應該可配置
  2. 每分鍾從后台獲取數據,那么圖表展示的數據將會越來越多,越來越密集,瀏覽器負擔越來越大,直到崩潰
  3. 沒有設置暫停圖表刷新的按鈕
  4. ...

期待大家自己動手,開發一個屬於自己的“完美”的Echarts動態組件!

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

華麗分割線 

上文的中效果 大家可以自己嘗試一下,或者是直接看原作者文章(里面附有動圖)

但是 效果和我心目中的不符合 預期效果應該是 每隔一段時間 x軸的內容不變,y軸的數據發生變化,原文是不斷追加x軸和y軸的數據

於是 來進行demo項目的改造。

作者動態修改x軸,y軸數據代碼如下

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

此處 作者對x軸是做如下處理 不斷追加 

 this.option.xAxis.data.push(xData[i]);

y軸同樣的處理操作

 this.option.series[0].data.push(sData[i]);

 

修改成我們設想的最終效果

setInterval(() => {
       //this.option.xAxis.data.push(xData[i])  //此行注釋 因為不需要變化x軸了
        let data = [] for (let i = 0; i < 6; i++) { data[i] = Math.ceil(Math.random() * 100) } //寫點假數據 this.option.series[0].data = data }, 10000)

本以為這樣就實現我們想要的效果了 每隔10s x軸數據不變 y軸數據不斷變化

但實際上效果並沒有改變,還是最初的數據,由於博主對vue也是初入門,於是有返回頭看作者的demo,

支持數據自動刷新
因為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中的數據有了變化,那么圖表就會重新渲染。

 

發現大概率問題應該是出現在了watch 監控上,但是為什么就知其然不知其所以然了,於是百度搜索

最后發現https://www.cnblogs.com/wanf/p/9184652.html    https://www.cnblogs.com/gunelark/p/8492468.html

 

vue watch監聽對象及對應值的變化

 
復制代碼
data:{
    a:1,
    b:{
     value:1,
   type:1,

    }
},
watch:{
     a(val, oldVal){//普通的watch監聽
         console.log("a: "+val, oldVal);
     },
     b:{//深度監聽,可監聽到對象、數組的變化
           handler(val, oldVal){
              console.log("b.value: "+val.value, oldVal.value);//但是這兩個值打印出來卻都是一樣的
          },
     deep:true
     }
}
復制代碼

如果只想監聽b中的value,怎么辦

方法一:

復制代碼
watch:{
     a(val, oldVal){//普通的watch監聽
         console.log("a: "+val, oldVal);
     },
     'b.value':{//深度監聽,可監聽到對象、數組的變化
           handler(val, oldVal){
              console.log("b.value: "+val.value, oldVal.value);//但是這兩個值打印出來卻都是一樣的
          },
     deep:true
     }
}
復制代碼

方法二,借助computed

復制代碼
computed: {
    newNum: function () {
      return this.b.value
    }
  }
watch:{
    newNum:{
      handler(val, oldVal){
         console.log(oldVal);
      },
      deep:true
    }
}
復制代碼

  

原來watch並不能只能監聽對象有沒有改變,即使deep 監聽也只能監聽到數組長度的變化,對於數組屬性的值就沒法監聽到了,而是需要借助compute來實現

得到了解決思路,繼續改造項目

computed這個位置修改如下:

computed: {
        style () {
            return { height: this.height, width: this.width } }, data () { //新增 return this.option.series[0].data //新增 }

 

watch 修改如下:

watch: {
        // 觀察option的變化
        // option: {
        //     handler (newVal, oldVal) {
        //       console.log(newVal )
        //         if (this.chart) {
        //             if (newVal) {
        //                 this.chart.setOption(newVal)
        //             } else {
        //                 this.chart.setOption(oldVal)
        //             }
        //         } else {
        //             this.init()
        //         }
        //     },
        //     deep: true // 對象內部屬性的監聽,關鍵。
        // }
        data (newValue, OldValue) {          //新增對data的數據的監聽
 console.log(newValue) this.option.series[0].data = newValue console.log(this.option.series[0].data) this.chart.setOption(this.option) } },

 

最后結果: 成功到達我想要的效果,問題解決!!!

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM