vuejs3.0 从入门到精通——观察 Vue 实例从创建到销毁的完整生命周期

观察 Vue 实例从创建到销毁的完整生命周期

一、一个简单的 Vue 实例

代码如下:

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Vue 从入门到精通,https://www.cnblogs.com/zuoyang/</title>
<script src="https://cdn.staticfile.org/vue/3.2.36/vue.global.min.js"></script>
</head>
<body>
<div id="example">
  <span>{{title}}</span>
</div>

<script>
const HelloVueApp = {
  data() {
    return {
      title: '你们的胃叫胃,孤的叫胃PLUS!'
    }
  }
}

Vue.createApp(HelloVueApp).mount('#example')
</script>
</body>
</html>

运行代码:

你们的胃叫胃,孤的叫胃PLUS!

二、生命周期

Vue 的实例在初始化时候,需要经历一系列的过程,如编译模版、渲染虚拟 DOM 树、将实例挂载到 DOM 上、设置数据监听和表数据绑定等。

在这些过程中,Vue 也允许开发者运行一些钩子函数,允许开发者在不同的阶段注入自己的代码。

举个 vue3 官方的例子,onMounted 钩子可以用来在组件完成初始渲染并创建 DOM 节点后运行代码:

<script setup>
import { onMounted } from 'vue'

onMounted(() => {
  console.log(`the component is now mounted.`)
})
</script>

还有其他一些钩子,会在实例生命周期的不同阶段被调用,最常用的是 onMountedonUpdated 和 onUnmounted。所有生命周期钩子的完整参考及其用法请参考 https://cn.vuejs.org/api/composition-api-lifecycle.html。

当调用 onMounted 时,Vue 会自动将回调函数注册到当前正被初始化的组件实例上。这意味着这些钩子应当在组件初始化时被同步注册。例如,请不要这样做:

setTimeout(() => {
  onMounted(() => {
    // 异步注册时当前组件实例已丢失
    // 这将不会正常工作
  })
}, 100)

注意这并不意味着对 onMounted 的调用必须放在 setup() 或 <script setup> 内的词法上下文中。onMounted() 也可以在一个外部函数中调用,只要调用栈是同步的,且最终起源自 setup() 就可以。

三、生命周期图示

四、生命周期钩子

4.1、onMounted()

说明:注册一个回调函数,在组件挂载完成后执行。

这个钩子在服务器端渲染期间不会被调用。

举例:通过模版引用访问一个元素:

<script setup>
import { ref, onMounted } from 'vue'

const el = ref()

onMounted(() => {
  el.value // <div>
})
</script>

<template>
  <div ref="el"></div>
</template>

4.2、onUpdated()

说明:注册一个回调函数,在组件因为响应式状态变更而更新其 DOM 树之后调用。

类型

function onUpdated(callback: () => void): void

  这个钩子在服务器端渲染期间不会被调用。

举例:访问更新后的 DOM:

<script setup>
import { ref, onUpdated } from 'vue'

const count = ref(0)

onUpdated(() => {
  // 文本内容应该与当前的 `count.value` 一致
  console.log(document.getElementById('count').textContent)
})
</script>

<template>
  <button id="count" @click="count++">{{ count }}</button>
</template>

4.3、onUnmounted()

说明:注册一个回调函数,在组件实例被卸载之后调用。

类型:

function onUnmounted(callback: () => void): void

这个钩子在服务器端渲染期间不会被调用。

举例:

<script setup>
import { onMounted, onUnmounted } from 'vue'

let intervalId
onMounted(() => {
  intervalId = setInterval(() => {
    // ...
  })
})

onUnmounted(() => clearInterval(intervalId))
</script>

4.4、onBeforeMount()

说明:注册一个钩子,在 组件被挂载之前被调用。

类型:

function onBeforeMount(callback: () => void): void

  详细说明:

当这个钩子被调用时 ,组件已完成了其响应状态的设置,但还没有创建 DOM 节点。它即将首次执行 DOM 渲染过程。

这个钩子在服务器端渲染期间不会被调用。

4.5、onBeforeUpdate()

说明:注册一个钩子,在组件即将因为响应式状态变更而更新其 DOM 树之前调用。

类型:

function onBeforeUpdate(callback: () => void): void

详细说明:

这个钩子可以用来在 Vue 更新 DOM 之前访问 DOM 状态。在这个钩子中更改状态也是安全的。

这个钩子在服务器端渲染期间不会被调用。

4.6、onBeforeUnmount()

说明:注册一个钩子,在组件实例被卸载之前调用。

类型:

function onBeforeUnmount(callback: () => void): void

详细信息:

当这个钩子被调用时,组件实例依然会保有全部的功能。

这个钩子在服务器端渲染期间不会被调用。

4.7、onErrorCaptured()

说明:注册一个钩子,在捕获了后端组件传递的错误时调用。

类型:

function onErrorCaptured(callback: ErrorCapturedHook): void

type ErrorCapturedHook = (
  err: unknown,
  instance: ComponentPublicInstance | null,
  info: string
) => boolean | voidx

详细信息:

错误可以从以下的几个来源中捕获:

        • 组件渲染
        • 事件处理器
        • 生命周期钩子
        • setup() 函数
        • 侦听器
        • 自定义指令钩子
        • 过渡钩子

这个钩子有三个实参:

      • 错误对象
      • 触发改错误的组件实例
      • 说明错误来源类型的信息字符串

错误传递规则:

        • 默认情况下,所有的错误都会被发送到应用级的 app.config.errorHandler (前提是这个函数已经定义),这样这些错误都能在一个统一的地方报告给分析服务。

        • 如果组件的继承链或组件链上存在多个 errorCaptured 钩子,对于同一个错误,这些钩子会被按从底至上的顺序一一调用。这个过程被称为“向上传递”,类似于原生 DOM 事件的冒泡机制。

        • 如果 errorCaptured 钩子本身抛出了一个错误,那么这个错误和原来捕获到的错误都将被发送到 app.config.errorHandler

        • errorCaptured 钩子可以通过返回 false 来阻止错误继续向上传递。即表示“这个错误已经被处理了,应当被忽略”,它将阻止其他的 errorCaptured 钩子或 app.config.errorHandler 因这个错误而被调用。

4.8、onRenderTracked()

说明:注册一个调试钩子,当组件渲染过程中追踪到响应式依赖时调用。

类型:

function onRenderTracked(callback: DebuggerHook): void

type DebuggerHook = (e: DebuggerEvent) => void

type DebuggerEvent = {
  effect: ReactiveEffect
  target: object
  type: TrackOpTypes /* 'get' | 'has' | 'iterate' */
  key: any
}

这个钩子仅在开发模式下可用,且在服务器端渲染期间不会被调用。

4.9、onRenderTriggered()

说明:注册一个调试钩子,当响应式依赖的变更触发了组件渲染时调用。

类型:

function onRenderTriggered(callback: DebuggerHook): void

type DebuggerHook = (e: DebuggerEvent) => void

type DebuggerEvent = {
  effect: ReactiveEffect
  target: object
  type: TriggerOpTypes /* 'set' | 'add' | 'delete' | 'clear' */
  key: any
  newValue?: any
  oldValue?: any
  oldTarget?: Map<any, any> | Set<any>
}

这个钩子仅在开发模式下可用,且在服务器端渲染期间不会被调用。

4.10、onActivated()

说明:注册一个回调函数,若组件实例是 <KeepAlive> 缓存树的一部分,当组件被插入到 DOM 中时调用。

类型: 

function onActivated(callback: () => void): void

这个钩子在服务器端渲染期间不会被调用。

4.11、onDeactivated()

说明:注册一个回调函数,若组件实例是 <KeepAlive> 缓存树的一部分,当组件从 DOM 中被移除时调用。

类型:

function onDeactivated(callback: () => void): void

这个钩子在服务器端渲染期间不会被调用。

4.12、onServerPrefetch()

说明:注册一个异步函数,在组件实例在服务器上被渲染之前调用。

类型:  

function onServerPrefetch(callback: () => Promise<any>): void

详细信息:

  • 如果这个钩子返回了一个 Promise,服务端渲染会在渲染该组件前等待该 Promise 完成。
  • 这个钩子仅会在服务端渲染中执行,可以用于执行一些仅存在于服务端的数据抓取过程。 
举例:
<script setup>
import { ref, onServerPrefetch, onMounted } from 'vue'

const data = ref(null)

onServerPrefetch(async () => {
  // 组件作为初始请求的一部分被渲染
  // 在服务器上预抓取数据,因为它比在客户端上更快。
  data.value = await fetchOnServer(/* ... */)
})

onMounted(async () => {
  if (!data.value) {
    // 如果数据在挂载时为空值,这意味着该组件
    // 是在客户端动态渲染的。将转而执行
    // 另一个客户端侧的抓取请求
    data.value = await fetchOnClient(/* ... */)
  }
})
</script> 
posted @ 2023-01-17 22:25  左扬  阅读(210)  评论(0编辑  收藏  举报
levels of contents