一、React路由简介
React 官方并没有提供对应的路由插件,因此,我们需要下载第三方的路由插件 —— React Router DOM。
React Router 在 2021 年 11 月份的时候更新 v6 的版本。本次课就主要讲解V6版本
二、路由配置
1、下载路由
在项目根目录中,通过以下命令
yarn add react-router-dom
2、路由配置
1)首先在react项目的入口文件index.js文件中,使用<BrowserRouter>
将<App>
包裹起来
import {BrowserRouter} from 'react-router-dom'
const root = ReactDOM.createRoot(document.getElementById('root'));
root.render(<BrowserRouter><App /></BrowserRouter>
);
BrowserRouter
:包裹这个应用,一个React应用只需使用一次
在 React Router 中提供了两种路由模式:hash 和 history。
对应的的路由组件分别是:
-
HashRouter:hash 模式的路由
-
BrowserRouter:history 模式的路由
实际使用时,任选其中一个模式引入即可
2)其次,在App.js文件中,使用<Routes>
设置路由出口,使用<Route>
指定导航链接
import React from 'react'
import {Routes,Route} from 'react-router-dom'
import Login from './pages/Login'
import Register from './pages/Register'
import Home from './pages/Home'
export default function App() {return (<Routes><Route path='/login' element={<Login/>}></Route><Route path='/register' element={<Register/>}></Route><Route path='/' element={<Home/>}></Route></Routes>)
}
核心组件作用说明
-
Routes
:提供一个路由出口,满足条件的路由组件会渲染到组件内部 -
Route
: 用于指定导航链接,完成路由跳转-
path
:path属性指定匹配的路径地址 -
element
element属性指定要渲染的组件
-
三、路由跳转
React Router 中,路由的跳转分为两种方式:
-
标签(组件)跳转
-
JS(API)跳转
1、通过Link组件跳转
import React from 'react'
import {Link} from 'react-router-dom'
export default function Login() {return (<div><h1>用户登录</h1><Link to="/register">没有账号,去注册</Link></div>)
}
2、编程式路由跳转
实现步骤
-
导入useNavigate钩子函数
import {useNavigate} from 'react-router-dom'
-
执行钩子函数得到跳转函数
let navigate=useNavigate();
-
执行跳转函数完成跳转
import React from 'react'
import {useNavigate} from 'react-router-dom'
export default function Register() {const navigate=useNavigate()const register=(e)=>{e.preventDefault()navigate('/login')}return (<div><h1>用户注册</h1><a href="#" onClick={(e)=>{register(e)}}>已注册,去登录</a></div>)
}
注意
-
如果在跳转时不想加历史记录,可以添加额外参数replace为true
const register=(e)=>{e.preventDefault()navigate('/login',{replace:true})}
四、嵌套路由
1、基础配置
实现步骤
-
定义嵌套路由声明
<Routes><Route path='/login' element={<Login/>}></Route><Route path='/register' element={<Register/>}></Route><Route path='/' element={<Home/>}><Route path='category' element={<Category/>}></Route><Route path='goods' element={<Goods/>}></Route></Route></Routes>
-
设置二级路由出口
export default function Home() {return (<><aside><ul><li><NavLink to="/categroy">分类管理</NavLink></li><li><NavLink to="/goods">商品管理</NavLink></li></ul></aside><section>{/* 二级路由出口 */}<Outlet></Outlet></section></>)
}
2、默认二级路由设置
<Routes><Route path='/login' element={<Login/>}></Route><Route path='/register' element={<Register/>}></Route><Route path='/' element={<Home/>}>{/*默认二级路由,添加index属性,删除掉path属性*/}<Route index element={<Main/>}></Route><Route path='category' element={<Category/>}></Route><Route path='goods' element={<Goods/>}></Route></Route>
</Routes>
3、404页配置
应用场景:当所有的路径都没有匹配的时候显示
语法说明:在各级路由的最后添加*
号路由作为兜底
<Routes><Route path='/login' element={<Login/>}></Route><Route path='/register' element={<Register/>}></Route><Route path='/' element={<Home/>}>{/*默认二级路由,添加index属性,删除掉path属性*/}<Route index element={<Main/>}></Route><Route path='category' element={<Category/>}></Route><Route path='goods' element={<Goods/>}></Route></Route>{/*当所有路径都没有匹配时渲染此路由*/}<Route path='*' element={<NotFound/>}></Route>
</Routes>
五、路由模式
BrowserRouter模式部署在Nginx服务器上出现404问题的解决办法
1、React打包
-
在index.js的
<BrowserRouter>
上添加basename属性,比如
<BrowserRouter basename='/crem'><App></App> </BrowserRouter>
-
在package.json中添加
"homepage": "."
{"homepage": "."
}
-
在终端上执行打包命令
yarn build
2、Nginx上部署
-
打包后会产生一个build文件夹,然后将该文件改名为crem,
-
上传文件的linux服务器的/opt目录下
-
在/etc/nginx/conf.d/default.conf下添加如下配置
location /crem {alias /opt/crem;index index.html;}
-
进入shell中执行如下命令
ps aux|grep nginx #查看nginx进程
killall -9 nginx #杀死nginx进程
/usr/sbin/nginx #启动nginx服务器
3、防止404的配置
-
修改/etc/nginx/conf.d/default.conf文件,添加如下配置即可
location /crem {alias /opt/crem;index index.html;try_files $uri /crem/index.html;}
六、路由传参
1、searchParams传参
实现步骤
-
传参
import {useNavigate} from 'react-router-dom'
export default function CategroyList() {let navigate=useNavigate();return (<div><h2>CategroyList</h2><button onClick={()=>{navigate('/categroyDetail?id=12')}}>详情</button></div>)
}
-
获取参数
import {useSearchParams} from 'react-router-dom'export default function CategoryDetail() {let [params]=useSearchParams()return (<div><h2>CategroyDetail</h2><div>ID:{params.get('id')}</div></div>)
}
2、params传参
实现步骤
-
路由设置
<BrowserRouter><Routes><Route path='/home' element={<Layout/>}><Route path='categroy-detail/:id' element={<CategoryDetail/>}></Route></Route></Routes></BrowserRouter>
-
传参
import {useNavigate} from 'react-router-dom'
export default function CategroyList() {let navigate=useNavigate();return (<div><h2>CategroyList</h2><button onClick={()=>{navigate('/home/categroy-detail/13')}}>详情</button></div>)
}
-
获取参数
import React from 'react'
import {useParams} from 'react-router-dom'export default function CategoryDetail() {let params=useParams()return (<div><h2>CategroyDetail</h2><div>ID:{params.id}</div></div>)
}
七、集中式路由渲染
实现步骤
-
在项目根目录创建router文件夹,并在该目录下创建index.jsx
-
在router/index.jsx编写路由配置项
import Login from '../pages/Login'
import Register from '../pages/Register'
import Home from '../pages/Home'
import CategoryList from '../pages/Category'
import CategoryDetail from '../pages/Category/Detail'
import GoodsList from '../pages/Goods'
import Main from '../pages/Home/Main'
export default [{path:'/login',element:<Login/>},{path:'/register',element:<Register/>},{path:'/',element:<Home/>,children:[{index:true,element:<Main/>},{path:'/categoryList',element:<CategoryList/>},{path:'/categoryDetail/:id',element:<CategoryDetail/>},{path:'/goodsList',element:<GoodsList/>}]}
]
-
在App.jsx中通过useRoutes钩子函数来进行集中式配置
import {useRoutes} from 'react-router-dom'
import router from './router/index'
function App() {return useRoutes(router)
}
export default App;
-
在项目根目录下的index.js中使用
<BrowserRouter>
包裹<App>
root.render(<BrowserRouter><App/></BrowserRouter>
)
八、路由懒加载
1、实现步骤
-
使用lazy(()=>import('xxx'))方式导入组件
import {lazy} from 'react'
const Login=lazy(()=>import('../pages/Login'))
const Register=lazy(()=>import('../pages/Register'))
const Home=lazy(()=>import('../pages/Home'))
const CategoryList=lazy(()=>import('../pages/Category'))
const CategoryDetail=lazy(()=>import('../pages/Category/Detail'))
const GoodsList=lazy(()=>import('../pages/Goods'))
const Main=lazy(()=>import('../pages/Home/Main'))
export default [{path:'/login',element:<Login/>},{path:'/register',element:<Register/>},{path:'/',element:<Home/>,children:[{index:true,element:<Main/>},{path:'/categoryList',element:<CategoryList/>},{path:'/categoryDetail/:id',element:<CategoryDetail/>},{path:'/goodsList',element:<GoodsList/>}]}
]
-
通过 React 中提供了
<Suspense>
组件,来实现路由的懒加载。
import {Suspense} from 'react'
function App() {return(<Suspense fallback={<>loading</>}>{useRoutes(router)}</Suspense>)
}
<Suspense>
组件身上,必须设置一个 fallback
属性,属性值可以是一个 HTML 标签,也可以是一个自定义的组件。用于当路由组件还未加载出来前的提示。
2、解决路由闪屏
配置完路由懒加载后出现当进行路由跳转时,出现闪屏现象,要向解决这个问题可以使用 react-loadable插件进行解决
-
先下载react-loadable依赖包
yarn add react-loadable
-
建立一个loadable.js,放在src/utils/loadable.js
import Loadable from 'react-loadable';
export default function withLoadable(comp) {return Loadable({//懒加载组件页面loader: comp,loading: () => null,delay: "",})
}
-
修改router/index.js
import loadable from '../utils/loadable'
const Login=loadable(()=>import('../pages/Login'))
const Register=loadable(()=>import('../pages/Register'))
const Home=loadable(()=>import('../pages/Home'))
const CategoryList=loadable(()=>import('../pages/Category'))
const CategoryDetail=loadable(()=>import('../pages/Category/Detail'))
const GoodsList=loadable(()=>import('../pages/Goods'))
const Main=loadable(()=>import('../pages/Home/Main'))
export default [{path:'/login',element:<Login/>},{path:'/register',element:<Register/>},{path:'/',element:<Home/>,children:[{index:true,element:<Main/>},{path:'/categoryList',element:<CategoryList/>},{path:'/categoryDetail/:id',element:<CategoryDetail/>},{path:'/goodsList',element:<GoodsList/>}]}
]