React / 系统课时

创建加载状态

创建加载状态

当 App Router 页面需要等待数据或服务器组件渲染时,用户不该只看到一次无反馈的停顿。本节用 loading.tsx 为单个路由段建立即时加载界面,并验证它如何与布局、页面和流式渲染配合。

学习目标

  • 在正确的路由目录创建 loading.tsx,为异步页面提供回退界面
  • 理解加载界面、共享 layout.tsx 与目标页面之间的作用范围
  • 能用最小示例验证加载状态是否真正出现,而不是只渲染静态占位

建立一个会等待的路由

下面创建 /reports 页面,并人为等待 1.5 秒模拟慢数据源。真实项目应把等待替换为数据库查询或 fetch,不要保留测试延迟。

app/reports/page.tsx:

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:

tsx
export default function Loading() {
  return (
    <main role="status" aria-live="polite">
      <h1>销售报表</h1>
      <p>正在加载报表数据...</p>
    </main>
  )
}

预期结果

text
访问 /reports 后,先看到“正在加载报表数据...”
约 1.5 秒后,加载界面被“本月已完成 128 笔订单。”替换

实际等待时长会受机器性能、缓存和网络环境影响。

看懂路由段里的切换关系

loading.tsx 与目标 page.tsx 放在同一路由段时,Next.js 会在它们之间建立 Suspense 边界;共享布局仍可保持可见和可交互,目标内容准备完成后再替换加载界面。导航本身也可以被中断,不必等当前目标页面全部完成后才能改去其他路由。:contentReference[oaicite:1]{index=1}

loading.tsx 在路由段中的切换流程

这也是 loading.tsx 与普通“组件内显示一个 spinner”最重要的区别:它是文件系统级约定,作用在整个路由段;如果只想等待页面中的某一小块内容,应把 <Suspense> 放到更靠近那块异步组件的位置。

验证时避免两个误判

开发环境里如果数据已经很快返回,加载状态可能一闪而过;测试时可以暂时保留短延迟,确认切换路径后再删除。另一个常见误判是把慢操作放进同一段的 layout.tsx:当前文档说明,布局自身若访问未缓存或运行时数据,它不会自动回退到该段的 loading.tsx,这类等待更适合下沉到页面或单独的 Suspense 边界。:contentReference[oaicite:2]{index=2}

加载界面的目标不是展示越多越好,而是尽快告诉用户“导航已经生效”。因此优先保留稳定骨架、标题和少量状态提示,避免在 loading.tsx 中再发起昂贵请求或复制整页业务逻辑。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建加载状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通