react路由v6版本NavLink的两个小坑及解决

2022-10-20 411阅读

温馨提示:这篇文章已超过525天没有更新,请注意相关的内容是否还可用!

本人新人,是按照文档进行学习的,今遇到两个小坑,现记录如下:

第一点,当前版本的NavLink的style或者className当中的isActive,不需要你对isActive进行任何操作,基本上照官网抄就可以了,会自动对isActive属性进行切换。在我看到相关文章中,好像在之前的版本中习惯使用内部的state对isActive进行true到false的转换。

当然,以上只是一个小问题,最重要的是第二点

第二点,NavLink现在的重点确实放在了nav上,按照我的实验,只有当NavLink组件放在用作“顶层导航”的时候,才能正常工作,也就是才能正常显示出你所配置的active的样式。以下是一段伪代码,用来解释什么是“顶层导航”

//nav是顶层的路由组件
function Nav () {
  return (
    <>
      <main>
        <h2>欢迎来到Nav模块</h2>
        <p>该模块是导航模块,用来测试相关功能</p>
      </main>
      <nav>
        {/* 通向Counter组件 */}
        <NavLink className={({ isActive }) => isActive ? "green" : "red"} to="/counter">Counter组件</NavLink>
        <br />
        {/* 通往路由测试页面 */}
        <NavLink className={({ isActive }) => isActive ? "green" : "red"} to='/routerTest'>routerTest</NavLink>
      </nav>
      {/* 下面是子组件的呈现地区,实际上就是vue的router-view */}
      <Outlet />
    </>
  );
}

以上是第一层级的组件,分别通向Counter和路由测试组件,这里面的NavLink就是第一层级的link导航,是能够正常工作的,能调动green的样式接下来再看Nav组件的“路由导航子组件”

function RouterTest () {
    const params1 = '参数一号准备就绪'
    const params2 = '参数二号准备就绪'
    
    return (
        <>
            <h1>欢迎来到RouterTest模块</h1>
            {/* 第一个普通link*/}
            <Link to={`/routerTest/${params1}`}>ShowParams</Link>
            <br />
            {/* 第二个测试用的NavLink,这个因为是第二层级的Link,是不会激发active样式的 */}
            <NavLink
                // className={({ isActive }) => isActive ? "active" : "notActive"}
                to={`/routerTest/${params2}`} >
                NavLink1
            </NavLink>
            {/* 因为有子路由,所以我们这边还得放一个Outlet */}
            <Outlet />
        </>
    )
 
}

RouterTests是一个子组件,里面的NavLink不是用来导航的顶层Link,所以不能调动active类的样式,所以不能正常工作。

以上是我的实验所得,本人初学,可能有错误理解,不过在我的实验之中确实呈现的是这个结果

以下是一个官网给的解决办法,实际上是通过对Link组件的包装实现的,代码如下:

import React from "react";
import { Link, useSearchParams } from "react-router-dom"
// 写一个外部数据
let brands = [{ id: 1, text: 'adidas' }, { id: 2, text: 'puma' }, { id: 3, text: 'nike' }]
export default function FilterLink () {
    let brandList = brands.map((brand) => (
        <li key={brand.id}>
            <BrandLink brand={brand.text}>{brand.text}</BrandLink>
        </li>
    ))
    return (
        <>
            <h1>欢迎来到FilterLink</h1>
            <p>该界面用来测试使用普通link组件传递active参数</p>
            <nav>
                <ul>
                    {brandList}
                </ul>
            </nav>
        </>
    )
}
// 定义一下高阶组件BrandLink
function BrandLink ({ brand, children, ...props }) {
    let [searchParams] = useSearchParams()
    let isActive = searchParams.get("brand") === brand;
    return (
        <Link to={`/page1/filterLink/?brand=${brand}`}
            {...props}
            style={{
                ...props.style,
                color: isActive ? "red" : "black",
            }}>{children}</Link>
    )
}

这个方法的原理就是在连接上带上搜索参数,然后用搜索参数和传入的brand值进行全等比较,然后激活样式。

所以说官网上细节还是挺全面的,常看常新,目前v6版本的路由官网好像还没有翻译,所以说英语也是要学滴。

react 路由React Router(v6)

安装react-router

yarn install --save react-router

index.js

import React from 'react'
import ReactDOM from 'react-dom'
import {BrowserRouter} from 'react-router-dom'
import App from './App'
ReactDOM.render(
    <BrowserRouter>
        <App/>
    </BrowserRouter>,
    document.getElementById('root')
)

一级路由

<Routes/> 与 <Route/>

v6版本中移出了先前的<Switch>,引入了新的替代者:<Routes>。

<Routes> 和 <Route>要配合使用,且必须要用<Routes>包裹<Route>。

<Route> 相当于一个 if 语句,如果其路径与当前 URL 匹配,则呈现其对应的组件。

<Route caseSensitive> 属性用于指定:匹配时是否区分大小写(默认为 false)。

当URL发生变化时,<Routes> 都会查看其所有子 <Route> 元素以找到最佳匹配并呈现组件 。

<Route> 也可以嵌套使用,且可配合useRoutes()配置 “路由表” ,但需要通过 <Outlet> 组件来渲染其子路由。

import React from 'react'
import {NavLink,Routes,Route} from 'react-router-dom'
import About from './pages/About'
import Home from './pages/Home'
export default function App() {
    return (
        <div>
            <div className="row">
                <div className="col-xs-2 col-xs-offset-2">
                    <div className="list-group">
                        {/* 路由链接 */}
                        <NavLink className="list-group-item" to="/about">About</NavLink>
                        <NavLink className="list-group-item" to="/home">Home</NavLink>
                    </div>
                </div>
                <div className="col-xs-6">
                    <div className="panel">
                        <div className="panel-body">
                            {/* 注册路由 */}
                            <Routes>
                                <Route path="/about" element={<About/>}/>
                                <Route path="/home" element={<Home/>}/>
                            </Routes>
                        </div>
                    </div>
                </div>
            </div>
        </div>
    )
}

重定向

  • <Navigate>

作用:只要<Navigate>组件被渲染,就会修改路径,切换视图。

replace属性用于控制跳转模式(push 或 replace,默认是push)。

import React from 'react'
import {NavLink,Routes,Route,Navigate} from 'react-router-dom'
import About from './pages/About'
import Home from './pages/Home'
export default function App() {
    return (
        <div>
            <div className="row">
                <div className="col-xs-2 col-xs-offset-2">
                    <div className="list-group">
                        {/* 路由链接 */}
                        <NavLink className="list-group-item" to="/about">About</NavLink>
                        <NavLink className="list-group-item" to="/home">Home</NavLink>
                    </div>
                </div>
                <div className="col-xs-6">
                    <div className="panel">
                        <div className="panel-body">
                            {/* 注册路由 */}
                            <Routes>
                                <Route path="/ABOUT" element={<About/>}/>
                                <Route path="/home" element={<Home/>}/>
                                <Route path="/" element={<Navigate to="/about"/>}/>
                            </Routes>
                        </div>
                    </div>
                </div>
            </div>
        </div>
    )
}
-----------------------
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 === 2 ? <Navigate to="/about" replace={true}/> : <h4>当前sum的值是:{sum}</h4>}
            <button onClick={()=>setSum(2)}>点我将sum变为2</button>
        </div>
    )
}

NavLink高亮

  • <NavLink>

作用: 与<Link>组件类似,且可实现导航的“高亮”效果。

示例代码:

// 注意: NavLink默认类名是active,下面是指定自定义的class
//自定义样式
<NavLink
    to="login"
    className={({ isActive }) => {
        console.log('home', isActive)
        return isActive ? 'base one' : 'base'
    }}
>login</NavLink>
/*
    默认情况下,当Home的子组件匹配成功,Home的导航也会高亮,
    当NavLink上添加了end属性后,若Home的子组件匹配成功,则Home的导航没有高亮效果。
*/
<NavLink to="home" end >home</NavLink>
import React from 'react'
import {NavLink,Routes,Route,Navigate} from 'react-router-dom'
import About from './pages/About'
import Home from './pages/Home'
export default function App() {
    function computedClassName({isActive}){
        return isActive ? 'list-group-item atguigu' : 'list-group-item'
    }
    return (
        <div>
            <div className="row">
                <div className="col-xs-2 col-xs-offset-2">
                    <div className="list-group">
                        {/* 路由链接 */}
                        <NavLink className={computedClassName} to="/about">About</NavLink>
                        <NavLink className={computedClassName} to="/home">Home</NavLink>
                    </div>
                </div>
                <div className="col-xs-6">
                    <div className="panel">
                        <div className="panel-body">
                            {/* 注册路由 */}
                            <Routes>
                                <Route path="/ABOUT" element={<About/>}/>
                                <Route path="/home" element={<Home/>}/>
                                <Route path="/" element={<Navigate to="/about"/>}/>
                            </Routes>
                        </div>
                    </div>
                </div>
            </div>
        </div>
    )
}

useRoutes路由表----嵌套路由

  • useRoutes()

作用:根据路由表,动态创建<Routes>和<Route>。

<Outlet>----渲染任何匹配的子级

当<Route>产生嵌套时,渲染其对应的后续子路由。

routers/index.js

export default [
    {
        path:'/about',
        element:<About/>
    },
    {
        path:'/home',
        element:<Home/>,
        children:[
            {
                path:'news',
                element:<News/>
            },
            {
                path:'message',
                element:<Message/>
            }
        ]
    },
    {
        path:'/',
        element:<Navigate to="/about"/>
    }
]
---
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>
            <div className="row">
                <div className="col-xs-2 col-xs-offset-2">
                    <div className="list-group">
                        {/* 路由链接 */}
                        <NavLink className="list-group-item" to="/about">About</NavLink>
                        <NavLink className="list-group-item" to="/home">Home</NavLink>
                    </div>
                </div>
                <div className="col-xs-6">
                    <div className="panel">
                        <div className="panel-body">
                            {/* 注册路由 */}
                            {element}
                        </div>
                    </div>
                </div>
            </div>
        </div>
    )
}
---
import React from 'react'
import {NavLink,Outlet} from 'react-router-dom'
export default function Home() {
    return (
        <div>
            <h2>Home组件内容</h2>
            <div>
                <ul className="nav nav-tabs">
                    <li>
                        <NavLink className="list-group-item" to="news">News</NavLink>
                    </li>
                    <li>
                        <NavLink className="list-group-item" to="message">Message</NavLink>
                    </li>
                </ul>
                {/* 指定路由组件呈现的位置 */}
                <Outlet />
            </div>
        </div>
    )
}

路由的params参数

  • useParams()

作用:返回当前匹配路由的params参数,类似于5.x中的match.params。

import React,{useState} from 'react'
import {Link,Outlet} from 'react-router-dom'
export default function Message() {
    const [messages] = useState([
        {id:'001',title:'消息1',content:'锄禾日当午'},
        {id:'002',title:'消息2',content:'汗滴禾下土'},
        {id:'003',title:'消息3',content:'谁知盘中餐'},
        {id:'004',title:'消息4',content:'粒粒皆辛苦'}
    ])
    return (
        <div>
            <ul>
                {
                    messages.map((m)=>{
                        return (
                            // 路由链接
                            <li key={m.id}>
                                <Link to={`detail/${m.id}/${m.title}/${m.content}`}>{m.title}</Link>
                            </li>
                        )
                    })
                }
            </ul>
            <hr />
            {/* 指定路由组件的展示位置 */}
            <Outlet />
        </div>
    )
}
----
import React from 'react'
import {useParams,useMatch} from 'react-router-dom'
export default function Detail() {
    const {id,title,content} = useParams()
    // const x = useMatch('/home/message/detail/:id/:title/:content')
    // console.log(x)
    return (
        <ul>
            <li>消息编号:{id}</li>
            <li>消息标题:{title}</li>
            <li>消息内容:{content}</li>
        </ul>
    )
}
----
export default [
    {
        path:'/about',
        element:<About/>
    },
    {
        path:'/home',
        element:<Home/>,
        children:[
            {
                path:'news',
                element:<News/>
            },
            {
                path:'message',
                element:<Message/>,
                children:[
                    {
                        path:'detail/:id/:title/:content',
                        element:<Detail/>
                    }
                ]
            }
        ]
    },
    {
        path:'/',
        element:<Navigate to="/about"/>
    }
]

路由的search参数

  • useSearchParams()

作用:用于读取和修改当前位置的 URL 中的查询字符串。

返回一个包含两个值的数组,内容分别为:当前的seaech参数、更新search的函数。

  • useLocation()

作用:获取当前 location 信息,对标5.x中的路由组件的location属性。

export default [
    {
        path:'/about',
        element:<About/>
    },
    {
        path:'/home',
        element:<Home/>,
        children:[
            {
                path:'news',
                element:<News/>
            },
            {
                path:'message',
                element:<Message/>,
                children:[
                    {
                        path:'detail',
                        element:<Detail/>
                    }
                ]
            }
        ]
    },
    {
        path:'/',
        element:<Navigate to="/about"/>
    }
]
----
import React,{useState} from 'react'
import {Link,Outlet} from 'react-router-dom'
export default function Message() {
    const [messages] = useState([
        {id:'001',title:'消息1',content:'锄禾日当午'},
        {id:'002',title:'消息2',content:'汗滴禾下土'},
        {id:'003',title:'消息3',content:'谁知盘中餐'},
        {id:'004',title:'消息4',content:'粒粒皆辛苦'}
    ])
    return (
        <div>
            <ul>
                {
                    messages.map((m)=>{
                        return (
                            // 路由链接
                            <li key={m.id}>
                                <Link to={`detail?id=${m.id}&title=${m.title}&content=${m.content}`}>{m.title}</Link>
                            </li>
                        )
                    })
                }
            </ul>
            <hr />
            {/* 指定路由组件的展示位置 */}
            <Outlet />
        </div>
    )
}
----
import React from 'react'
import {useSearchParams,useLocation} from 'react-router-dom'
export default function Detail() {
    const [search,setSearch] = useSearchParams()
    const id = search.get('id')
    const title = search.get('title')
    const content = search.get('content')
    const x = useLocation()
    console.log('@',x)
    return (
        <ul>
            <li>
                <button onClick={()=>setSearch('id=008&title=哈哈&content=嘻嘻')}>点我更新一下收到的search参数</button>
            </li>
            <li>消息编号:{id}</li>
            <li>消息标题:{title}</li>
            <li>消息内容:{content}</li>
        </ul>
    )
}

路由的state参数

  • useLocation()

作用:获取当前 location 信息,对标5.x中的路由组件的location属性。

export default function Message() {
    const [messages] = useState([
        {id:'001',title:'消息1',content:'锄禾日当午'},
        {id:'002',title:'消息2',content:'汗滴禾下土'},
        {id:'003',title:'消息3',content:'谁知盘中餐'},
        {id:'004',title:'消息4',content:'粒粒皆辛苦'}
    ])
    return (
        <div>
            <ul>
                {
                    messages.map((m)=>{
                        return (
                            // 路由链接
                            <li key={m.id}>
                                <Link 
                                    to="detail" 
                                    state={{
                                        id:m.id,
                                        title:m.title,
                                        content:m.content,
                                    }}
                                >{m.title}</Link>
                            </li>
                        )
                    })
                }
            </ul>
            <hr />
            {/* 指定路由组件的展示位置 */}
            <Outlet />
        </div>
    )
}
----
import React from 'react'
import {useLocation} from 'react-router-dom'
export default function Detail() {
    const {state:{id,title,content}} = useLocation()
    return (
        <ul>
            <li>消息编号:{id}</li>
            <li>消息标题:{title}</li>
            <li>消息内容:{content}</li>
        </ul>
    )
}

编程式路由导航

  • useNavigate()

作用:返回一个函数用来实现编程式导航。

示例代码:

import React from 'react'
import {useNavigate} from 'react-router-dom'
export default function Demo() {
  const navigate = useNavigate()
  const handle = () => {
    //第一种使用方式:指定具体的路径
    navigate('/login', {
      replace: false,
      state: {a:1, b:2}
    }) 
    //第二种使用方式:传入数值进行前进或后退,类似于5.x中的 history.go()方法
    navigate(-1)
  }
  
  return (
    <div>
      <button onClick={handle}>按钮</button>
    </div>
  )
}
  • useMatch()

作用:返回当前匹配信息,对标5.x中的路由组件的match属性。

  • useInRouterContext()

作用:如果组件在 <Router> 的上下文中呈现,则 useInRouterContext 钩子返回 true,否则返回 false。

  • useNavigationType()

作用:返回当前的导航类型(用户是如何来到当前页面的)。

返回值:POP、PUSH、REPLACE。

备注:POP是指在浏览器中直接打开了这个路由组件(刷新页面)。

  • useOutlet()

作用:用来呈现当前组件中渲染的嵌 套路由。

示例代码:

const result = useOutlet()
console.log(result)
// 如果嵌套路由没有挂载,则result为null
// 如果嵌套路由已经挂载,则展示嵌套的路由对象
  • useResolvedPath()

作用:给定一个 URL值,解析其中的:path、search、hash值。