这里是完整的目录图片,由于整篇文章篇幅太长,拆分成了几篇来展示
前言
vue3 使用的越来越广泛, 公司项目开始使用 vue3 ,在 vue 3.2 之后新加入了 script setup 语法糖,上手开始看项目发现对于语法糖的使用有一些迷惑,特此整理,在整理这些内容的同时查阅了大量的资料,自己在这个过程中,对于 vue3 的理解也更深了一些 ~ 希望各位也可以从中有所收获
因为很多地方都不太理解 , 本文的分析程度比较细致 , 甚至可能到了有些太细致的程度 ~
一、什么是setup script
<script setup>
是在单文件组件中使用组合式 API 的 " 编译时 " 语法糖 ,当同时使用 单文件组件 以及 组合式 API 的时 候, <script setup>
是更为推荐的一种语法方式,它有着更多的优势
但在说这些优势之前需要先说一下,从 Vue 3.2 版本之后才开始加入了 <script setup>
语法糖,这一语法糖的加入让 Vue3 的写法有了大大的改变 ! 相对于原本 Vue 3 的语法,简单了很多很多很多 !
因为 <script setup>
语法糖是依赖于 Vue3 的,所以如果对 Vue3 还没有太多的了解,建议先学习下 Vue3 之后再开始学习 <script setup>
语法糖,直接上来搞这个理解起来容易混乱 [ 本人因为公司使用的是 Vue3+TS ,但是在此之前一直用的是 Vue2 ,直接开始看项目之后属实懵逼了,建议各位同仁循序渐进啊 ~ ]
以下是官方的介绍
在 Vue 3 当中我自己感觉最鲜明的变化就是 Vue 3 中引入了组合式 Api (composition API)
但是使用 Vue3 组合式 API 的时候感觉整个过程比较繁琐
- 在 setup () 当中定义 ⇒ setup() 中 return ⇒ 模板中使用
如果需要定义一个方法的话,模板中使用这个方法的时候,需要在 setup 函数中将它返回,模板中需要用到的大量的方法和属性都需要一 一返回 , 这个过程有点难受,时不时的就会漏掉返回这一步导致变量未定义或者 xx not a function 的错误
<script>
import {defineComponent , reactive, ref} from 'vue'
export default defineComponent({
setup(){
// 基本类型变量
const name = ref("你好")
const age = ref(2023)
// 引用类型变量
const book = reactive({name:"月亮",age:"1919"})
// 将变量返回
return{
name,
age,
book
}
}
})
</script>
<script setup>
作为 setup 方法的语法糖,在书写上更加简洁方便,在 setup 函数中,所有 ES 模块导出都被认为是暴露给上下文的值,在 <script setup>
写法中,不需要再手动写 setup(){} .可以直接在 script 标签中书写 setup 的内容,并且不需要做 return 返回处理 .
解决了 setup 需要频繁的将 声明的变量
,函数
,以及 import 引入的内容
通过 return 向外暴漏,才能在 <template/>
中使用的问题 , setup语法糖的形式最为便捷而且更符合开发者习惯
所以使用 <script setup>
的时候
二、如何使用 setup script 语法糖
基本语法
需要启用 <script setup>
语法糖,需要在 <script>
代码块加上 setup
属性
也就是说 : 只需在 script 标签上写上 setup 就可以了
<script setup>
console.log('hello script setup')
</script>
里面的代码会被编译成组件 setup() 函数当中的内容
<script setup>
和 <script>
的执行时机是不同的
- 普通的
<script>
只会在组件第一次被引入的时候执行一次 - 而
<script setup>
中的代码会在每次组件实例被创建的时候执行
三、setup script 有什么用
1. 属性和方法无需返回
之前说 组合式API (composition API ) 写起来有些繁琐的原因在于需要手动返回模板需要的属性和方法,而在 setup script 中可以省略这一步骤
setup script 不需要写 return ,所以直接声明数据,方法就可以在模板中直接使用了
属性
<template>
<div>
<!-- 在模板中使用变量 -->
<div> {{ name }} </div>
<div> {{ age }} </div>
<div> {{ book.name }} </div>
<div> {{ book.age }} </div>
</div>
</template>
Vue 3 setup() 语法
传统写法中我们需要在 setup 当中定义变量,并在最后 return
<script>
import {defineComponent , reactive, ref} from 'vue'
export default defineComponent({
setup(){
// 基本数据类型的响应式
const name = ref("你好")
const age = ref(2023)
// 复杂数据类型的响应式
const book = reactive({name:"月亮",age:"1919"})
// 将变量返回
return{
name,
age,
book
}
}
})
</script>
<script setup>
语法糖的写法
不再需要对定义的变量进行 return ,我们定义的 ref reactive 变量可以直接在 template 当中直接使用
<script setup>
import {reactive, ref} from 'vue'
// 基本类型变量
const name = ref("你好")
const age = ref(2023)
// 引用类型变量
const book = reactive({name:"月亮",age:"1919"})
</script>
方法
<template>
<div>
<!-- 在模板中使用变量 -->
<div @click="showMessage">点击我输出信息</div>
</div>
</template>
Vue 3 setup() 语法
传统写法中我们需要在 setup 当中定义方法,并在最后 return
<script>
import {defineComponent} from 'vue'
export default defineComponent({
setup(){
const showMessage = ()=>{
console.log("hi vue3")
}
// 将变量返回
return{
showMessage
}
}
})
</script>
<script setup>
语法糖的写法
不再需要对定义的方法进行 return ,我们定义的方法可以直接在 template 当中直接使用
<script setup>
const showMessage = ()=>{
console.log("hi vue3")
}
</script>
小结
上方的 demo 对比可以看到完全省略了 return 中的所有内容, 嗷呜,是不是非常方便呢?
在 <script setup>
标签中声明的 “顶层的绑定” – [包括 变量,函数声明,以及 import 引入的内容] 都是可以在模板中直接使用的
在 <script setup>
标签中需要声明响应式的变量,就需要使用响应式 API 来创建 ( ref() reactive() …) , 如果在 <script setup>
标签中需要用 ref() reactive() 同样是需要手动引入ref 和 reactive 的 import {reactive, ref} from 'vue'
script setup 和 setup() 函数的返回值一样, ref 在模板中使用的时候会自动被解包