React / 系统课时

配置应用路由

配置应用路由

本课将为 React 应用建立可运行的页面路由,覆盖首页、商品列表、商品详情和管理页。完成后,地址栏路径、导航链接与页面组件会形成清晰映射,并支持详情页参数和未匹配地址处理。

学习目标

  • 安装并接入 react-router-dom,让路由成为应用入口
  • 使用嵌套路由组织公共布局与四类页面
  • 通过动态参数读取详情页 ID,并验证导航结果

安装并规划路由

在现有 React 18 与 TypeScript 项目根目录执行:

bash
npm install react-router-dom

预期结果

text
added <COUNT> packages

<COUNT> 会随锁文件和本地缓存变化。命令成功退出后,可在 package.json 的 dependencies 中看到 react-router-dom。

路径与页面关系

本例使用一个根布局承载导航栏和 <Outlet />。首页使用 /,列表页使用 /products,详情页使用 /products/:productId,管理页使用 /admin,最后用 * 接收未知地址。

应用路由与页面映射关系

这套结构把公共框架放在父路由,把具体页面放在子路由。切换子页面时,导航栏保持不变,只有 <Outlet /> 所在区域更新。

编写完整路由入口

将下面内容写入 src/main.tsx。示例把页面组件放在同一文件中,便于直接运行;真实项目可再拆分到 pages 和 layouts 目录。

tsx
import { StrictMode } from "react";
import { createRoot } from "react-dom/client";
import {
  Link,
  NavLink,
  Outlet,
  RouterProvider,
  createBrowserRouter,
  useParams,
} from "react-router-dom";

const products = [
  { id: "101", name: "机械键盘" },
  { id: "102", name: "无线鼠标" },
];

function RootLayout() {
  return (
    <>
      <header>
        <nav>
          <NavLink to="/">首页</NavLink>{" | "}
          <NavLink to="/products">商品列表</NavLink>{" | "}
          <NavLink to="/admin">管理页</NavLink>
        </nav>
      </header>
      <main>
        {/* 子路由组件会渲染到 Outlet 所在位置 */}
        <Outlet />
      </main>
    </>
  );
}

function HomePage() {
  return <h1>首页</h1>;
}

function ProductListPage() {
  return (
    <>
      <h1>商品列表</h1>
      <ul>
        {products.map((product) => (
          <li key={product.id}>
            <Link to={`/products/${product.id}`}>{product.name}</Link>
          </li>
        ))}
      </ul>
    </>
  );
}

function ProductDetailPage() {
  const { productId } = useParams();
  const product = products.find((item) => item.id === productId);

  if (!product) {
    return <p>商品不存在</p>;
  }

  return (
    <>
      <h1>商品详情</h1>
      <p>
        {product.name},编号:{product.id}
      </p>
    </>
  );
}

function AdminPage() {
  return <h1>管理页面</h1>;
}

function NotFoundPage() {
  return <h1>页面不存在</h1>;
}

const router = createBrowserRouter([
  {
    path: "/",
    element: <RootLayout />,
    children: [
      { index: true, element: <HomePage /> },
      { path: "products", element: <ProductListPage /> },
      { path: "products/:productId", element: <ProductDetailPage /> },
      { path: "admin", element: <AdminPage /> },
      { path: "*", element: <NotFoundPage /> },
    ],
  },
]);

const rootElement = document.getElementById("root");

if (!rootElement) {
  throw new Error("找不到 #root 挂载节点");
}

createRoot(rootElement).render(
  <StrictMode>
    <RouterProvider router={router} />
  </StrictMode>,
);

预期结果

text
访问 / 显示“首页”
访问 /products 显示两条商品链接
点击“机械键盘”后进入 /products/101,并显示商品编号 101
访问 /admin 显示“管理页面”
访问 /unknown 显示“页面不存在”

运行与验收

执行项目已有的开发命令:

bash
npm run dev

预期输出

text
Local: http://localhost:<PORT>/

<PORT> 由开发服务器决定,实际值可能不同。打开该地址后依次点击导航和商品链接,再直接修改地址栏路径,确认五种路由结果都符合预期。

部署到静态服务器时,浏览器直接访问 /products/101 会先请求服务器。服务器需要把未命中的前端路径回退到 index.html,否则刷新详情页可能返回 404;这属于部署配置,不是 React Router 本身的匹配错误。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置应用路由

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

登录哪都通