React / 系统课时
Suspense 与过渡更新
Suspense 与过渡更新
异步界面的问题不只是“显示一个加载中”,还包括更新时是否把用户正在看的内容突然替换掉。本篇把 Suspense 的等待边界与 useTransition 的非阻塞更新组合起来,让切页或切标签时保留已展示内容,并提供明确的进行中反馈。
学习目标
- 理解
Suspense与 Transition 分别解决什么问题 - 能用
useTransition包装非紧急的页面或标签更新 - 能判断哪些状态更新不应该放进 Transition
分清等待边界与更新优先级
Suspense 定义的是一个等待边界:当子树因为 lazy 组件代码或其他 Suspense 可感知资源尚未就绪而挂起时,边界决定显示 fallback。Transition 定义的是更新优先级:被标记的状态更新可以在后台准备,并允许更紧急的交互先响应。
两者结合时,已经显示出来的内容不必因为下一块内容暂时挂起就立刻消失。React 可以继续保留旧内容,同时通过 isPending 告诉你“新的非紧急界面还在准备”,等新内容就绪后再一次提交。

用 useTransition 保留已展示内容
下面是片段示例,假设项目已有 React 入口。初始“概览”立即可用,“报表”通过 lazy 按需加载;切换状态放进 Transition 后,报表代码未就绪时会尽量保留已经显示的概览,同时用 isPending 给出轻量提示。
// App.jsx
import { lazy, Suspense, useState, useTransition } from 'react';
const ReportsTab = lazy(() => import('./ReportsTab.jsx'));
function OverviewTab() {
return <p>这里是概览内容。</p>;
}
export default function App() {
const [tab, setTab] = useState('overview');
const [isPending, startTransition] = useTransition();
function selectTab(nextTab) {
startTransition(() => {
setTab(nextTab);
});
}
return (
<main aria-busy={isPending}>
<button onClick={() => selectTab('overview')}>概览</button>
<button onClick={() => selectTab('reports')}>报表</button>
{isPending && <span role="status">正在切换…</span>}
<Suspense fallback={<p>首次内容尚未准备好…</p>}>
{tab === 'overview' ? <OverviewTab /> : <ReportsTab />}
</Suspense>
</main>
);
}// ReportsTab.jsx
console.log('ReportsTab 模块已加载');
export default function ReportsTab() {
return <p>这里是报表内容。</p>;
}预期结果:应用先显示“概览”。首次点击“报表”时,如果报表 chunk 还在下载,概览内容会继续保留,并短暂出现“正在切换…”;模块就绪后再显示“报表”。网络足够快时 pending 提示可能很短,但最终只会在模块首次加载时看到一次日志。
ReportsTab 模块已加载不要把所有更新都变成 Transition
Transition 适合导航、标签切换、昂贵结果区域等“可以稍后完成”的更新。输入框受控值、按钮按下反馈等直接交互应保持紧急更新,否则用户会感觉输入跟不上操作。
startTransition 也不是定时器。传入的函数会立即执行,只是其中同步发起的状态更新被标记为 Transition;如果状态更新发生在之后的 setTimeout 回调里,需要在那个回调内重新调用 startTransition 才会获得相同语义。
设计加载体验的边界
Suspense 边界应该对应用户感知到的加载阶段,而不是机械地包住每个组件。页面首次进入时可以显示骨架或占位;已经展示过的页面在 Transition 更新期间,更适合保留旧内容并给出顶部进度、按钮 pending 状态等轻量反馈。
如果一个新页面内部还有更慢的独立区域,可以再放更内层的 Suspense,让外层页面先稳定出现、局部内容随后补齐。这样加载边界、更新优先级与用户看到的界面层级保持一致,异步体验会比“每次更新都整页闪成 loading”自然得多。