> 文章列表 > React Router v6详解

React Router v6详解

React Router v6详解

旧版本React Router使用方式

  • BrowserRouter:通过 history 库,传递 history 对象,location 对象
  • Switch:匹配唯一的路由 Route,展示正确的路由组件
  • Route:视图承载容器,控制渲染 UI 组件

新版本React Router使用方式

新版本特点

  • 提供了useNagivate实现路由跳转
  • 新版本移除了<Switch>组件,新增<Routes>,旧版本的Route可以独立使用,新版本的Route必须和Routes配合使用
  • 语法的变化:component={About} 变为 element={}
  • 新增多个hook:useParams、useNavigate、useMatch
  • 新版本引入Outlet占位功能,可以更方便的配置路由结构

组件使用说明

1 <BrowserRouter>

<BrowserRouter>用于包裹整个应用,在路由的最外层,示例代码:

import React from "react";
import ReactDOM from "react-dom";
import { BrowserRouter } from "react-router-dom";ReactDOM.render(<BrowserRouter>{/* 整体结构(通常为App组件) */}</BrowserRouter>,root
);

说明:BrowserRouter和HashRouter都可以实现前端路由的功能,HashRouter在路径中包含了#,相当于HTML的锚点定位。而BrowserRouter使用的是HTML5的新特性History,没有HashRouter(锚点定位)那样通用,低版本浏览器可能不支持。

2 <HashRouter>

作用与<BrowserRouter>一样,但<HashRouter>修改的是地址栏的hash值。

3 <Routes /><Route />

  • V6版本移除了<Switch>,使用<Routes>代替,<Routes><Route>要配合使用:用<Routes>包裹<Route>
  • 当URL发生变化时,<Routes>都会查看其所有子<Route> 元素以找到最佳匹配并呈现组件 。
  • <Route> 也可以嵌套使用,且可配合useRoutes()配置 “路由表” ,但需要通过 <Outlet> 组件来渲染其子路由。

举个栗子:

<Routes><Route path="/login" element={<Login />}></Route>// 嵌套路由,home是一级路由<Route path="/home" element={<Home />}><Route path="test1" element={<Test/>}></Route><Route path="test2" element={<Test2/>}></Route></Route>//Route也可以不写element属性, 这时就是用于展示嵌套的路由 .所对应的路径是/users/xxx<Route path="users"><Route path="xxx" element={<Demo />} /></Route>
</Routes>

4 <Link><NavLink>

<Link>的作用是修改URL,且不发送网络请求。<NavLink>的作用类似,不过被点击的<NavLink>的css样式会自动添加active类,用于实现导航栏高亮效果。示例代码:

import { Link, NavLink } from "react-router-dom";function Menu() {return (<div><Link to="/home">首页</Link><NavLink to="/about">关于</NavLink></div>);
}

注意:<Link>的外侧需要用<BrowserRouter><HashRouter>包裹。

5 <Navigate>

只要<Navigate>组件被渲染,就会修改路径,切换视图。示例代码:

import React,{useState} from 'react'
import {Navigate} from 'react-router-dom'export default function Home() {const [sum,setSum] = useState(1)return (<div><h3>我是Home的内容</h3>{/* 根据sum的值决定是否切换视图 */}{sum === 1 ? <h4>sum的值为{sum}</h4> : <Navigate to="/about" replace={true}/>}<button onClick={()=>setSum(2)}>点我将sum变为2</button></div>)
}

6 <Outlet>

<Route>产生嵌套时,渲染其对应的后续子路由,类似Vue中的<router-view></router-view>

Hooks使用说明

1 useRoutes()

作用是根据路由表动态生成<Routes><Route>,该钩子函数的参数是JSON形式的路由配置数据(见下面的示例),返回的内容类等价于一个<Routes>, 上示例代码:

//路由表配置:src/routes/index.js
import About from '../pages/About'
import Home from '../pages/Home'
import {Navigate} from 'react-router-dom'export default [{path:'/',element:<Navigate to="/home"/>},{path:'/home',element:<Home/>},{path:'/about',element:<About/>}
]//App.jsx
import React from 'react'
import { NavLink,useRoutes } from 'react-router-dom'
import routes from './routes'export default function App() {//根据路由表生成对应的路由规则const element = useRoutes(routes)return (<div>{element}</div>)
}

说明:如果使用了useRoutes(),仍需要在最外层使用<HashRouter><BrowserRouter>包裹。

2 useNavigate()

作用是返回一个函数用来实现编程式导航(使用js/ts代码控制导航)。示例代码:

import React from 'react'
import { useNavigate } from 'react-router-dom'export default function Demo() {const navigate = useNavigate()const handleClick = () => {navigate('/home'); }return (<div><button onClick={handleClick}>按钮</button></div>)
}

Routers使用说明

1 createBrowserRouter

这个函数用于创建<BrowserRouter>,输入Array类型的路由配置数据。

import * as React from "react";
import * as ReactDOM from "react-dom";
import {createBrowserRouter,RouterProvider,
} from "react-router-dom";import Root, { rootLoader } from "./routes/root";
import Team, { teamLoader } from "./routes/team";const router = createBrowserRouter([{path: "/",element: <Root />,loader: rootLoader,children: [{path: "team",element: <Team />,loader: teamLoader,},],},
]);ReactDOM.createRoot(document.getElementById("root")).render(<RouterProvider router={router} />
);

说明:这个函数需要配合<RouterProvider>使用,具体使用方式见上例。