超超详细ReactRouter v6版本的基本使用
先附上官网的地址:react-router-v6 · GitHub Topics · GitHub
一.概述
React Router 以三个不同的包发布到 npm 上,它们分别为:
react-router: 路由的核心库,提供了很多的:组件、钩子。
react-router-dom: 包含react-router所有内容,并添加一些专门用于 DOM 的组件,例如
<BrowserRouter>
等 。react-router-native: 包括react-router所有内容,并添加一些专门用于ReactNative的API,例如:
<NativeRouter>
等。
与React Router 5.x 版本相比,改变了什么?
内置组件的变化:移除
<Switch/>
,新增<Routes/>
等。语法的变化:
component={About}
变为element={<About/>}
等。新增多个hook:
useParams
、useNavigate
、useMatch
等。官方明确推荐函数式组件了!!!
......
二.Component
1. <BrowserRouter>
说明:
<BrowserRouter>
用于包裹整个应用。
import React from "react";
import ReactDOM from "react-dom";
import { BrowserRouter } from "react-router-dom";ReactDOM.render(<BrowserRouter>{/* 整体结构(通常为App组件) */}</BrowserRouter>
);
2. <HashRouter>
说明:作用与
<BrowserRouter>
一样,但<HashRouter>
修改的是地址栏的hash值。备注:6.x版本中
<HashRouter>
、<BrowserRouter>
的用法与 5.x 相同。
3. <Routes/> 与 <Route/>
v6版本中移出了先前的
<Switch>
,引入了新的替代者:<Routes>
。<Routes>
和<Route>
要配合使用,且必须要用<Routes>
包裹<Route>
。<Route>
相当于一个 if 语句,如果其路径与当前 URL 匹配,则呈现其对应的组件。<Route caseSensitive>
属性用于指定:匹配时是否区分大小写(默认为 false)。当URL发生变化时,
<Routes>
都会查看其所有子<Route>
元素以找到最佳匹配并呈现组件 。<Route>
也可以嵌套使用,且可配合useRoutes()
配置 “路由表” ,但需要通过<Outlet>
组件来渲染其子路由。
<Routes>/*path属性用于定义路径,element属性用于定义当前路径所对应的组件*/<Route path="/login" element={<Login />}></Route>/*用于定义嵌套路由,home是一级路由,对应的路径/home*/<Route path="home" element={<Home />}>/*test1 和 test2 是二级路由,对应的路径是/home/test1 或 /home/test2*/<Route path="test1" element={<Test/>}></Route><Route path="test2" element={<Test2/>}></Route></Route>//Route也可以不写element属性, 这时就是用于展示嵌套的路由 .所对应的路径是/users/xxx<Route path="users"><Route path="xxx" element={<Demo />} /></Route>
</Routes>
4. <Link>
作用: 修改URL,且不发送网络请求(路由链接)。
注意: 外侧需要用
<BrowserRouter>
或<HashRouter>
包裹。v6版本不需要带父级路由路径
import { Link } from "react-router-dom";function Test() {return (<div><Link to="/路径">按钮</Link></div>);
}
5. <NavLink>
作用: 与
<Link>
组件类似,且可实现导航的“高亮”效果。v6版本不需要带父级路由路径 。
例如:v6版本中标题实现高亮:
* NavLink属性className接收一个函数,函数参数为对象,有个属性为isActive
* 如果isActive为true,意味被选中,可以自定义添加样式
// 注意: 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>
6. <Navigate>
作用:只要
<Navigate>
组件被渲染,就会修改路径,切换视图。replace
属性用于控制跳转模式(push 或 replace,默认是push)。
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的值决定是否切换视图 */}{sum === 1 ? <h4>sum的值为{sum}</h4> : <Navigate to="/about" replace={true}/>}<button onClick={()=>setSum(2)}>点我将sum变为2</button></div>)
}
7. <Outlet>
当
<Route>
产生嵌套时,渲染其对应的后续子路由。
//根据路由表生成对应的路由规则
const element = useRoutes([{path:'/about',element:<About/>},{path:'/home',element:<Home/>,children:[{path:'news',element:<News/>},{path:'message',element:<Message/>,}]}
])//Home.js
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>)
}
三.Hooks
1. useRoutes()
作用:使用useRoutes创建路由表,useRoutes接收数组生成路由表。根据路由表,动态创建
<Routes>
和<Route>
。
//路由表配置:src/routes/index.js
import About from '../pages/About'
import Home from '../pages/Home'
import {Navigate} from 'react-router-dom'export default [{path:'/about',element:<About/>},{path:'/home',element:<Home/>},{path:'/',element:<Navigate to="/about"/>}
]//App.jsx
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>......{/* 注册路由 */}{element}......</div>)
}
2. useNavigate()
作用:返回一个函数用来实现编程式导航。
Header为非路由组件,在v5版本通过withRouter()高阶函数包装成新的路由组件才能调用location,history和match的方法,但在v6版本中只需要调用useNaviage()这个hooks也可以实现跳转需求:
navigate(1) 为前进一步
navigate(-1) 为后退一步
通过useNavigate()返回的参数navigate是一个函数:
* 第一个参数为跳转的路径,第二个参数为option配置对象,目前只支持两个属性
* 如果携带params和search参数,只支持在第一个参数进行拼接
-params参数 `login/${a}/${b}`
-search参数 `login?a=${a}&b=${b}`
* 而携带state,直接在第二个参数进行配置即可
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>)
}
3. useParams()
作用:回当前匹配路由的
params
参数,类似于5.x中的match.params
。携带params参数,需要在定规则的时候进行占位
使用useParams获取父组件的数据
import React from 'react';
import { Routes, Route, useParams } from 'react-router-dom';
import User from './pages/User.jsx'function ProfilePage() {// 获取URL中携带过来的params参数let { id } = useParams();
}function App() {return (<Routes><Route path="users/:id" element={<User />}/></Routes>);
}
4. useSearchParams()
作用:用于读取和修改当前位置的 URL 中的查询字符串。
返回一个包含两个值的数组,内容分别为:当前的seaech参数、更新search的函数。
携带search参数,不需要在定规则的时候进行占位
使用useSearchParams获取父组件的数据
import React from 'react'
import {useSearchParams} 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')return (<ul><li><button onClick={()=>setSearch('id=008&title=哈哈&content=嘻嘻')}>点我更新一下收到的search参数</button></li><li>消息编号:{id}</li><li>消息标题:{title}</li><li>消息内容:{content}</li></ul>)
}
5. useLocation()
作用:获取当前 location 信息,对标5.x中的路由组件的
location
属性。使用state进行传参,对useLocation返回的对象进行解构赋值即可,同时不需要占位
import React from 'react'
import {useLocation} from 'react-router-dom'export default function Detail() {const x = useLocation()console.log('@',x)// x就是location对象: /*{hash: "",key: "ah9nv6sz",pathname: "/login",search: "?name=zs&age=18",state: {a: 1, b: 2}}*/return (<ul><li>消息编号:{id}</li><li>消息标题:{title}</li><li>消息内容:{content}</li></ul>)
}
6. useMatch()
作用:返回当前匹配信息,对标5.x中的路由组件的
match
属性。
<Route path="/login/:page/:pageSize" element={<Login />}/>
<NavLink to="/login/1/10">登录</NavLink>export default function Login() {const match = useMatch('/login/:x/:y')console.log(match) //输出match对象//match对象内容如下:/*{params: {x: '1', y: '10'}pathname: "/LoGin/1/10" pathnameBase: "/LoGin/1/10"pattern: {path: '/login/:x/:y', caseSensitive: false, end: false}}*/return (<div><h1>Login</h1></div>)
}
7. useInRouterContext()
- 作用:如果组件在
<Router>
的上下文中呈现,则useInRouterContext
钩子返回 true,否则返回 false。
ReactDOM.render(// App处于路由组件上下文中,而Demo组件没有处于上下文<div><Demo /><BrowserRouter ><App /></BrowserRouter></div>
, document.getElementById('root'))
8. useNavigationType()
作用:返回当前的导航类型(用户是如何来到当前页面的)。
返回值:
POP
、PUSH
、REPLACE
。备注:
POP
是指在浏览器中直接打开了这个路由组件(刷新页面)。
9. useOutlet()
作用:用来呈现当前组件中渲染的嵌套路由。
示例代码:
const result = useOutlet()
console.log(result)
// 如果嵌套路由没有挂载,则result为null
// 如果嵌套路由已经挂载,则展示嵌套的路由对象
10.useResolvedPath()
作用:给定一个 URL值,解析其中的:path、search、hash值。
console.log('useResolvedPath',useResolvedPath('/user?id=001&name=tom#qws'))//输出:{pathname: "/user", search: "?id=001&name=tom", hash: "#qws"}
超超详细ReactRouter v6版本的基本使用相关推荐
- react-router-middleware-plus开源啦 | 基于react-router v6的零成本式路由权限解决方案
一.你的苦恼~~ 你还在为react-router的路由权限控制而烦恼吗? 你还在翻遍了社区react路由权限相关文章发现都是V4.V5版本的而烦恼吗? 你还在为自行适配react-router v6 ...
- Android技能树 — 网络小结(6)之 OkHttp超超超超超超超详细解析
前言: 本文也做了一次标题党,哈哈,其实写的还是很水,各位原谅我O(∩_∩)O. 介于自己的网络方面知识烂的一塌糊涂,所以准备写相关网络的文章,但是考虑全部写在一篇太长了,所以分开写,希望大家能仔细看 ...
- ESP8266远程控制开关示例超全面详细(2021-10-18)
ESP8266远程控制开关示例超全面详细 1 背景描述 ESP8266模块是比较标准方便的wifi开发模块,把他当做为单片机,有输入输出引脚和操作指令.内存,就是一个计算机了.引脚收发接口可做串口通讯 ...
- react安装_超全面详细一条龙教程!从零搭建React项目全家桶(上篇)
React是近几年来前端项目开发非常火的一个框架,其背景是Facebook团队的技术支持,市场占有率也很高.很多初学者纠结一开始是学react还是vue.个人觉得,有时间的话,最好两个都掌握一下.从学 ...
- 【转】VScode快捷键(超无敌详细版)
转自:VScode快捷键(超无敌详细版)_但行好事,莫问前程-CSDN博客 通用快捷键: 快捷键 作用 Ctrl+Shift+P,F1 展示全局命令面板 Ctrl+P 快速打开最近打开的文件 Ctrl ...
- 传说之下打开debug模式超超超超超超超超详细方法
传说之下打开debug模式超超超超超超超超详细方法 相信传说之下debug模式大家都听说过吧简直是神一般的存在!可是很多小伙伴都不会开,但是什么百度知道啊,b站上的都不详细,看不懂,今天我来出一个超超 ...
- Python 实现按键精灵的功能,超简单详细(Windows版)
Python 实现按键精灵的功能,超简单详细 前言: 实现步骤 一.安装三个库 二.试运行简单的功能 三.根据需求自己写代码 注明 前言: 最近公司的同事让我帮他点点点,懒得亲自点,便在网上查找了相关 ...
- python做按键精灵脚本_Python 实现按键精灵的功能,超简单详细(MAC版)
前言: 想看Windows版的同窗能够看Python 实现按键精灵的功能,超简单详细(Windows版) 以前写了Windows版的python实现按键精灵功能.如今我鸟枪换炮换了个新的mac.发现以 ...
- 超超超超级详细的多边形游戏问题分析(动态规划)
多边形游戏 问题简介 问题分析 超详细解题步骤 Java代码实现 多边形游戏 问题简介 首先呢,介绍一下多边形游戏是个什么东东 多边形游戏是一个单人玩的游戏,开始时有一个由n个顶点构成的多边形.每个顶 ...
最新文章
- #每天问自己个问题#6. SIP标准协议 RFC3261
- [PHP]php发布和调用Webservice接口的案例
- oracle增量合并存储过程,怎么将视图与存储过程里的逻辑合并
- 2015-2016 ACM-ICPC Northeastern European Regional Contest (NEERC 15)
- python flask 上传下载 api_python – 使用Flask上传和下载文件
- 生成随机测试数据的文件的程序
- 仿ISQL功能的实现,可以实现批处理功能
- INSTALL_FAILED_TEST_ONLY的解决办法
- FreeRADIUS服务器搭建及配置
- 小猿圈web分享-一个web全栈工程师的面试总结
- 手机定位--GPS定位,基站定位,辅助定位
- 管理中的“鲶鱼效应”
- 计算机每天定时开机设置方法,定时开机 (电脑自动开机) 设置方法
- 视频切片mp4格式转换m3u8
- 修改docker时区为北京时间
- 计算机考试金麦圈编号教程,计算机二级:数据处理.docx
- 数学规划模型总结(附MatLab代码)
- 实现一周之内自动登录的 cookie和session还有localStorage的存储机制
- 直角坐标系与极坐标系了解与转换
- 音乐播放器android-1.0