React / 系统课时

使用布局组件

使用布局组件

layout.tsx 用来让一组 App Router 页面共享稳定的页面外壳。本节会建立根布局和业务布局,让全站页头、页脚以及业务导航自动包裹对应页面,而不在每个 page.tsx 中重复编写。

学习目标

  • 理解根布局与嵌套布局的作用范围和组合方式
  • 能使用 children 将具体页面插入公共页面结构
  • 能判断导航、页头和页脚应该放在哪一级布局中

布局如何包裹后代页面

layout.tsx 对所在路由段以及它的后代生效。页面渲染时,Next.js 会从外到内组合匹配到的布局,最后再把当前 page.tsx 作为最内层内容传入 children。

根目录中的 app/layout.tsx 是整个应用的根布局,并且必须提供 <html> 与 <body>。如果 app/dashboard/layout.tsx 也存在,那么 /dashboard 及其后代会同时经过根布局和 dashboard 布局。

根布局与嵌套布局的组合关系

创建根布局和业务布局

下面是一个完整的布局组合示例。各代码段分别保存到标出的文件中,它们共同组成一个可运行的 App Router 页面。

tsx
// app/layout.tsx
import type { ReactNode } from "react";

export default function RootLayout({ children }: { children: ReactNode }) {
  return (
    <html lang="zh-CN">
      <body>
        <header>Next.js 管理平台</header>
        {children}
        <footer>© Example</footer>
      </body>
    </html>
  );
}

预期结果:所有 App Router 页面都会位于“Next.js 管理平台”页头和全站页脚之间,根布局不会只限制在 /dashboard 下。

tsx
// app/dashboard/layout.tsx
import type { ReactNode } from "react";
import Link from "next/link";

export default function DashboardLayout({ children }: { children: ReactNode }) {
  return (
    <section>
      <nav>
        <Link href="/dashboard">概览</Link>{" | "}
        <Link href="/dashboard/settings">设置</Link>
      </nav>
      <main>{children}</main>
    </section>
  );
}

预期结果:只有 /dashboard 及其后代路由会额外显示“概览”和“设置”导航,站点其他路由不会受到这个业务布局影响。

tsx
// app/dashboard/page.tsx
export default function DashboardPage() {
  return <h1>控制台概览</h1>;
}

预期结果:访问 /dashboard 时,页面从外到内依次显示全站页头、Dashboard 导航、“控制台概览”以及全站页脚。

决定公共结构应该放在哪一级

布局的位置决定共享范围。全站都需要的 Logo、全局页脚或基础样式适合放在根布局;只属于管理后台的侧栏、导航和工具栏则应该放在 app/dashboard/layout.tsx 这类业务段布局中。

如果把后台导航直接放进根布局,它会错误地出现在登录页、营销页等无关页面。反过来,如果每个 dashboard 页面都重复实现同一套导航,又会增加修改成本,并容易产生结构不一致。

避免在页面中重复布局职责

page.tsx 应聚焦当前 URL 的具体内容,而 layout.tsx 负责多个页面共同拥有的稳定结构。判断标准很简单:某块界面如果随着子页面切换仍应持续存在,就优先考虑放入它们最近的共同布局。

布局可以继续嵌套,因此大型应用不需要一个巨大的全局布局承担所有职责。将共享结构放在最合适的路由层级,既能减少重复代码,也能让目录本身准确表达页面之间的从属关系。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用布局组件

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

登录哪都通