vue3 支持两种风格书写:选项式 API 和组合式 API
- 若采用组合式 API ,则使用生命周期钩子
- 若采用选项式 API ,则使用生命周期选项
- 两者选用一种即可,不建议同时使用,避免逻辑紊乱。
生命周期钩子
在 setup 中使用
onBeforeMount()
开始挂载
组件被挂载之前执行此回调
- 组件已经完成了响应式状态的设置,可以进行Ajax请求
- 编译模板,首次调用 render 生成 vdom
- 还没有开始渲染 DOM
<script setup>
import { onBeforeMount } from 'vue'
onBeforeMount(() => {
console.log("组件被挂载之前执行")
})
</script>
注意事项:
在服务器端渲染期间不会被调用
onMounted()
结束挂载
组件挂载完成后执行回调
- 所有同步子组件都已经被挂载 (不包含异步组件或 树内的组件)。
- 自身的 DOM 树已经创建完成并插入了父容器中
<script setup>
import { onMounted } from 'vue'
onMounted(() => {
console.log("组件挂载完成后执行")
})
</script>
使用场景:
- 执行需要访问组件所渲染的 DOM 树相关的副作用
- 进行Ajax请求 (与 onBeforeMount 相比更合适,因为可以操作 DOM)
注意事项:
在服务器端渲染期间不会被调用
onBeforeUpdate()
开始更新
组件即将因为响应式状态变更而更新其 DOM 树之前执行回调
<script setup>
import { onBeforeUpdate } from 'vue'
onBeforeUpdate(() => {
console.log("更新 DOM 树之前执行")
})
</script>
使用场景:
在 Vue 更新 DOM 之前访问 DOM 状态
注意事项:
在服务器端渲染期间不会被调用
onUpdated()
结束更新
在组件因为响应式状态变更而更新其 DOM 树之后执行回调
- 子组件中的 onUpdated 回调比父组件中的 onUpdated 回调先执行
- 多个状态变更会在同一个渲染周期中批量执行 (为了提升性能)。如果需要在某个特定的状态更改后访问更新后的 DOM,需使用 nextTick()
<script setup>
import { onUpdated } from 'vue'
onUpdated(() => {
console.log("更新 DOM 树之后执行")
})
</script>
Vue 中更改响应式状态时,最终的 DOM 更新并不是同步生效的,而是由 Vue 将它们缓存在一个队列中,直到下一个“tick”才一起执行。这样是为了确保每个组件无论发生多少状态改变,都仅执行一次更新。
nextTick
- 用于等待下一次 DOM 更新后执行
- 可以传递一个回调函数作为参数,或者 await 返回的 Promise。
- onMounted 和 onUpdated 都不能保证子组件全部挂载完成,所以所有 DOM 操作,都建议在 nextTick 中进行。
<script setup>
import { ref, nextTick } from 'vue'
const count = ref(0)
async function increment() {
count.value++
// DOM 还未更新
console.log(document.getElementById('counter').textContent) // 0
await nextTick()
// DOM 此时已经更新
console.log(document.getElementById('counter').textContent) // 1
}
</script>
<template>
<button id="counter" @click="increment">{{ count }}</button>
</template>
注意事项:
- 在服务器端渲染期间不会被调用
- 不要在 onUpdated 中更改组件的状态,这可能导致无限的更新循环!
onBeforeUnmount()
开始卸载
组件实例被卸载之前执行回调
- 此时组件实例依然还保有全部的功能
- 对应 vue2 中的生命周期 beforeDestroy
<script setup>
import { onBeforeUnmount } from 'vue'
onBeforeUnmount(() => {
console.log("组件被卸载之前执行")
})
</script>
注意事项:
- 在服务器端渲染期间不会被调用
onUnmounted()
结束卸载
组件实例被卸载之后执行回调
- 此时所有子组件都已经被卸载
- 所有相关的响应式作用 (渲染作用以及 setup() 时创建的计算属性和侦听器) 都已经停止。
- 对应 vue2 中的生命周期 destroyed
<script setup>
import { onUnmounted } from 'vue'
onUnmounted(() => {
console.log("组件被卸载之后执行")
// 清除计时器 timer
clearInterval(timer)
})
</script>
使用场景:
手动清理一些副作用,例如计时器、DOM 事件监听器、与服务器的连接、自定义事件等
注意事项:
- 在服务器端渲染期间不会被调用
onActivated()
若组件实例是 <KeepAlive>
缓存树的一部分,当组件被插入到 DOM 中时执行回调
- onActivated 在组件挂载时也会调用
- 缓存的组件实例的生命周期 mounted 被 onActivated 替代
<script setup>
import { onActivated } from 'vue'
onActivated(() => {
// 调用时机为首次挂载
// 以及每次从缓存中被重新插入时
})
</script>
使用场景:
被缓存的组件实例重新被激活时
注意事项:
- 在服务器端渲染期间不会被调用
onDeactivated()
若组件实例是 <KeepAlive>
缓存树的一部分,当组件从 DOM 中被移除时执行回调
- onDeactivated 在组件卸载时也会调用
- 缓存的组件实例的生命周期 unmounted 被 onDeactivated 替代
<script setup>
import { onDeactivated } from 'vue'
onDeactivated(() => {
// 在从 DOM 上移除、进入缓存
// 以及组件卸载时调用
})
</script>
使用场景:
被缓存的组件实例变为不活跃状态时
注意事项:
- 在服务器端渲染期间不会被调用
其他生命周期不常用,可参考官网 了解即可。
生命周期选项
setup() 会在所有生命周期选项之前调用
beforeCreate
组件实例初始化完成之后执行回调
- 此时 props 已被解析
- 接着 props 会被定义成响应式属性,data() 和 computed 等选项也开始进行处理。
export default {
beforeCreate() {
console.log("组件初始化完成之后执行")
}
}
created
组件实例处理完所有与状态相关的选项之后执行回调
- 此时响应式数据、计算属性、方法和侦听器已经设置完成
- 挂载阶段还未开始,因此 $el 属性仍不可用
export default {
created() {
console.log("组件处理完所有与状态相关的选项之后执行")
}
}
beforeMount
开始挂载
组件被挂载之前执行回调
- 此时已经完成了其响应式状态的设置,但还没有创建 DOM 节点
- 即将首次执行 DOM 渲染过程
export default {
beforeMount() {
console.log("组件被挂载之前执行")
}
}
注意事项:
- 在服务器端渲染时不会被调用
mounted
结束挂载
组件被挂载之后执行回调
- 所有同步子组件都已经被挂载。(不包含异步组件或 树内的组件)
- 自身的 DOM 树已经创建完成并插入了父容器中。
export default {
mounted() {
console.log("组件被挂载之后执行")
}
}
使用场景:
- 操作 DOM
注意事项:
- 在服务器端渲染时不会被调用
beforeUpdate
开始更新
组件即将因为一个响应式状态变更而更新其 DOM 树之前执行回调
export default {
beforeUpdate() {
console.log("组件更新前执行")
}
}
- 状态更新时触发
- 此时data 中的状态值是最新的,但是界面上显示的数据还是旧的
- 准备更新 DOM (尚未更新 DOM )
使用场景:
- 在 Vue 更新 DOM 之前访问 DOM 状态
注意事项:
- 在服务器端渲染时不会被调用
updated
结束更新
组件因为一个响应式状态变更而更新其 DOM 树之后执行回调
- 子组件中的 updated 回调比父组件中的 updated 回调先执行
- 不同的状态变更都会触发组件更新,如果需要在某个特定的状态更改后访问更新后的 DOM,需使用 nextTick()
export default {
updated() {
console.log("组件更新后执行")
}
}
使用场景:
- 在 Vue 更新 DOM 之前访问 DOM 状态
注意事项:
- 在服务器端渲染时不会被调用
- 不要在 updated 中更改组件的状态,可能导致死循环!
beforeUnmount
组件实例被卸载之前执行回调
- 此时组件实例依然还保有全部的功能
- vue2 中的生命周期 beforeDestroy 改名而来
export default {
beforeUnmount() {
console.log("组件卸载之前执行")
}
}
注意事项:
- 在服务器端渲染时不会被调用
unmounted
组件实例被卸载之后执行回调
- vue2 中的生命周期 destroyed 改名而来
- 此时所有子组件都已经被卸载
- 所有相关的响应式作用 (渲染作用以及 setup() 时创建的计算属性和侦听器) 都已经停止。
export default {
unmounted() {
console.log("组件卸载之后执行")
}
}
使用场景:
手动清理一些副作用,例如计时器、DOM 事件监听器或者与服务器的连接。
注意事项:
- 在服务器端渲染时不会被调用
activated()
若组件实例是 <KeepAlive>
缓存树的一部分,当组件被插入到 DOM 中时执行回调
- activated 在组件挂载时也会调用
- 缓存的组件实例的生命周期 mounted 被 activated替代
export default {
activated() {
// 在首次挂载、
// 以及每次从缓存中被重新插入的时候调用
}
}
使用场景:
被缓存的组件实例重新被激活时
注意事项:
- 在服务器端渲染期间不会被调用
deactivated()
若组件实例是 <KeepAlive>
缓存树的一部分,当组件从 DOM 中被移除时执行回调
- deactivated 在组件卸载时也会调用
- 缓存的组件实例的生命周期 unmounted 被 deactivated 替代
export default {
deactivated() {
// 在从 DOM 上移除、进入缓存
// 以及组件卸载时调用
}
}
使用场景:
被缓存的组件实例变为不活跃状态时
注意事项:
- 在服务器端渲染期间不会被调用
其他生命周期不常用,可参考官网 了解即可。