三十七、Suspense


Suspense,本意是“悬而未决”的意思,这是 Vue3 新增的一个内置组件,主要用来在组件树中协调对异步依赖的处理。

假设有如下目录结构:

<Suspense>
  └─ <Dashboard>
  ├─ <Profile>(内容一)
│  └─ <FriendStatus>(好友状态组件:有异步的setup方法)
└─ <Content>(内容二)
├─ <ActivityFeed> (活动提要:异步组件)
└─ <Stats>(统计组件:异步组件)

在这个组件树中有多个嵌套组件,要渲染出它们,首先得解析一些异步资源。

每个异步组件需要处理自己的加载、报错和完成状态。在最坏的情况下,可能会在页面上看到三个旋转的加载状态,然后在不同的时间显示出内容。

有了 组件后,我们就可以在等待整个多层级组件树中的各个异步依赖获取结果时,在顶层统一处理加载状态

可以等待的异步依赖有两种:

  1. 带有异步 setup( ) 钩子的组件。这也包含了使用 setup标签 时有顶层 await 表达式的组件
export default {
  async setup() {
    const res = await fetch(...)
    const posts = await res.json()
    return {
      posts
    }
  }
}
<script setup>
const res = await fetch(...)
const posts = await res.json()
</script>

<template>
  {{ posts }}
</template>
  1. 异步组件

组件中有两个插槽,两个插槽都只允许一个直接子节点。

  1. #default:当所有的异步依赖都完成后,会进入完成状态,展示默认插槽内容。
  2. #fallback:如果有任何异步依赖未完成,则进入挂起状态,在挂起状态期间,展示的是后备内容

快速上手

App.vue
└─ Dashboard.vue
   ├─ Profile.vue
   │  └─ FriendStatus.vue(组件有异步的 setup)
   └─ Content.vue
      ├─ AsyncActivityFeed(异步组件)
      │  └─ ActivityFeed.vue
      └─ AsyncStats(异步组件)
         └─ Stats.vue

实现效果:使用 Suspense 统一显示状态

🤔 思考:假设想要让 Profile 组件内容先显示出来,不等待 Content 组件的异步完成状态,该怎么做?

其他细节

1. 内置组件嵌套顺序

经常会和 搭配着一起使用,此时就涉及到一个嵌套的顺序问题,谁在外层,谁在内层。

下面是一个模板:

<RouterView v-slot="{ Component }">
  <template v-if="Component">
    <Transition mode="out-in">
      <KeepAlive>
        <Suspense>
          <!-- 主要内容 -->
          <component :is="Component"></component>

          <!-- 加载中状态 -->
          <template #fallback>
            正在加载...
          </template>
        </Suspense>
      </KeepAlive>
    </Transition>
  </template>
</RouterView>

你可以根据实际开发需求,删减你不需要的组件。

2. 事件

组件会触发三个事件:

  • pending:在进入挂起状态时触发
  • resolve:在 default 插槽完成获取新内容时触发
  • fallback:显示后备内容的时候触发

文章作者: 吴俊杰
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 吴俊杰 !
  目录