1,前言
<script setup>
是在單文件組件中使用Composition API的編譯時語法糖。相比於普通的<script>
語法,它具有更多優勢
- 更少的樣板內容,更簡潔的代碼
- 能夠使用純 Typescript 聲明 props 和拋出事件
- 更好的運行時性能 (其模板會被編譯成與其同一作用域的渲染函數,沒有任何的中間代理)
- 更好的 IDE 類型推斷性能 (減少語言服務器從代碼中抽離類型的工作)
2,基本語法
<template>
<p>{{ name }}</p>
</template>
<script setup lang="ts">
let name = '小明'
</script>
script
里面的代碼會被編譯成組件setup()
函數的內容。這意味着與普通的<script>
只在組件被首次引入的時候執行一次不同,<script setup>
中的代碼會在每次組件實例被創建的時候執行。
注意:當使用<script setup>
的時候,任何在<script setup>
聲明的頂層的綁定 (包括變量,函數,以及import
引入的內容) 都能在模板中直接使用,不需要return
2,響應式
響應式狀態需要使用響應式APIs
來創建
<template>
<p>{{ name }}</p>
<p>{{ data.title }}</p>
</template>
<script setup lang="ts">
import { ref, reactive } from 'vue'
let name = ref('小明')
let data = reactive({
title: '標題'
})
</script>
3,組件使用
<script setup>
范圍里的值也能被直接作為自定義組件的標簽名使用,不需要寫在conmonent
對象里
<template>
<MyComponent />
</template>
<script setup>
import MyComponent from './MyComponent.vue'
</script>
3.1,動態組件
由於組件被引用為變量而不是作為字符串鍵來注冊的,在<script setup>
中要使用動態組件的時候,就應該使用動態的:is
來綁定
<template>
<component :is="Foo" />
<component :is="someCondition ? Foo : Bar" />
</template>
<script setup>
import Foo from './Foo.vue'
import Bar from './Bar.vue'
</script>
3.2,遞歸組件
一個單文件組件可以通過它的文件名被其自己所引用。例如:文件名為Foo.vue
的組件可以在其模板中用<Foo/>
引用它自己。如果名稱沖突了,就需要使用別名。
import { Foo as FooBarChild } from './components'
4,自定義指令
全局注冊的自定義指令將以符合預期的方式工作,且本地注冊的指令可以直接在模板中使用,就像上文所提及的組件一樣。但這里有一個需要注意的限制:必須以 vNameOfDirective
的形式來命名本地自定義指令,以使得它們可以直接在模板中使用
- 基本語法
<template>
<h1 v-my-directive>This is a Heading</h1>
</template>
<script setup>
const vMyDirective = {
beforeMount: (el) => {
// 在元素上做些操作
}
}
</script>
- 導入指令
<script setup>
// 導入的指令同樣能夠工作,並且能夠通過重命名來使其符合命名規范
import { myDirective as vMyDirective } from './MyDirective.js'
</script>
5,props
在<script setup>
中必須使用defineProps
來聲明props
,它具備完整的類型推斷並且在<script setup>
中是直接可用的
<script setup>
const props = defineProps({
foo: String
})
</script>
5.1,TypeScript支持
- 僅限類型聲明
const props = defineProps<{
foo: string
bar?: number
}>()
- 默認值
interface Props {
msg?: string
labels?: string[]
}
const props = withDefaults(defineProps<Props>(), {
msg: 'hello',
labels: () => ['one', 'two']
})
6,emit
在<script setup>
中必須使用defineEmits
來聲明emits
,它具備完整的類型推斷並且在<script setup>
中是直接可用的
<script setup>
const emit = defineEmits(['change', 'delete'])
</script>
6.1,TypeScript支持
- 僅限類型聲明
const emit = defineEmits<{
(e: 'change', id: number): void
(e: 'update', value: string): void
}>()
7,defineExpose暴露
使用<script setup>
的組件是默認關閉的,也即通過模板ref
或者$parent
鏈獲取到的組件的公開實例,不會暴露任何在<script setup>
中聲明的綁定
<script setup>
import { ref } from 'vue'
const a = 1
const b = ref(2)
defineExpose({
a,
b
})
</script>
8,useSlots 和 useAttrs
在模板中通過$slots
和$attrs
來訪問它們
<script setup>
import { useSlots, useAttrs } from 'vue'
const slots = useSlots()
const attrs = useAttrs()
</script>
9,與普通的script一起使用
<script setup>
可以和普通的<script>
一起使用。普通的<script>
在有這些需要的情況下或許會被使用到。
- 無法在
<script setup>
聲明的選項,例如inheritAttrs
或通過插件啟用的自定義的選 - 聲明命名導出
- 運行副作用或者創建只需要執行一次的對象
<script>
// 普通 <script>, 在模塊范圍下執行(只執行一次)
runSideEffectOnce()
// 聲明額外的選項
export default {
inheritAttrs: false,
customOptions: {}
}
</script>
<script setup>
// 在 setup() 作用域中執行 (對每個實例皆如此)
</script>
如果看了覺得有幫助的,我是@上進的鵬多多,歡迎 點贊 關注 評論;END
PS:在本頁按F12,在console中輸入document.querySelectorAll('.diggit')[0].click(),有驚喜哦
公眾號
往期文章
- 助你上手Vue3全家桶之Vue-Router4教程
- 助你上手Vue3全家桶之Vue3教程
- 助你上手Vue3全家桶之VueX4教程
- 使用nvm管理node.js版本以及更換npm淘寶鏡像源
- 超詳細!Vue-Router手把手教程
- vue中利用.env文件存儲全局環境變量,以及配置vue啟動和打包命令
- 微信小程序實現搜索關鍵詞高亮
- 超詳細!Vue的九種通信方式
- 超詳細!Vuex手把手教程
個人主頁