React / 系统课时
创建加载状态
创建加载状态
当 App Router 页面需要等待数据或服务器组件渲染时,用户不该只看到一次无反馈的停顿。本节用 loading.tsx 为单个路由段建立即时加载界面,并验证它如何与布局、页面和流式渲染配合。
学习目标
- 在正确的路由目录创建
loading.tsx,为异步页面提供回退界面 - 理解加载界面、共享
layout.tsx与目标页面之间的作用范围 - 能用最小示例验证加载状态是否真正出现,而不是只渲染静态占位
建立一个会等待的路由
下面创建 /reports 页面,并人为等待 1.5 秒模拟慢数据源。真实项目应把等待替换为数据库查询或 fetch,不要保留测试延迟。
app/reports/page.tsx:
export default async function ReportsPage() {
await new Promise((resolve) => setTimeout(resolve, 1500))
return (
<main>
<h1>销售报表</h1>
<p>本月已完成 128 笔订单。</p>
</main>
)
}在同一目录加入加载文件。loading.tsx 不接收参数,默认可以保持为 Server Component;Next.js 会把它作为该路由段的 Suspense 回退界面。:contentReference[oaicite:0]{index=0}
app/reports/loading.tsx:
export default function Loading() {
return (
<main role="status" aria-live="polite">
<h1>销售报表</h1>
<p>正在加载报表数据...</p>
</main>
)
}预期结果
访问 /reports 后,先看到“正在加载报表数据...”
约 1.5 秒后,加载界面被“本月已完成 128 笔订单。”替换实际等待时长会受机器性能、缓存和网络环境影响。
看懂路由段里的切换关系
loading.tsx 与目标 page.tsx 放在同一路由段时,Next.js 会在它们之间建立 Suspense 边界;共享布局仍可保持可见和可交互,目标内容准备完成后再替换加载界面。导航本身也可以被中断,不必等当前目标页面全部完成后才能改去其他路由。:contentReference[oaicite:1]{index=1}

这也是 loading.tsx 与普通“组件内显示一个 spinner”最重要的区别:它是文件系统级约定,作用在整个路由段;如果只想等待页面中的某一小块内容,应把 <Suspense> 放到更靠近那块异步组件的位置。
验证时避免两个误判
开发环境里如果数据已经很快返回,加载状态可能一闪而过;测试时可以暂时保留短延迟,确认切换路径后再删除。另一个常见误判是把慢操作放进同一段的 layout.tsx:当前文档说明,布局自身若访问未缓存或运行时数据,它不会自动回退到该段的 loading.tsx,这类等待更适合下沉到页面或单独的 Suspense 边界。:contentReference[oaicite:2]{index=2}
加载界面的目标不是展示越多越好,而是尽快告诉用户“导航已经生效”。因此优先保留稳定骨架、标题和少量状态提示,避免在 loading.tsx 中再发起昂贵请求或复制整页业务逻辑。