vue3核心语法
- 组合式API setup语法糖(name属性 – vite插件简化)
- 响应式数据的创建:ref、reactive
- 计算属性:computed(get、set)
- 监听器:watch (能够监听的4种数据、监听的 5种情况)
- 标签的ref属性
- props(接收+限制类型+指定默认值+限制必要性)
- vue生命周期(整体可分为四个阶段、八个钩子)
- vue解析流程、父子组件生命周期顺序
- hooks(封装)
OptionsAPI 与 CompositionAPI
Vue2
的API
设计是Options
(配置)风格的。Vue3
的API
设计是Composition
(组合)风格的。
Options API 的弊端
Options
类型的 API
,数据、方法、计算属性等,是分散在:data
、methods
、computed
中的,若想新增或者修改一个需求,就需要分别修改:data
、methods
、computed
,不便于维护和复用。


Composition API 的优势
可以用函数的方式,更加优雅的组织代码,让相关功能的代码更加有序的组织在一起。


说明:以上四张动图原创作者:大帅老猿(掘金)
拉开序幕的 setup
setup 概述
setup是Vue3
中一个新的配置项,值是一个函数,它是 Composition API
“表演的舞台”,组件中所用到的:数据、方法、计算属性、监视……等等,均配置在setup
中。
特点如下:
setup
函数返回的对象中的内容,可直接在模板中使用。setup
中访问this
是undefined
。setup
函数会在beforeCreate
之前调用,它是“领先”所有钩子执行的。
1 | <template> |
setup 的返回值
- 若返回一个对象:则对象中的:属性、方法等,在模板中均可以直接使用(重点关注)。
- 若返回一个函数:则可以自定义渲染内容,代码如下:
1
2
3
4setup(){
// setup的返回值也可以是一个渲染函数
return ()=> '你好啊!'
}
setup 与 Options API 的关系
Vue2
的配置(data
、methos
……)中可以访问到setup
中的属性、方法。- 但在
setup
中不能访问到Vue2
的配置(data
、methos
……)。因为
setup
是最早的生命周期,所以setup可以被其他选项摸到,而它摸不到其他选项。 - 如果与
Vue2
冲突,则setup
优先。虽然他们可以共存,但是vue3不要写vue2的data、method,不到万不得已。
setup 语法糖
每次我们在setup中定义了数据,并使用,都需要把它return出去,这就很麻烦,大量的编写应用,就很容易忘记去return。所以有更简单的写法 —— setup语法糖
多写一个script标签,写上setup属性<script setup></script>
这样,这个里面的东西就相当于,写到setup(){}函数里面,而且它还会自动return
setup
函数有一个语法糖,这个语法糖,可以让我们把setup
独立出去,代码如下:
1 | <template> |
所以对于vue3的项目,有两个script标签,一个是专门配置组合式API的,一个是专门配置组件名字的。但是写两个难受了,还不能合到一块,我们可以借助插件完成↓
扩展:上述代码,还需要编写一个不写setup
的script
标签,去指定组件名字,比较麻烦,我们可以借助vite
中的插件简化
第一步:
npm i vite-plugin-vue-setup-extend -D
第二步:
vite.config.ts
1
2
3
4
5
6import { defineConfig } from 'vite'
import VueSetupExtend from 'vite-plugin-vue-setup-extend'
export default defineConfig({
plugins: [ VueSetupExtend() ]
})第三步:
<script setup lang="ts" name="Person">
ref 创建:基本类型的响应式数据
在vue2中,只要将数据定义到data节点里面,这个数据就自动是响应式的了,其他它在背后是做了数据代理和数据劫持
vue3有两个东西去定义响应式数据:ref、reactive(这个ref
和vue2中的$ref
不是一个东西)
- 作用:定义响应式变量。
- 语法:
let xxx = ref(初始值)
。 - 返回值:一个
RefImpl
的实例对象,简称ref对象
或ref
,ref
对象的value
属性是响应式的。 - 注意点:
JS
中操作数据需要:xxx.value
,但模板中不需要.value
,直接使用即可。- 对于
let name = ref('张三')
来说,name
不是响应式的,name.value
是响应式的。
1 | <template> |
reactive 创建:对象类型的响应式数据
- 作用:定义一个响应式对象(基本类型不要用它,要用
ref
,否则报错)reactive只能定义 对象类型的响应式数据
- 语法:
let 响应式对象= reactive(源对象)
。 - 返回值: 一个
Proxy
的实例对象,简称:响应式对象。 - 注意点:
reactive
定义的响应式数据是“深层次”的。- 该对象的所有子属性(不论嵌套多深)都会被转换为响应式的。
- 即使是后来新增的属性,由于使用了Proxy代理,Vue也能确保这些新属性自动成为响应式的
- 当删除一个属性时,Vue的响应式系统也能感知到这一变化,并相应地处理依赖更新。
1 | <template> |
ref 创建:对象类型的响应式数据
- 其实
ref
接收的数据可以是:基本类型、对象类型。 - 若
ref
接收的是对象类型的时候,内部其实也是调用了reactive
函数。
1 | <template> |
ref 对比 reactive
宏观角度看:
ref
用来定义:基本类型数据、对象类型数据;
reactive
用来定义:对象类型数据。
- 区别:
ref
创建的变量必须使用.value
(可以使用volar
插件自动添加.value
)。
设置 – 扩展 – Volar(老版的TS volar插件)
设置 – 扩展 – Vue(新版的vue-offical插件)![]()
reactive
重新分配一个新对象,会失去响应式(可以使用Object.assign
去整体替换)。(官方文档将其叫做:reactive的局限性)
一个注意点:.value的问题
ref
创建的变量,必须使用.value
reactive
创建的变量:1
2
3
4
5
6let obj = reactive({
a:1,
b:2,
c:ref(3)
})
console.log(obj.a , obj.b , obj.c)虽然c是一个响应式的数据,数字3 ,, 但是不需要
.value
,如果.value
得到的事undefinedc
是一个响应式的数据,但是它是放在一个响应式对象里面的,也就是说,当你去触碰obj.c
的时候,它自动就解包了(自动已经开始读取value了)重新分配一个对象
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17<h2>汽车信息:一辆{{car.brand}}车,价值{{car.price}}万</h2>
<button @click="changePrice">修改汽车价格</button>
<button @click="changeCar">换一辆车</button> // 点击按钮不起作用 -- 失去响应式
// 重新分配一个对象
let car = reactive({brand:'奔驰',price:100})
// 方法
function changePrice(){
car.price += 10
}
// 触发换车事件后,由于失去响应式,修改价格也不会再生效
function changeCar(){
car = {brand:'奥拓',price:1}
car = reactive({brand:'奥拓',price:1}) // 即便是用reactive包裹,依旧一样会失去响应式
// 可以通过ES6的assign方法来修改,会将后面所有对象的属性加到car中,同名则覆盖
Object.assign(car,{brand:'奥拓',price:1})
}1
2
3
4let car = ref({brand:'奔驰',price:100})
function changeCar(){
car.value = {brand:'奥拓',price:1} // 如果是ref,就可以直接整体改
}
这种写法经常是无法避免的,比如后端返回一个对象,有二十多个属性,我们是不可能一个一个修改属性值的,肯定是要重新分配一个对象
- 使用原则:
- 若需要一个基本类型的响应式数据,必须使用
ref
。- 若需要一个响应式对象,层级不深,
ref
、reactive
都可以。- 若需要一个响应式对象,且层级较深,推荐使用
reactive
。做表单相关的,做收集数据、表单数据回显,推荐使用reactive
如果一个表单里面有非常多数据,大量的使用ref,最终的代码就会一堆.value,不是很合适
ref代理对象还是调的reactive,所以reactive代理对象性能更好
toRefs 与 toRef
toRefs应该会更常用些,毕竟写法更简单,而且也可以获取单个属性
- 作用:将一个响应式对象中的每一个属性,转换为
ref
对象。如果嵌套的过多,每次都要去
.
很多东西,就很麻烦,直接取出来可以更方便 - 备注:
toRefs
与toRef
功能一致,但toRefs
可以批量转换。 - 语法如下:
1 | <template> |
computed
作用:根据已有数据计算出新数据(和Vue2
中的computed
作用一致)。

1 | <template> |
watch
- 作用:监视数据的变化(和
Vue2
中的watch
作用一致) - 特点:
Vue3
中的watch
只能监视以下四种数据:ref
定义的数据。reactive
定义的数据。- 一个函数,返回一个值(相当于一个
getter
函数)。 - 一个包含上述内容的数组。
我们在Vue3
中使用watch
的时候,通常会遇到以下几种情况:
* 情况一(常用)
监视ref
定义的【基本类型】数据:直接写数据名即可,监视的是其value
值的改变。
1 | <template> |
* 情况二
监视ref
定义的【对象类型】数据:直接写数据名,监视的是对象的【地址值】,若想监视对象内部的数据,要手动开启深度监视。
注意:
若修改的是
ref
定义的对象中的属性,newValue
和oldValue
都是新值,因为它们是同一个对象。若修改整个
ref
定义的对象,newValue
是新值,oldValue
是旧值,因为不是同一个对象了,去访问的时候都是已经改变过的值了。实际开发中,大多数情况下,我们是不管这个旧值的
1 | <template> |
* 情况三
监视reactive
定义的【对象类型】数据,且默认开启了深度监视。
1 | <template> |
* 情况四(常用)
监视ref
或reactive
定义的【对象类型】数据中的某个属性,注意点如下:
- 若该属性值不是【对象类型】,需要写成函数形式。
- 若该属性值是依然是【对象类型】,可直接编,也可写成函数,建议写成函数。
如果直接监听,只能监听到属性改变,但是整体改变后监听就失效了
写成函数监听,就和ref的对象数据监听一样了
结论:监视的要是对象里的属性,那么最好写函数式,注意点:若是对象监视的是地址值,需要关注对象内部,需要手动开启深度监视。
1 | <template> |
* 情况五(有几率)
监视上述的多个数据
1 | <template> |
watchEffect
官网:立即运行一个函数,同时响应式地追踪其依赖,并在依赖更改时重新执行该函数。
watch
对比watchEffect
都能监听响应式数据的变化,不同的是监听数据变化的方式不同
watch
:要明确指出监视的数据watchEffect
:不用明确指出监视的数据(函数中用到哪些属性,那就监视哪些属性)。全自动的监视
示例代码:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48<template>
<div class="person">
<h1>需求:水温达到50℃,或水位达到20cm,则联系服务器</h1>
<h2 id="demo">水温:{{temp}}</h2>
<h2>水位:{{height}}</h2>
<button @click="changePrice">水温+1</button>
<button @click="changeSum">水位+10</button>
</div>
</template>
<script lang="ts" setup name="Person">
import {ref,watch,watchEffect} from 'vue'
// 数据
let temp = ref(0)
let height = ref(0)
// 方法
function changePrice(){
temp.value += 10
}
function changeSum(){
height.value += 1
}
// 用watch实现,需要明确的指出要监视:temp、height
watch([temp,height],(value)=>{
// 从value中获取最新的temp值、height值
const [newTemp,newHeight] = value
// 室温达到50℃,或水位达到20cm,立刻联系服务器
if(newTemp >= 50 || newHeight >= 20){
console.log('联系服务器')
}
})
// 用watchEffect实现,不用
const stopWtach = watchEffect(()=>{
// 室温达到50℃,或水位达到20cm,立刻联系服务器
if(temp.value >= 50 || height.value >= 20){
console.log(document.getElementById('demo')?.innerText)
console.log('联系服务器')
}
// 水温达到100,或水位达到50,取消监视
if(temp.value === 100 || height.value === 50){
console.log('清理了')
stopWtach()
}
})
</script>
标签的 ref 属性
作用:用于注册模板引用。
用在普通
DOM
标签上,获取的是DOM
节点。用在组件标签上,获取的是组件实例对象。
用在普通DOM
标签上:
1 | <template> |
用在组件标签上:
1 | <!-- 父组件App.vue --> |
- 子组件
Person.vue
中要使用defineExpose
宏命令暴露内容
在app组件中直接打印出组件的实例对象,是看不到组件内的数据的,这是一种保护措施
1 | // vue3最新版本已经内置了defineExpose,不需要引入了,是宏命令 |
props
1
2
3
4
5
6
7
8
9
10
11
12 // TS接口
// 定义一个接口,限制每个Person对象的格式
export interface PersonInter {
id:string,
name:string,
age:number,
x?:number // x是可有可无,有的话必须为number类型
}
// TS 自定义类型 & 泛型
// 定义一个自定义类型Persons
export type Persons = Array<PersonInter>
App.vue
中代码:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18 <template>
<Person :list="persons"/>
</template>
<script lang="ts" setup name="App">
import Person from './components/Person.vue'
import {reactive} from 'vue'
// 最新的规范,为了与值做区分,导入的类型要加type
import {type Persons} from './types'
// 虽然let persons<Persons> = reactive([...])这样写没有报错,但是这种写法并没有使得规范生效
// reactive对象,是支持泛型的
let persons = reactive<Persons>([
{id:'e98219e12',name:'张三',age:18},
{id:'e98219e13',name:'李四',age:19},
{id:'e98219e14',name:'王五',age:20,x:9}
])
</script>
Person.vue
中代码:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31 <template>
<div class="person">
<ul>
<li v-for="item in list" :key="item.id">
{{item.name}}--{{item.age}}
</li>
</ul>
</div>
</template>
<script lang="ts" setup name="Person">
// 新版vue3似乎也内置了defineProps和withDefaults,不需要引入
//defineXXX,这种的一般都属于宏函数,在vue3里面不用引入
import {defineProps} from 'vue'
import {type PersonInter} from '@/types'
// 第一种写法:仅接收
// defineProps返回值是一个Proxy对象,包含所有你接收的东西
// defineProps参数必须是字符串的数组,命名必须和传入的值保持一致(否则为undefined)
const props = defineProps(['list'])
// 第二种写法:接收+限制类型(而且还是个必要传的值)
const props = defineProps<{list:Persons}>()
// 第三种写法:接收+限制类型+指定默认值+限制必要性
let props = withDefaults(defineProps<{list?:Persons}>(),{
list:()=>[{id:'asdasg01',name:'小猪佩奇',age:18}]
})
// vue2中直接把props属性定义为对象类型default:xxx,就很简单
console.log(props)
</script>
生命周期
概念:
Vue
组件实例在创建时要经历一系列的初始化步骤,在此过程中Vue
会在合适的时机,调用特定的函数,从而让开发者有机会在特定阶段运行自己的代码,这些特定的函数统称为:生命周期钩子生命周期、生命周期函数、生命周期钩子,都是指的生命周期
规律:
生命周期整体分为四个阶段,八个钩子:创建、挂载、更新、销毁,每个阶段都有两个钩子,一前一后。
这些是vue最为常用、最为基本的生命周期。
虽然vue的钩子(生命周期)不止8个,像是nextTick,路由守卫,缓存路由组件的钩子,但是只要掌握基本的这8个,其他的都可以现用现查现写Vue2
的生命周期创建阶段:
beforeCreate
、created
挂载阶段:
beforeMount
、mounted
更新阶段:
beforeUpdate
、updated
销毁阶段:
beforeDestroy
、destroyed
Vue3
的生命周期创建阶段:
setup
挂载阶段:
onBeforeMount
、onMounted
更新阶段:
onBeforeUpdate
、onUpdated
卸载阶段:
onBeforeUnmount
、onUnmounted
常用的钩子:
onMounted
(挂载完毕)、onUpdated
(更新完毕)、onBeforeUnmount
(卸载之前)示例代码:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37<template>
<div class="person">
<h2>当前求和为:{{ sum }}</h2>
<button @click="changeSum">点我sum+1</button>
</div>
</template>
<!-- vue3写法 -->
<script lang="ts" setup name="Person">
import { ref, onBeforeMount, onMounted, onBeforeUpdate, onUpdated, onBeforeUnmount, onUnmounted } from 'vue'
// 数据
let sum = ref(0)
// 方法
function changeSum() {
sum.value += 1
}
console.log('setup')
// 生命周期钩子
onBeforeMount(()=>{
console.log('挂载之前')
})
onMounted(()=>{
console.log('挂载完毕')
})
onBeforeUpdate(()=>{
console.log('更新之前')
})
onUpdated(()=>{
console.log('更新完毕')
})
onBeforeUnmount(()=>{
console.log('卸载之前')
})
onUnmounted(()=>{
console.log('卸载完毕')
})
</script>vue解析流程:
任何一个组件都有生命周期,这就涉及到了父与子之间的生命周期顺序:1
2
3
4
5// App.vue
<template>
<Person v-if="show" />
<h1>你好</h1>
</template>父创建
–父挂载前
– 子创建 – 子挂载前 – 子挂载完毕 –父挂载完毕
父 和 子 , 子组件先挂载完
解析流程:
入口文件index.html
引入了main.ts
,main.ts
要把App
挂到页面上,于是解析App组件
。
解析的时候发现App组件
里面用到了Person子组件
,它马上去忙Person
,等把Person
里面所有的东西都忙完了,然后就算<Person/>
这一行解析完了(证明该调的钩子都调完了)
App
整个解析完了,就是h1
这块解析完了子是先执行的,父是最后的。所以App组件永远是最后挂载的
自定义hook
什么是
hook
?—— 把setup
函数中使用的Composition API
进行了封装,类似于vue2.x
中的mixin
。本质是一个函数,一个 .js/.ts文件
作用:封装,高内聚,低耦合。让一个功能的数据和方法贴在一起(不用hooks和vue2写法没太大区别)
正是有了hooks,组合式才发挥出来了威力!自定义
hook
的优势:复用代码, 让setup
中的逻辑更清楚易懂。命名规范:useXXX
返回值: 返回值没有强制要求必须是对象,但是为了更好地组织和管理状态,以及提高代码的可读性,建议在组合函数中返回一个对象
示例代码:
useSum.ts
中内容如下:1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19import {ref,onMounted} from 'vue'
// 默认导出的必须是一个函数,并且没有名字!
export default function(){
let sum = ref(0)
const increment = ()=>{
sum.value += 1
}
const decrement = ()=>{
sum.value -= 1
}
onMounted(()=>{ // hooks里面能写钩子!
increment()
})
//向外部暴露数据,写数组[],甚至map容器都行,但是推荐写对象。
return {sum,increment,decrement}
}useDog.ts
中内容如下:1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28import {reactive,onMounted} from 'vue'
import axios,{AxiosError} from 'axios'
export default function(){
let dogList = reactive<string[]>([])
// 方法
async function getDog(){
try {
// 发请求
let {data} = await axios.get('https://dog.ceo/api/breed/pembroke/images/random')
// 维护数据
dogList.push(data.message)
} catch (error) {
// 处理错误
const err = <AxiosError>error
console.log(err.message)
}
}
// 挂载钩子
onMounted(()=>{
getDog()
})
//向外部暴露数据
return {dogList,getDog}
}组件中具体使用:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25<template>
<h2>当前求和为:{{sum}}</h2>
<button @click="increment">点我+1</button>
<button @click="decrement">点我-1</button>
<hr>
<img v-for="(u,index) in dogList.urlList" :key="index" :src="(u as string)">
<span v-show="dogList.isLoading">加载中......</span><br>
<button @click="getDog">再来一只狗</button>
</template>
<script lang="ts">
import {defineComponent} from 'vue'
export default defineComponent({
name:'App',
})
</script>
<script setup lang="ts">
import useSum from './hooks/useSum'
import useDog from './hooks/useDog'
let {sum,increment,decrement} = useSum()
let {dogList,getDog} = useDog()
</script>
拓展 – mixin
mixin是vue2的一种设计模式,用于实现组件间的代码复用
通常会定义一组可复用的组件配置,如数据,计算属性,方法,生命周期钩子等,将其封装到一个如myMixin.js
的文件中
工作原理:将 mixin 对象中的选项与组件自身的选项进行合并。如果 mixin 和组件中存在相同的选项,如 methods、data、computed 等,Vue 会按照一定的规则进行合并处理。例如:
- 对于 data,mixin 中的数据会被合并到组件的数据对象中,如果有同名属性,则组件自身的 data 优先级更高,会覆盖 mixin 中的同名属性。
- 对于 methods、computed、watch 等,如果存在同名函数或属性,它们会被合并,不会覆盖,如果同名方法都存在,则两个方法都会执行(对于生命周期钩子,会将它们合并成数组,依次调用)。
- 对于生命周期钩子,如果 mixin 和组件都定义了同一个钩子函数,则这些函数会被合成一个数组,当生命周期事件触发时,这些函数会按照它们被发现的顺序依次调用。
1 | // 定义一个 mixin |
然后在需要使用的vue组件中引入该文件:import myMixin from './myMixin.js';
并挂载到mixin选项上:mixins: [myMixin], // 引入mixin
1 | // 在单文件组件(.vue文件)中使用 mixin |