元件中 watch props 根據 v-if 動態判斷並掛載 DOM 的問題

⭐️ 更多前端技術和知識點，搜尋訂閱號 JS 菌 訂閱

問題復現：父元件中通過名為 source 的 prop 向子元件 Chart 傳入資料

<Chart :source="chartData"></Chart>
複製程式碼

import Chart from '../components/Chart'

export default {
  name: 'Home',
  components: { Chart },
  data () {
    return {
      chartData: []
    }
  },
  mounted () {
    setTimeout(() => {
      this.chartData = [
        [89.3, 58212, 'Matcha Latte'],
        [57.1, 78254, 'Milk Tea'],
        [74.4, 41032, 'Cheese Cocoa'],
        [50.1, 12755, 'Cheese Brownie'],
        [89.7, 20145, 'Matcha Cocoa'],
        [68.1, 79146, 'Tea'],
        [19.6, 91852, 'Orange Juice'],
        [10.6, 101852, 'Lemon Juice'],
        [32.7, 20112, 'Walnut Brownie']
      ]
    }, 2000)
  }
}
複製程式碼

子元件接收 source 資料當存在且至少有一條資料的時候，建立 id 為 main 的 div，用以初始化 echarts 例項

<div v-if="source && source.length" id="main" ref="main" style="width: 600px;height: 400px;"></div>
<div vi-else>none</div>
複製程式碼

Chart 元件通過接收資料 watch prop 的變化動態的呼叫 echarts 的 setOptions 方法，最終渲染資料。

export default {
  // ...
  watch: {
    source (newVal, oldVal) {
      this.setOpts()
    }
  },
  props: ['source'],
  methods: {
    setOpts () {
      let myChart = this.$echarts.init(this.$refs.main)
      myChart.setOption({
        dataset: {
          // ...
          source: this.source
        },
        // ...
      })
    }
  }
}
複製程式碼

如果直接這麼寫必定報錯：

Error in callback for watcher "source": "TypeError: Cannot read property 'getAttribute' of undefined"

在程式碼中增加一行程式碼：

watch: {
    source (newVal, oldVal) {
      console.log(newVal, this.$refs.main) // [Array ...] undefined
      this.setOpts()
    }
  },
複製程式碼

啟示 source 資料雖然有了，但 div 還並未掛載，因此 echarts 無法完成初始化

那麼想當然的我們就會去在 mounted 生命週期函式中呼叫 setOpts 方法：

mounted () {
    console.log(this.source, this.$refs.main) // [] undefined
    this.setOpts()
  },
複製程式碼

這樣也是錯的，因為模板語法中使用了 v-if，那麼當 source 並未滿足條件的時候，div 當然也不會掛載。因此 div 仍然無法訪問到。

Error in mounted hook: "TypeError: Cannot read property 'getAttribute' of undefined"

解決辦法是要麼去掉 v-if 要麼換另一種寫法

有時我們需要在沒有資料的情況下增加一個佔位標籤用來展示一些額外的提醒資訊，如“暫未獲取到資料”等。那麼去掉 v-if 肯定不行。

既然如此我們保留 v-if 但寫法有所改變：

修改 Chart 元件：

<template>
  <div>
    <div id="main" ref="main" style="width: 600px;height: 400px;"></div>
  </div>
</template>
複製程式碼

我們只需要一個 source 資料來源，當 mounted 的時候呼叫 setOpts 方法，當 watch 資料變化的時候再次呼叫以更新資料

export default {
  name: 'Chart',
  props: ['source'],
  mounted () {
    this.setOpts()
  },
  watch: {
    source () {
      this.setOpts()
    }
  },
  methods: {
    setOpts () {
      let myChart = this.$echarts.init(this.$refs.main)
      myChart.setOption({
        dataset: {
          dimensions: ['score', 'amount', 'product'],
          source: this.source
        },
        xAxis: { type: 'category' },
        yAxis: {},
        series: [
          {
            type: 'bar',
            encode: {
              x: 'product',
              y: 'amount'
            }
          }
        ]
      })
    }
  }
}
複製程式碼

v-if 的判斷我們把他移出去了我們判斷 chartData 是否獲取到，一旦獲取到資料，馬上載入 Chart 元件，這樣就可以避開在元件內部呼叫 v-if 帶來的問題：

<template>
  <div>
    <Chart :source="chartData" v-if="flag"></Chart>
    <div v-else>none</div>
  </div>
</template>
複製程式碼

import Chart from '../components/Chart'

export default {
  name: 'Home',
  components: { Chart },
  data () {
    return {
      chartData: [],
      flag: false
    }
  },
  methods: {
    getData () {
      setTimeout(() => {
        this.chartData = [
          [89.3, 58212, 'Matcha Latte'],
          [57.1, 78254, 'Milk Tea'],
          [74.4, 41032, 'Cheese Cocoa'],
          [50.1, 12755, 'Cheese Brownie'],
          [89.7, 20145, 'Matcha Cocoa'],
          [68.1, 79146, 'Tea'],
          [19.6, 91852, 'Orange Juice'],
          [10.6, 101852, 'Lemon Juice'],
          [32.7, 20112, 'Walnut Brownie']
        ]
        this.flag = true
      }, 2000)
    }
  },
  mounted () {
    this.getData()
  }
}
複製程式碼

另外還可將 Chart 元件和站位標籤一同封裝成一個 ChartWrapper。

這樣就不會因在元件內部呼叫 watch 監聽 props 的變化動態 v-if 判斷並掛載資料到 DOM 上出現的這種問題了。

請關注我的訂閱號，不定期推送有關 JS 的技術文章，只談技術不談八卦 ?