react-router v6新特性总结

由于之前的项目一直使用的是V5版本，最新新建项目的时候，默认使用的是V6版本，根据官方的介绍，V6版本的新特性如下。

新特性

• <Switch>重命名为<Routes>；
• <Route>的新特性变更；
• 嵌套路由变得更简单；
• 新钩子useRoutes代替react-router-config；
• 用useNavigate代替useHistory；
• Link不再支持component 属性；
• NavLink的exact属性替换为end
• 大小减少：从20kb到8kb

<Switch>重命名为<Routes>

在V6版本中，<Switch>组件被替换成<Routes>组件，同时，component属性被element属性替换。

/* v5 */
<Switch>
  <Route exact path="/" component={Home} />
  <Route path="/user/:id" render={(routeProps) => <User id={routeProps.match.params.id} />} />
</Switch>

/* V6 */
<Routes>
  <Route path="/" element={<Home />} />
  <Route path="user/:id" element={<User id={id} />} />
</Routes>

同时，组件还修改了如下一些内容：

• 废弃exact
• component/render被element替代
• routeProps可以在element中直接获取
• 简化的路径匹配，仅支持动态:id样式参数和*通配符，不再支持RegExp

支持嵌套路由

在V6版本中， <Route>标签支持嵌套，可以在一个文件内配置嵌套路由，便于统一管理路由。

import { HashRouter as Router, Routes, Route } from 'react-router-dom'
import Home from '@/pages/demo/Home'
import Foo from '@/pages/demo/Foo'
import Bar from '@/pages/demo/Bar'
import BarDetail from '@/pages/demo/BarDetail'
import '@/assets/style/App.css'
function App() {
 return (
   <Router>
     <Routes>
       <Route path="/" element={<Home />} />
       <Route path="foo" element={<Foo />} />
       {/* 嵌套路由场景：需要在Bar（父路由的组件）声明Outlet组件，用于渲染子路由 */}
       <Route path="bar" element={<Bar />}>
         <Route path=":id" element={<BarDetail />} />
       </Route>
     </Routes>
   </Router>
 )
}
export default App

Outlet

在嵌套路由场景，我们需要在父路由中使用Outlet组件，用于渲染子路由。

import { Outlet } from 'react-router-dom'
function Bar() {
  return (
    <div>
      <div>Bar</div>
      {/* 有嵌套路由的场景需要使用 */}
      <Outlet />
    </div>
  )
}
export default Bar

嵌套路由可配置化

在V6版本中，我们可以使用useRoutes代替react-router-config配置。如果需要用到嵌套路由，那么Outlet组件也是必要的。

import { useRoutes } from 'react-router-dom'
import Home from '@/pages/demo/Home'
import Foo from '@/pages/demo/Foo'
import Bar from '@/pages/demo/Bar'
import BarDetail from '@/pages/demo/BarDetail'
import '@/assets/style/App.css'
function App() {
  let element = useRoutes([
    {
      path: '/',
      element: <Home />
    },
    {
      path: 'foo',
      element: <Foo />
    },
    {
      path: 'bar',
      element: <Bar />,
      children: [
        {
          path: ':id',
          element: <BarDetail />
        }
      ]
    }
  ])
  return element
}
export default App

需要注意的是，如果是使用此方式注册路由配置，需要在入口文件添加Router包裹App组件，否则会报错。

import React from 'react'
import ReactDOM from 'react-dom'
import { HashRouter as Router } from 'react-router-dom'
import App from '@/App'
import '@/assets/style/index.css'
ReactDOM.render(
  <React.StrictMode>
    <Router>
      <App />
    </Router>
  </React.StrictMode>,
  document.getElementById('root')
)

useNavigate代替useHistory

/* v5 */
const history = useHistory()
history.push('/home')
history.replace('/home')
history.goBack()
history.goForward()
history.go(2)
/* V6 */
const navigate = useNavigate()
navigate('/home')
navigate('/home', {replace: true})
navigate(-1)
navigate(1)
navigate(2)

路由穿参

路由传参主要有三种方式：params、search和state。

1，useParams

useParams的路由格式为： /home/12

<Routes>
    <Route path="/" element={<Admin />} >
        <Route path="home" element={<Home />} >
            <Route path=":id" element={<HomeSon />} />
        </Route>
    </Route>
</Routes>

// HomeSon页面，读取参数
import React from 'react';
import { useParams } from 'react-router-dom';

const HomeSon = () => {
    // id 就是传过来的参数 id就是12
    let { id } = useParams();
    return (
        <div>
            这是HomeSon页面 {id}
        </div>
    )
}
export default HomeSon;

2， useSearchParam

useSearchParam的路由格式为： /home?id=1。

<Routes>
    <Route path="/" element={<Admin />} >
        <Route path="user" element={<User />} ></Route>
    </Route>
</Routes>

<NavLink to="/user?id=1" style={({ isActive }) =>
              isActive ? activeStyle : undefined
          }>
User</NavLink>

// User页面
import React from 'react';
import { useSearchParams } from 'react-router-dom';

const User = () => {
    let [searchParams] = useSearchParams();
    const id = searchParams.get('id'); // id为参数值
    return (
        <div>这是user页面</div>
    )
}

export default User;

3，state

state在地址栏看不见参数，使用useLocation方法获取参数。

扫描二维码关注公众号，回复： 14555972 查看本文章

// state定义id为1
<div
  style={
   
   {
      borderBottom: "solid 1px",
      paddingBottom: "1rem"
  }}
>
  <NavLink to='/state' state={
   
   { id: 1  }}>State</NavLink>
</div>

// state页面
import { useLocation } from 'react-router-dom';

const State = () => {
    const {state} = useLocation();
    console.log(state); // { id: 1 }
    return (
        <div style={
   
   { display: "flex" }}>
            <div>这是State组件</div>
            <div>
                {state}
            </div>
        </div>
    );
}
export default State;

路由懒加载

有时候，我们需要对路由进行懒加载，需要使用lazy关键字。

import * as React from 'react';
import { Routes, Route, Outlet, Link } from 'react-router-dom';

const About = React.lazy(() => import('./pages/About'));

参考说明：https://reactrouterdotcom.fly.dev/