其他章节请看：
七天接手react项目 系列
react 路由
本篇首先讲解路由原理，接着以一个基础路由示例为起点讲述路由最基础的知识，然后讲解嵌套路由、路由传参，最后讲解路由组件和一般组件的区别，以及编程式导航。
Tip：我们要接手的 react 项目是：spug_web。
什么是路由
路由就是根据不同的 url（网址） 返回不同的页面（数据）。如果这个工作在后端做（或者说由后端程序员做），就是后端路由；在前端做就是前端路由。
平时总说的 SPA（单页面应用）就是前后端分离的基础上，再加一层前端路由。
react 路由原理
下面通过一个js 库（history）来演示一下路由的原理：
请在浏览器控制台下体验！
访问页面，浏览器 url 为 http://127.0.0.1:5500/public/test.html
Tip：笔者在 vscode 中安装 “open in browser” 插件，直接右键选择 “Open with Live Server” 即可。
打开控制台进行测试：
> myHistory.push('/home')
PUSH /home
url 变为：http://127.0.0.1:5500/home
> myHistory.push('/about')
PUSH /about
url 变成：http://127.0.0.1:5500/about
> myHistory.back()
POP /home
url 变成：http://127.0.0.1:5500/home
> myHistory.replace('about')
REPLACE /about
url 变成：http://127.0.0.1:5500/about
> myHistory.back()
POP /public/test.html
url 变成：http://127.0.0.1:5500/public/test.html
这个流程其实就是 react 路由的基础。
hash模式：
> hashHistory.push('/home')
PUSH /home
url 变为：http://127.0.0.1:5500/public/test.html#/home
Version 5 is used in React Router version 6 —— history
Tip：react router 用到了这个包，另外这个包的作者和 react-router、react-router-dom 是同一人。
路由模式
react 中有三种模式，本篇主要研究 history 和 hash 两种模式。
官网-history：
- “browser history” - 在特定 DOM 上的实现，使用于支持 HTML5 history API 的 web 浏览器中
- “hash history” - 在特定 DOM 上的实现，使用于旧版本的 web 浏览器中
- “memory history” - 在内存中的 history 实现，使用于测试或者非 DOM 环境中，例如 React Native
环境准备
笔者使用的环境是 react 脚手架创建的项目。
Tip：详细介绍请看 react 脚手架创建项目
打开 react-router 官网。
Tip：react 有三个版本，我们学习 web 版本 5。印记中文（深入挖掘国外前端新领域,为中国 Web 前端开发...）有 react-router 中文。
基础使用
安装 react 路由依赖包：
react-cli-demo> npm i react-router-dom@5
added 13 packages, and audited 1421 packages in 6s
169 packages are looking for funding
run `npm fund` for details
6 moderate severity vulnerabilities
To address all issues (including breaking changes), run:
npm audit fix --force
Run `npm audit` for details.
注：版本是5，倘若是版本 6，下面的代码运行会报错。
将 App.js 替换成下面代码：
// src/App.js
import React from "react";
import {
BrowserRouter as Router,
Switch,
Route,
Link
} from "react-router-dom";
export default function BasicExample() {
return (
-
Home
-
About
-
Dashboard
);
}
// Home 组件
function Home() {
return (
Home
);
}
// About 组件
function About() {
return (
About
);
}
// Dashboard 组件
function Dashboard() {
return (
Dashboard
);
}
重启服务器，页面显示：
· Home
· About
· Dashboard
________________________________
Home
注：本篇为了演示，所以将多个组件都放在一个文件中。
整个页面分上下两部分，上面是导航区，下面是内容区。
倘若点击导航“About”，内容区显示 About，浏览器 url 也会变化：
http://localhost:3000/
变成
http://localhost:3000/about
当我们点击 About，则会匹配上
Tip：Link、exact、
Link 和 NavLink
About 会被渲染成 About，即使点击 About 导航，渲染的内容依旧不变。
一个特殊版本的 Link，当它与当前 URL 匹配时，为其渲染元素添加样式属性 —— 官网-
将 About 导航改成 NavLink：
About
初始时（即未选中）依旧渲染成 About，但点击 About 导航后，渲染内容变成：
About
所以我们可以给 .active 增加选中效果。
如果要修改默认选中时的 active 类名，可以使用 activeClassName 属性。就像这样:
About
封装 NavLink
- 版本1
function MyNavLink(props) {
return {props.children}
}
使用：
- 升级版
function MyNavLink(props) {
return 当 React 元素为用户自定义组件时，它会将 JSX 所接收的属性（attributes）以及子组件（children）转换为单个对象传递给组件，这个对象被称之为 “props” —— react 官网
Router
使用 HTML5 历史 API 记录（ pushState，replaceState 和 popstate 事件）的 BrowserRouter
假如将 BasicExample 组件中的
Uncaught Error: Invariant failed: You should not use outside a
未捕获的错误：不变式失败：您不应该在 之外使用
倘若将
Uncaught Error: Invariant failed: You should not use outside a
未捕获的错误：不变量失败：您不应该在 之外使用
倘若将
Uncaught Error: Invariant failed: You should not use outside a
未捕获的错误：不变式失败：您不应在 之外使用
倘若我们在 BasicExample 组件中使用两个
export default function BasicExample() {
return (
-
Home
...
...
);
}
浏览器没有任何报错，点击导航“About”，url正常变化，但内容区没有跟着变。
Router 即路由器，Route 即线路，线路由路由器管理，上面用了两个路由器，你管你的，我管我的，相互间没有通信。
在 spug_web 中搜索
// spug_web/src/index.js
ReactDOM.render(
document.fullscreenElement || document.body}>
,
document.getElementById('root')
)
我们也依葫芦画瓢，将
Switch
js 语法中就有 switch，类似于 if...else。我们对比有无 Switch 的两种情况：
点击 About 导航，请问内容区显示什么？
// 没有 Switch
export default function BasicExample() {
return (
-
About
...
...
);
}
内容区显示：
About
1
About
2
// 有 Switch
export default function BasicExample() {
return (
-
About
...
...
);
}
内容区显示：
About
1
渲染与该地址匹配的第一个子节点
Tip：既然只匹配第一个子节点，那么性能方面肯定会好些，因为不用在尝试匹配后面的节点。
如果 URL 是 /about ，那么
// from 官网
exact
exact 即精确的。首先做一个小练习：
点击导航 About，下面两个例子分别输出什么，是否匹配？
export default function BasicExample() {
return (
-
About
);
}
export default function BasicExample() {
return (
-
About
);
}
第一个例子：内容区空白。未能匹配
第二个例子：内容区显示”About“。匹配。
下面这段代码呢？
export default function BasicExample() {
return (
-
About
);
}
内容区空白。未能匹配。
总结：Link 可以多给，比如你要 /about，我给你传 /about/a，但不能少给，而且顺序不能乱，例如 /a/about/b 就不能匹配 /about
我们给第二个例子加上 exact，请问输出什么？
export default function BasicExample() {
return (
-
About
);
}
内容区空白。未能匹配。
如果为 true，则只有在路径完全匹配 location.pathname 时才匹配 —— 官网-exact: bool
注：只有需要的时候才开启精确匹配，也就是说页面正常，就不要去开启它。
Redirect
渲染
下面我们用
首先看下面这个例子：
export default function BasicExample() {
return (
-
About
-
Dashboard
);
}
第一次来到网站（http://localhost:3000/），内容区是空白的，因为未能匹配任何
现在需求：进入网站，默认显示
只需要增加 2 行代码：
import {
+ Redirect,
...
} from "react-router-dom";
export default function BasicExample() {
return (
...
+
);
}
浏览器输入 http://localhost:3000/，由于前两个 http://localhost:3000/dashboard。
replace
如果为 true，则单击链接将替换历史堆栈中的当前入口，而不是添加新入口 —— 官网-replace: bool
上面 BasicExample 组件，倘若我们依次点击 About 组件、Dashboard 组件，接着点击网页左上角的返回（<-）按钮，第一次会返回到 About 组件，再次点击则会返回到 Home 组件。
如果我们给 Dashboard 组件加上 replace 属性。就像这样：
-
Home
-
About
-
Dashboard
依次点击 About 组件、Dashboard 组件，然后第一次点击返回按钮，则回到 Home 组件。
因为点击 Dashboard 导航时，不再是入栈操作（将 /dashboard 压入栈中），而是替换操作（将栈中的 /about 替换成 /dashboard），再次点击返回，就回到 /。
样式丢失问题
通过一个示例演示问题：
首先在 index.html 增加样式：
// public/index.html
+
// public/css/index.css
body{background-color: pink;}
修改 BasicExample 组件中 About 导航的路径为多级路径（/about 非多级路径；/about/a 多级路径）：
// src/App.js
export default function BasicExample() {
return (
-
Home
-
About
);
}
开始测试：
启动，http://localhost:3000/ 背景是粉色，样式正常，点击 ”About“导航，url 变成 http://localhost:3000/about/a/b，背景依旧是粉色，刷新页面，粉色背景不见了，也就是样式丢失了！
刷新的时候，发现样式请求的地址和返回内容如下：
http://localhost:3000/about/a/css/index.css
React App
注：请求不存在的资源，服务器会将 public/index.html 返回给你。例如请求：http://localhost:3000/a/b/c/d
我们放慢刷新这个动作：
- 刷新，给服务器发送
http://localhost:3000/about/a/b，没有这个资源，所以服务器返回 index.html。 - 浏览器解析 index.html，遇到
，需要加载当前目录下的css/index.css资源，当前目录是http://localhost:3000/about/a，于是请求http://localhost:3000/about/a/css/index.css - 由于存在对应资源，服务器再次返回 index.html，样式也就丢失了
既然知道问题原因，只需要让 css 资源路径正常即可：
将
改成
或
嵌套路由
嵌套路由也叫子路由。
将 BasicExample 组件中的 About 改造成嵌套路由。
首先看效果：
初始时 Home 导航选中：
· Home
· About
· Dashboard
________________________________
Home
点击 About 导航：
· Home
· About
· Dashboard
________________________________
About
________________________________
· article1
· article2
点击 article2 导航，显示：
· Home
· About
· Dashboard
________________________________
About
________________________________
· article1
· article2
文章2...
嵌套路由相关代码如下：
// About 组件
function About() {
return (
// 新增一个路由器 Router
About
-
article1
-
article2
文章1...
文章2...
);
}
路由组件 vs 一般组件
路由组件和一般组件最大的一个区别是：props 中是否有路由相关方法。
这里有三个组件，请观察每个组件的 props：
// src/App.js
import React from "react";
import {
Switch,
Route,
Link
} from "react-router-dom";
export default function BasicExample() {
return (
-
About
-
Dashboard
);
}
// Home 组件
function Header(props) {
console.log('Header props,', props)
return (
Header
);
}
// About 组件
function About(props) {
console.log('About props,', props)
return (
About
);
}
// Dashboard 组件
function Dashboard(props) {
console.log('Dashboard props,', props)
return (
Dashboard
);
}
初始 url 为：http://localhost:3000/，控制台输出：Header props, {}
点击 Dashboard 导航，控制台输出：Dashboard props, {name: 'pjl'}
点击 About 导航，控制台输出：
About props, {history: {…}, location: {…}, match: {…}, staticContext: undefined}
三个组件只有 About 组件是路由组件，其用法不同于另外两种组件：
// 通过 component 属性指定组件
Tip：路由组件中的 history、location、match 属性，下文都会讲到。
pages/components 目录
有人说路由组件和一般组件从项目结构上可以区分，比如将路由组件放在 src/pages 文件夹中，一般组件放在 src/components 中。
spug_web 中有 src/pages 和 src/components 目录，是否就是根据一般组件和路由组件进行区分？请看截取的代码片段：
首先是 src/routes.js，猜测与路由相关：
// src/routes.js
import HomeIndex from './pages/home';
import DashboardIndex from './pages/dashboard';
import HostIndex from './pages/host';
import ExecTask from './pages/exec/task';
import ExecTemplate from './pages/exec/template';
import DeployApp from './pages/deploy/app';
import DeployRepository from './pages/deploy/repository';
import DeployRequest from './pages/deploy/request';
import ScheduleIndex from './pages/schedule';
import ConfigEnvironment from './pages/config/environment';
import ConfigService from './pages/config/service';
import ConfigApp from './pages/config/app';
import ConfigSetting from './pages/config/setting';
import MonitorIndex from './pages/monitor';
import AlarmIndex from './pages/alarm/alarm';
import AlarmGroup from './pages/alarm/group';
import AlarmContact from './pages/alarm/contact';
import SystemAccount from './pages/system/account';
import SystemRole from './pages/system/role';
import SystemSetting from './pages/system/setting';
import WelcomeIndex from './pages/welcome/index';
import WelcomeInfo from './pages/welcome/info';
引入的都是 pages 中的组件。
src/routes.js 又被 src\layout\index.js 引用：
// src/layout/index.js
import routes from '../routes';
// initRoutes 的实参 routes 就是上面导入的 routes
function initRoutes(Routes, routes) {
for (let route of routes) {
if (route.component) {
if (!route.auth || hasPermission(route.auth)) {
// 通过 component 属性指定组件
Routes.push()
}
} else if (route.child) {
initRoutes(Routes, route.child)
}
}
}
...
至此，初步判断：spug_web 中的 pages 目录和 components 目录就是根据一般组件和路由组件进行区分的。
给路由组件传递参数
给路由组件传递参数有三种方式。
下面通过这三种方式实现同一个功能：给路由组件 About 传递 name 和 age 两个参数。
params 方式
export default function BasicExample() {
return (
-
About
);
}
// About 组件
function About(props) {
// {history: {…}, location: {…}, match: {…}, staticContext: undefined}
console.log(props)
// {name: 'pjl', age: '18'}
console.log(props.match.params)
return (
About
);
}
点击 About 导航组件，控制台输出：
{history: {…}, location: {…}, match: {…}, staticContext: undefined}
// 接收两个参数
{name: 'pjl', age: '18'}
一个 match 对象中包涵了有关如何匹配 URL 的信息 —— 官网-match
search 方式
以 search 方式重写 params 传递参数的例子：
export default function BasicExample() {
return (
-
About
);
}
// About 组件
function About(props) {
// ?name=pjl&age=18
console.log(props.location.search)
var searchParams = new URLSearchParams(props.location.search)
const params = {}
for (const [key, value] of searchParams) {
params[key] = value
}
// params: {name: 'pjl', age: '18'}
console.log('params: ', params);
return (
About
);
}
需要自己将接收到的数据（例如 ?name=pjl&age=18）处理一下。
Tip：params 和 search 传参，在地址栏中都能看见。例如 search：http://localhost:3000/about/?name=pjl&age=18。刷新页面参数都不会丢失。
state 方式
注：与组件中的 state 没有任何关系
export default function BasicExample() {
return (
-
About
);
}
// About 组件
function About(props) {
// {name: 'pjl', age: 18}
console.log(props.location.state)
return (
About
);
}
有两个特点：
- 所传参数不会再 url 中体现。比如这里仍然是
http://localhost:3000/about - 强制刷新 url，所传参数也不会消失。
- 笔者尝试关闭浏览器，再次输出
http://localhost:3000/about，控制台输出undefined
- 笔者尝试关闭浏览器，再次输出
Tip：props.location === props.history.location 为 true
HashRouter 刷新会导致 state 参数丢失
HashRouter 模式下，刷新（非强刷）页面会造成 state 参数的丢失。
将 App.js 中的 BrowserRouter 切换成 HashRouter 进行自测即可。
编程式导航 history
比如过3秒需要自动跳转，这时就可以使用编程式导航。用法类似 History API。不过这里我们操作的是 props.history。
运行下面这个熟悉的例子，将会把 props.history 导出给 window.aHistory，我们直接在控制台中操作 aHistory：
// src/App.js
export default function BasicExample() {
return (
-
Home
-
About
-
Dashboard
);
}
// Home 组件
function Home(props) {
// 将 history 导出，用于测试
window.aHistory = props.history
return (
Home
);
}
// About 组件
function About() {
return (
About
);
}
// Dashboard 组件
function Dashboard() {
return (
Dashboard
);
}
浏览器 url 是 http://localhost:3000/，页面内容如下：
· Home
· About
· Dashboard
________________________________
Home
测试开始：
> aHistory.push('/about')
url：http://localhost:3000/about
> aHistory.push('/dashboard')
url: http://localhost:3000/dashboard
> aHistory.goBack()
url: http://localhost:3000/about
// 等于 aHistory.goBack()
> aHistory.go(-1)
url: http://localhost:3000/
一般组件中使用编程式导航
一般组件中没有 history，如果需要使用编程式导航，可以借助 withRouter 将一般组件处理一下即可。请看示例：
import React from "react";
import {
Switch,
Route,
withRouter,
Link
} from "react-router-dom";
export default function BasicExample() {
return (
-
About
-
NewAbout
);
}
// About 组件
function About(props) {
console.log(props)
return (
About
);
}
var NewAbout = withRouter(About)
页面显示：
About
NewAbout
________________________________
依次点击 About 导航、NewAbout 导航，控制台输出：
{}
{history: {…}, location: {…}, match: {…}, staticContext: undefined}
其他章节请看：
七天接手react项目 系列