Vue 3已經(jīng)穩(wěn)定了相當(dāng)長一段時(shí)間了。許多代碼庫都在生產(chǎn)環(huán)境中使用它，其他人最終都將不得不遷移到Vue 3。我現(xiàn)在有機(jī)會使用它并記錄了我的錯(cuò)誤，下面這些錯(cuò)誤你可能想要避免。

使用Reactive聲明原始值

數(shù)據(jù)聲明在過去都是非常直接的，但是現(xiàn)在有很多幫助函數(shù)供我們使用。目前的規(guī)則是：

• 使用reactive聲明Object, Array, Map, Set
• 使用ref聲明String, Number, Boolean

為一個(gè)原始值使用reactive會返回一個(gè)警告，并且該值不會成為可響應(yīng)式數(shù)據(jù)。

/* DOES NOT WORK AS EXPECTED */
<script setup>
import { reactive } from "vue";

const count = reactive(0);
</script>

矛盾的是，另一種方式是可行的。例如，使用ref來聲明一個(gè)Array會在內(nèi)部調(diào)用reactive。

解構(gòu)響應(yīng)式數(shù)據(jù)

假設(shè)你有一個(gè)響應(yīng)式對象擁有count屬性，并且有一個(gè)按鈕來遞增count。

<template>
  Counter: {{ state.count }}
  <button @click="add">Increase</button>
</template>

<script>
import { reactive } from "vue";
export default {
  setup() {
    const state = reactive({ count: 0 });

    function add() {
      state.count++;
    }

    return {
      state,
      add,
    };
  },
};
</script>

上述邏輯相當(dāng)直接，而且如預(yù)期的那樣工作，但你可能會利用javascript的解構(gòu)來做以下事情：

/* DOES NOT WORK AS EXPECTED */
<template>
  <div>Counter: {{ count }}</div>
  <button @click="add">Increase</button>
</template>

<script>
import { reactive } from "vue";
export default {
  setup() {
    const state = reactive({ count: 0 });

    function add() {
      state.count++;
    }

    return {
      ...state,
      add,
    };
  },
};
</script>

代碼看起來是一樣的，而且根據(jù)我們以前的經(jīng)驗(yàn)應(yīng)該是可行的，但事實(shí)上，Vue的響應(yīng)式跟蹤是通過屬性訪問進(jìn)行的。這意味著我們不能賦值或解構(gòu)一個(gè)響應(yīng)式對象，因?yàn)榕c第一個(gè)引用的響應(yīng)式連接已經(jīng)斷開。這就是使用響應(yīng)式幫助函數(shù)的局限性之一。

對.value感到困惑

同樣的，使用ref的一個(gè)怪異模式可能也很難習(xí)慣。

Ref接收一個(gè)值，并返回響應(yīng)式對象。該值在對象內(nèi)部的.value屬性下可用。

const count = ref(0)

console.log(count) // { value: 0 }
console.log(count.value) // 0

count.value++
console.log(count.value) // 1

但是ref在模板文件中使用時(shí)會被解包，并且不需要.value。

<script setup>
import { ref } from 'vue'

const count = ref(0)

function increment() {
  count.value++
}
</script>

<template>
  <button @click="increment">
    {{ count }} // no .value needed
  </button>
</template>

但是要小心了！解包只在頂級屬性中生效。下面的代碼片段會生成[object Object]。

// DON'T DO THIS
<script setup>
import { ref } from 'vue'

const object = { foo: ref(1) }

</script>

<template>
  {{ object.foo + 1 }}  // [object Object]
</template>

正確地使用.value需要時(shí)間。盡管某些時(shí)候我會忘記如何使用，但是使用它的頻率越來越高。

觸發(fā)事件

自從Vue的最初發(fā)布以來，子組件就可以與父組件使用emit來通信。你只需要添加自定義事件監(jiān)聽器來監(jiān)聽一個(gè)事件。

// 子組件
this.$emit('my-event')

// 父組件
<my-component @my-event="doSomething" />

現(xiàn)在，emit需要使用defineEmits來進(jìn)行聲明。

<script setup>
const emit = defineEmits(['my-event'])
emit('my-event')
</script>

另一件要記住的事情是，defineEmits和defineProps都不需要被導(dǎo)入。它們在使用script setup時(shí)自動(dòng)可用。

<script setup>
const props = defineProps({
  foo: String
})

const emit = defineEmits(['change', 'delete'])
// setup code
</script>

最后，由于事件現(xiàn)在必須被聲明，所以不需要使用.native修飾符，事實(shí)上它已經(jīng)被移除了。

聲明附加選項(xiàng)

Options API方法有幾個(gè)屬性在script setup中是不被支持的。

• name
• inheritAttrs
• 插件或庫所需的自定義選項(xiàng)

解決辦法是按照script setupRFC的定義，在同一個(gè)組件中設(shè)置兩個(gè)不同的腳本。

<script>
  export default {
    name: 'CustomName',
    inheritAttrs: false,
    customOptions: {}
  }
</script>

<script setup>
  // script setup logic
</script>

使用響應(yīng)式轉(zhuǎn)換

Reactivity Transform是Vue 3的一個(gè)實(shí)驗(yàn)性但有爭議的功能，目的是簡化組件的聲明方式。它的想法是利用編譯時(shí)的轉(zhuǎn)換來自動(dòng)解包一個(gè)ref，并使.value過時(shí)。但現(xiàn)在它被放棄了，并將在Vue 3.3中被刪除。它仍然可以作為一個(gè)包使用，但由于它不是Vue核心的一部分，所以最好不要在它身上投入時(shí)間。

定義異步組件

以前的異步組件是通過將其包含在一個(gè)函數(shù)中來聲明的。

const asyncModal = () => import('./Modal.vue')

從 Vue 3開始，異步組件需要使用defineAsyncComponent幫助函數(shù)來顯式地定義。

import { defineAsyncComponent } from 'vue'

const asyncModal = defineAsyncComponent(() => import('./Modal.vue'))

在模板中使用多余的包裹元素

在Vue 2中，組件模板需要一個(gè)單一的根元素，這有時(shí)會引入不必要的包裹元素。

<!-- Layout.vue -->
<template>
  <div>
    <header>...</header>
    <main>...</main>
    <footer>...</footer>
  </div>
</template>

現(xiàn)在不再需要這樣了，因?yàn)楝F(xiàn)在支持多個(gè)根元素。??

<!-- Layout.vue -->
<template>
  <header>...</header>
  <main v-bind="$attrs">...</main>
  <footer>...</footer>
</template>

使用錯(cuò)誤的生命周期

所有的組件生命周期事件都被重新命名，要么添加on前綴，要么完全改變名稱。你可以在下面的圖表中查看所有的變化。

不看文檔

最后，官方文檔已經(jīng)進(jìn)行了修改以反映新的API，并包括許多有價(jià)值的說明、指南和最佳實(shí)踐。即使你是一個(gè)經(jīng)驗(yàn)豐富的Vue 2工程師，你也一定會通過閱讀文檔學(xué)到一些新東西。

總結(jié)

每個(gè)框架都有一個(gè)學(xué)習(xí)曲線，而Vue 3的學(xué)習(xí)曲線無疑比Vue 2的更陡峭。我仍然不相信兩個(gè)版本之間的遷移工作是合理的，但組合式API要整潔得多，在你掌握了它之后會感覺很自然。

最后，請記?。?/p>

犯錯(cuò)比什么都不做要好得多。

Making mistakes is a lot better than not doing anything.

最新評論