React / 系统课时
配置基础路由
配置基础路由
本课将把一个只有单页面入口的 React 应用改造成多页面应用:安装路由库、定义地址与组件的映射,并验证浏览器访问不同路径时能渲染正确页面。
学习目标
- 使用
BrowserRouter为应用启用客户端路由 - 使用
Routes和Route定义基础路由表 - 识别未匹配地址并显示兜底页面
安装路由依赖
React 本身负责组件渲染,不负责根据 URL 切换页面。项目需要安装 react-router-dom,再把路由能力接入应用入口。
bash
npm install react-router-dom预期结果
text
added <COUNT> packages<COUNT> 会随项目已有依赖和包管理器版本变化。安装后可在 package.json 的 dependencies 中看到 react-router-dom。
在应用入口启用路由
BrowserRouter 监听浏览器地址变化,并把当前路径提供给内部组件。它通常只在应用入口挂载一次。
jsx
// src/main.jsx
import { StrictMode } from "react";
import { createRoot } from "react-dom/client";
import { BrowserRouter } from "react-router-dom";
import App from "./App.jsx";
createRoot(document.getElementById("root")).render(
<StrictMode>
<BrowserRouter>
<App />
</BrowserRouter>
</StrictMode>,
);这段入口代码生效后,App 及其后代组件都可以使用 React Router 提供的组件和 Hook。
定义路由表
下面的示例把 /、/about 和 /products 分别映射到三个页面组件,并使用 * 捕获所有未匹配地址。
jsx
// src/App.jsx
import { Route, Routes } from "react-router-dom";
function HomePage() {
return <h2>首页</h2>;
}
function AboutPage() {
return <h2>关于我们</h2>;
}
function ProductsPage() {
return <h2>商品列表</h2>;
}
function NotFoundPage() {
return <h2>404:页面不存在</h2>;
}
export default function App() {
return (
<main>
<h1>示例商城</h1>
<Routes>
<Route path="/" element={<HomePage />} />
<Route path="/about" element={<AboutPage />} />
<Route path="/products" element={<ProductsPage />} />
<Route path="*" element={<NotFoundPage />} />
</Routes>
</main>
);
}预期结果
text
访问 / 显示:首页
访问 /about 显示:关于我们
访问 /products 显示:商品列表
访问 /unknown 显示:404:页面不存在Routes 会在其直接子路由中选择与当前地址最匹配的一项,不会把所有 Route 同时渲染。element 接收的是 JSX 元素,因此要写成 <HomePage />,而不是只传组件名。
启动并验证
启动开发服务器后,分别在浏览器地址栏输入几个路径进行验证。
bash
npm run dev预期结果
text
Local: http://localhost:<PORT>/<PORT> 是开发服务器实际分配的端口。刷新 /about 等非首页地址时,如果生产服务器返回 404,需要把服务器配置为将未知前端路径回退到 index.html,再由 React Router 完成匹配。
按自己的节奏,确认真正理解。