react路由v6版本NavLink的两个小坑及解决
目录
- 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-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值。
以上为个人经验,希望能给大家一个参考,也希望大家多多支持我们。