Skip to content

Suspense List

一句话解释

Suspense List 控制多个 Suspense 边界的显示顺序——防止布局跳变。

用大白话说

Suspense List(React 18 中仍为实验性)协调多个 Suspense 边界如何显示内容。没有它,每个边界独立显示——导致布局跳变和刺眼的重排序。使用 Suspense List,你可以指定:

  • reveal="together"——等待全部,一起显示
  • reveal="forwards"——按顺序显示,如果前面的没准备好则跳过
  • reveal="backwards"——按逆序显示这防止了多个异步部分以不同时间加载时的错误内容闪烁和布局偏移。注意:此 API 仍为实验性,可能变化。

示例

jsx
import { SuspenseList, Suspense } from "react";

function Profile({ userId }) {
  return (
    <SuspenseList reveal="together">
      <Suspense fallback={<Spinner />}>
        <Header userId={userId} />
      </Suspense>
      <Suspense fallback={<Spinner />}>
        <Bio userId={userId} />
      </Suspense>
      <Suspense fallback={<Spinner />}>
        <Posts userId={userId} />
      </Suspense>
    </SuspenseList>
  );
}

SuspenseList with reveal='together' 等待三个部分全部加载后同时显示——无布局跳变。

常见混淆

  • 容易混淆的对象: Suspense

    关键区别: Suspense 包装单个异步边界并在等待时显示 fallback。SuspenseList 包装多个 Suspense 边界并协调它们的显示顺序。Suspense 处理一个加载器;SuspenseList 编排多个加载器。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表