React / 系统课时

嵌套路由与布局

嵌套路由与布局

当多个页面共享导航栏、侧边栏或页头时,把公共结构复制到每个页面会迅速失控。嵌套路由把“公共布局”和“变化的子页面”分开,由父路由保留布局,再通过 Outlet 渲染当前匹配的子路由。

学习目标

  • 使用父子路由表达页面层级与共享布局
  • 理解 Outlet 在父布局中的渲染位置
  • 区分索引子路由与带相对路径的普通子路由

先确定布局边界

假设后台区域有 /dashboard 与 /dashboard/settings 两个页面。它们都需要同一组导航,只是主体内容不同。最合适的结构不是创建两个几乎相同的页面组件,而是让 /dashboard 成为父路由,让布局组件只负责公共 UI。

父路由匹配后会先渲染布局组件;随后路由器继续匹配它的子路由,并把子页面渲染到布局中的 Outlet 位置。这样 URL 层级、组件层级和视觉布局保持一致。

嵌套路由与 Outlet 布局关系

用父路由承载公共布局

以下示例可直接放入已安装 react-router-dom 的 React 项目 src/main.jsx。父路由的 element 是 DashboardLayout,子路由只定义变化的主体内容。

jsx
import React from "react";
import { createRoot } from "react-dom/client";
import {
  BrowserRouter,
  NavLink,
  Outlet,
  Route,
  Routes,
} from "react-router-dom";

function DashboardLayout() {
  return (
    <section>
      <header>
        <h1>控制台</h1>
        <nav>
          <NavLink to="/dashboard">概览</NavLink>
          {" | "}
          <NavLink to="/dashboard/settings">设置</NavLink>
        </nav>
      </header>
      <main>
        {/* 当前匹配的子路由会渲染在这里。 */}
        <Outlet />
      </main>
    </section>
  );
}

function Overview() {
  return <p>这里是概览页面。</p>;
}

function Settings() {
  return <p>这里是设置页面。</p>;
}

function App() {
  return (
    <Routes>
      <Route path="/dashboard" element={<DashboardLayout />}>
        <Route index element={<Overview />} />
        <Route path="settings" element={<Settings />} />
      </Route>
    </Routes>
  );
}

createRoot(document.getElementById("root")).render(
  <BrowserRouter>
    <App />
  </BrowserRouter>
);

预期结果

text
访问 /dashboard:显示“控制台”与公共导航,主体区域显示“这里是概览页面。”
访问 /dashboard/settings:公共布局保持不变,主体区域改为“这里是设置页面。”
点击两个导航链接时只替换 Outlet 中的子页面内容。

看懂 index 与相对路径

<Route index ... /> 表示父路由被完整匹配、且没有更深子路径时使用的默认子页面,所以它对应 /dashboard。索引路由没有自己的 path,不能再写成 path="" 来代替它。

子路由的 path="settings" 是相对路径,会自动拼接父路由的 /dashboard,最终匹配 /dashboard/settings。在父子结构中优先使用相对路径,可以避免父路径改名后还要同步修改多处硬编码。

Outlet 缺失时为什么页面不见了

子路由是否匹配,与它是否有地方渲染是两回事。如果 DashboardLayout 中删除 <Outlet />,访问 /dashboard/settings 时父路由仍然匹配,但 Settings 没有挂载位置,用户只会看到公共布局。

嵌套路由的判断标准很简单:只要一组页面在 URL 上有稳定的父级,并且视觉上共享一块长期不变的布局,就值得让父路由负责这层结构,把真正变化的内容交给子路由与 Outlet。

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

目录与阅读设置

阅读设置

17

记录一个想法

嵌套路由与布局

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

登录哪都通