vue3 支持两种风格书写:选项式 API 和组合式 API
- 若采用组合式 API ,则使用生命周期钩子
- 若采用选项式 API ,则使用生命周期选项
- 两者选用一种即可,不建议同时使用,避免逻辑紊乱。
生命周期钩子
在 setup 中使用
onBeforeMount()
组件被挂载之前执行回调
- 组件已经完成了其响应式状态的设置,但还没有创建 DOM 节点。
- 即将首次执行 DOM 渲染过程。
<script setup>
import { onBeforeMount } from 'vue'
onBeforeMount(() => {
console.log("组件被挂载之前执行")
})
</script>
注意事项:
在服务器端渲染期间不会被调用
onMounted()
组件挂载完成后执行回调
- 所有同步子组件都已经被挂载 (不包含异步组件或 树内的组件)。
- 自身的 DOM 树已经创建完成并插入了父容器中
<script setup>
import { onMounted } from 'vue'
onMounted(() => {
console.log("组件挂载完成后执行")
})
</script>
使用场景:
- 执行需要访问组件所渲染的 DOM 树相关的副作用
- 服务端渲染应用中用于确保 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>
注意事项:
- 在服务器端渲染期间不会被调用
- 不要在 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 树相关的副作用
- 服务端渲染应用中用于确保 DOM 相关代码仅在客户端执行
注意事项:
- 在服务器端渲染时不会被调用
beforeUpdate
组件即将因为一个响应式状态变更而更新其 DOM 树之前执行回调
export default {
beforeUpdate() {
console.log("组件更新前执行")
}
}
使用场景:
- 在 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 上移除、进入缓存
// 以及组件卸载时调用
}
}
使用场景:
被缓存的组件实例变为不活跃状态时
注意事项:
- 在服务器端渲染期间不会被调用
其他生命周期不常用,可参考官网 了解即可。