十分鐘,帶你瞭解 Vue3 的新寫法

喆星高照發表於2024-05-06

本文的目的,是為了讓已經有 Vue2 開發經驗的 ,快速掌握 Vue3 的寫法。

因此, 本篇假定你已經掌握 Vue 的核心內容 ,只為你介紹編寫 Vue3 程式碼,需要了解的內容。

一、Vue3 裡 script 的三種寫法

首先,Vue3 新增了一個叫做組合式 api 的東西,英文名叫 Composition API。因此 Vue3 的 script 現在支援三種寫法,

1、最基本的 Vue2 寫法

<template>
<div>{{ count }}</div>
<button @click="onClick">
增加 1
</button>
</template>

<script>
export default {
data() {
return {
count: 1,
};
},
methods: {
onClick() {
this.count += 1;
},
},
}
</script>

2、setup() 屬性

<template>
<div>{{ count }}</div>
<button @click="onClick">
增加 1
</button>
</template>

<script>
import { ref } from 'vue';
export default {

// 注意這部分
setup() {
let count = ref(1);
const onClick = () => {
count.value += 1;
};
return {
count,
onClick,
};
},

}
</script>

3、<script setup>

<template>
<div>{{ count }}</div>
<button @click="onClick">
增加 1
</button>
</template>

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

const count = ref(1);
const onClick = () => {
count.value += 1;
};
</script>

正如你看到的那樣,無論是程式碼行數,還是程式碼的精簡度,<script setup> 的方式是最簡單的形式。

如果你對 Vue 很熟悉,那麼,我推薦你使用 <script setup> 的方式。

這種寫法,讓 Vue3 成了我最喜歡的前端框架。

如果你還是前端新人,那麼,我推薦你先學習第一種寫法。

因為第一種寫法的學習負擔更小,先學第一種方式,掌握最基本的 Vue 用法,然後再根據我這篇文章,快速掌握 Vue3 裡最需要關心的內容。

第一種寫法,跟過去 Vue2 的寫法是一樣的,所以我們不過多介紹。

第二種寫法,所有的物件和方法都需要 return 才能使用,太囉嗦。除了舊專案,可以用這種方式體驗 Vue3 的新特性以外,我個人不建議瞭解這種方式。反正我自己暫時不打算精進這部分。

所以,接下來,我們主要介紹的,也就是 <script setup> ,這種寫法裡需要了解的內容。

注意: <script setup> 本質上是第二種寫法的語法糖,掌握了這種寫法,其實第二種寫法也基本上就會了。(又多了一個不學第二種寫法的理由)。

二、如何使用 <script setup> 編寫元件

學習 Vue3 並不代表你需要新學習一個技術,Vue3 的底層開發思想,跟 Vue2 是沒有差別的。

V3 和 V2 的區別就像是,你用不同的語言或者方言說同一句話。

所以我們需要關心的,就是 Vue2 裡的內容,怎麼用 Vue3 的方式寫出來。

1、data——唯一需要注意的地方

整個 data 這一部分的內容,你只需要記住下面這一點。

以前在 data 中建立的屬性,現在全都用 ref() 宣告。

template 中直接用,在 script 中記得加 .value

在開頭,我就已經寫了一個簡單的例子,我們直接拿過來做對比。

1)寫法對比

 // Vue2 的寫法

<template>
<div>{{ count }}</div>
<button @click="onClick">
增加 1
</button>
</template>

<script>
export default {
data() {
return {
count: 1,
};
},
methods: {
onClick() {
this.count += 1;
},
},
}
</script>
 // Vue3 的寫法

<template>
<div>{{ count }}</div>
<button @click="onClick">
增加 1
</button>
</template>

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

// 用這種方式宣告
const count = ref(1);

const onClick = () => {
// 使用的時候記得 .value
count.value += 1;
};
</script>

2)注意事項——組合式 api 的心智負擔

a、ref 和 reactive

Vue3 裡,還提供了一個叫做 reactiveapi

但是我的建議是,你不需要關心它。絕大多數場景下,ref 都夠用了。

b、什麼時候用 ref() 包裹,什麼時候不用。

要不要用ref,就看你的這個變數的值改變了以後,頁面要不要跟著變。

當然,你可以完全不需要關心這一點,跟過去寫 data 一樣就行。

只不過這樣做,你在使用的時候,需要一直 .value

c、不要解構使用

在使用時,不要像下面這樣去寫,會丟失響應性。

也就是會出現更新了值,但是頁面沒有更新的情況

// Vue3 的寫法
<template>
<div>{{ count }}</div>
<button @click="onClick">
增加 1
</button>
</template>

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

const count = ref(1);
const onClick = () => {
// 不要這樣寫!!
const { value } = count;
value += 1;
};
</script>

注意: 學習 Vue3 就需要考慮像這樣的內容,徒增了學習成本。實際上這些心智負擔,在學習的過程中,是可以完全不需要考慮的。

這也是為什麼我推薦新人先學習 Vue2 的寫法。

2、methods

宣告事件方法,我們只需要在 script 標籤裡,建立一個方法物件即可。

剩下的在 Vue2 裡是怎麼寫的,Vue3 是同樣的寫法。

// Vue2 的寫法
<template>
<div @click="onClick">
這是一個div
</div>
</template>

<script>
export default {
methods: {
onClick() {
console.log('clicked')
},
},
}
</script>
// Vue3 的寫法
<template>
<div @click="onClick">
這是一個div
</div>
</template>

<script setup>

// 注意這部分
const onClick = () => {
console.log('clicked')
}

</script>

3、props

宣告 props 我們可以用 defineProps(),具體寫法,我們看程式碼。

1)寫法對比

// Vue2 的寫法
<template>
<div>{{ foo }}</div>
</template>

<script>
export default {
props: {
foo: String,
},
created() {
console.log(this.foo);
},
}
</script>
// Vue3 的寫法
<template>
<div>{{ foo }}</div>
</template>

<script setup>

// 注意這裡
const props = defineProps({
foo: String
})

// 在 script 標籤裡使用
console.log(props.foo)
</script>

2)注意事項——組合式 api 的心智負擔

使用 props 時,同樣注意不要使用解構的方式。

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

// 不要這樣寫
const { foo } = props;
console.log(foo)
</script>

4、emits 事件

props 相同,宣告 emits 我們可以用 defineEmits(),具體寫法,我們看程式碼。

// Vue2 的寫法
<template>
<div @click="onClick">
這是一個div
</div>
</template>

<script>
export default {

emits: ['click'], // 注意這裡
methods: {
onClick() {
this.$emit('click'); // 注意這裡
},
},

}
</script>
// Vue3 的寫法
<template>
<div @click="onClick">
這是一個div
</div>
</template>

<script setup>

// 注意這裡
const emit = defineEmits(['click']);

const onClick = () => {
emit('click') // 注意這裡
}

</script>

5、computed

直接上寫法對比。

// Vue2 的寫法
<template>
<div>
<span>{{ value }}</span>
<span>{{ reversedValue }}</span>
</div>
</template>

<script>
export default {
data() {
return {
value: 'this is a value',
};
},
computed: {
reversedValue() {
return value
.split('').reverse().join('');
},
},
}
</script>
// Vue3 的寫法
<template>
<div>
<span>{{ value }}</span>
<span>{{ reversedValue }}</span>
</div>
</template>

<script setup>
import {ref, computed} from 'vue'
const value = ref('this is a value')

// 注意這裡
const reversedValue = computed(() => {
// 使用 ref 需要 .value
return value.value
.split('').reverse().join('');
})

</script>

6、watch

這一部分,我們需要注意一下了,Vue3 中,watch 有兩種寫法。一種是直接使用 watch,還有一種是使用 watchEffect

兩種寫法的區別是:

  • watch 需要你明確指定依賴的變數,才能做到監聽效果。

  • watchEffect 會根據你使用的變數,自動的實現監聽效果。

1)直接使用 watch

// Vue2 的寫法
<template>
<div>{{ count }}</div>
<div>{{ anotherCount }}</div>
<button @click="onClick">
增加 1
</button>
</template>

<script>
export default {
data() {
return {
count: 1,
anotherCount: 0,
};
},
methods: {
onClick() {
this.count += 1;
},
},
watch: {
count(newValue) {
this.anotherCount = newValue - 1;
},
},
}
</script>
// Vue3 的寫法
<template>
<div>{{ count }}</div>
<div>{{ anotherCount }}</div>
<button @click="onClick">
增加 1
</button>
</template>

<script setup>
import { ref, watch } from 'vue';

const count = ref(1);
const onClick = () => {
count.value += 1;
};

const anotherCount = ref(0);

// 注意這裡
// 需要在這裡,
// 明確指定依賴的是 count 這個變數
watch(count, (newValue) => {
anotherCount.value = newValue - 1;
})

</script>

2)使用 watchEffect

// Vue2 的寫法
<template>
<div>{{ count }}</div>
<div>{{ anotherCount }}</div>
<button @click="onClick">
增加 1
</button>
</template>

<script>
export default {
data() {
return {
count: 1,
anotherCount: 0,
};
},
methods: {
onClick() {
this.count += 1;
},
},
watch: {
count(newValue) {
this.anotherCount = newValue - 1;
},
},
}
</script>
// Vue3 的寫法
<template>
<div>{{ count }}</div>
<div>{{ anotherCount }}</div>
<button @click="onClick">
增加 1
</button>
</template>

<script setup>
import { ref, watchEffect } from 'vue';

const count = ref(1);
const onClick = () => {
count.value += 1;
};

const anotherCount = ref(0);

// 注意這裡
watchEffect(() => {
// 會自動根據 count.value 的變化,
// 觸發下面的操作
anotherCount.value = count.value - 1;
})

</script>

7、生命週期

Vue3 裡,除了將兩個 destroy 相關的鉤子,改成了 unmount,剩下的需要注意的,就是在 <script setup> 中,不能使用 beforeCreatecreated 兩個鉤子。

如果你熟悉相關的生命週期,只需要記得在 setup 裡,用 on 開頭,加上大寫首字母就行。

// 選項式 api 寫法
<template>
<div></div>
</template>

<script>
export default {
beforeCreate() {},
created() {},

beforeMount() {},
mounted() {},

beforeUpdate() {},
updated() {},

// Vue2 裡叫 beforeDestroy
beforeUnmount() {},
// Vue2 裡叫 destroyed
unmounted() {},

// 其他鉤子不常用,所以不列了。
}
</script>
// 組合式 api 寫法
<template>
<div></div>
</template>


<script setup>
import {
onBeforeMount,
onMounted,

onBeforeUpdate,
onUpdated,

onBeforeUnmount,
onUnmounted,
} from 'vue'

onBeforeMount(() => {})
onMounted(() => {})

onBeforeUpdate(() => {})
onUpdated(() => {})

onBeforeUnmount(() => {})
onUnmounted(() => {})
</script>

三、結語

好了,對於快速上手 Vue3 來說,以上內容基本已經足夠了。

這篇文章本身不能做到幫你理解所有 Vue3 的內容,但是能幫你快速掌握 Vue3 的寫法。

如果想做到對 Vue3 的整個內容心裡有數,還需要你自己多看看 Vue3 的官方文件

相關文章