本人新人,是按照文档进行学习的,今遇到两个小坑,现记录如下:
第一点,当前版本的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 //自定义样式 <NavLinkto="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值。