Suspense,本意是“悬而未决”的意思,这是 Vue3 新增的一个内置组件,主要用来在组件树中协调对异步依赖的处理。
假设有如下目录结构:
<Suspense>
└─ <Dashboard>
├─ <Profile>(内容一)
│ └─ <FriendStatus>(好友状态组件:有异步的setup方法)
└─ <Content>(内容二)
├─ <ActivityFeed> (活动提要:异步组件)
└─ <Stats>(统计组件:异步组件)
在这个组件树中有多个嵌套组件,要渲染出它们,首先得解析一些异步资源。
每个异步组件需要处理自己的加载、报错和完成状态。在最坏的情况下,可能会在页面上看到三个旋转的加载状态,然后在不同的时间显示出内容。
有了
- 带有异步 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>
- 异步组件
在
- #default:当所有的异步依赖都完成后,会进入完成状态,展示默认插槽内容。
- #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:显示后备内容的时候触发