react路由v6版本NavLink的两个小坑
react 路由React Router(v6)
安装react-router
一级路由
重定向
NavLink高亮
useRoutes路由表----嵌套路由
路由的params参数
路由的search参数
路由的state参数
编程式路由导航
react路由v6版本NavLink的两个小坑本人新人,是按照文档进行学习的,今遇到两个小坑,现记录如下:
第一点,当前版本的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-routeryarn 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值。
以上为个人经验,希望能给大家一个参考,也希望大家多多支持软件开发网。