目录
安装
浏览器路由模式
配置(/src/router/index.js )
路由表的配置字段
Vue
命名路由(name)
命名视图(同级展示)
路由元信息(meta,任意附加信息,如授权)
传参
url参数
location属性值
window
useLocation()
query(显式)携带辅助信息
params(显式/隐式(刷新页面会消失))差异化界面
动态路由(不同parmas,访问同一个组件)
编程式路由(非link模式)
Vue
React
loader回调函数(路由前触发)
主入口
守卫(权限、路由拦截)
导航解析流程
全局
Vue
React
/src/components/BeforeEach.jsx
局部路由(相比组件路由,更推荐局部,更好地逻辑分块)
组件路由
浏览器输入URL展示路由对应组件
Vue占位router-view\router-link
React占位Outlet\Link
导航重复(修改原型方法)
路由:根据不同的url地址展示不同的内容,SPA(单页应用)的路径管理器
Vue3搭配的是Vue Router4,其他用法上和vue2没有太大变化
//Vue.use() 方法进行安装和注册VueRouter插件
//自动调用插件对象中的 install 方法
Vue.use(VueRouter);
npm install vue-router
npm i react-router-dom
history
模式使用浏览器的 History API,可以在 URL 中隐藏额外的字符,适合大多数常规的浏览器环境。#
,路由更加美观。//Vue 2.x 或 3.x Options API
const router = new VueRouter({
mode: 'history',
routes
});
// Vue 3.x Composition API
import { createRouter, createWebHistory } from 'vue-router';
const router = createRouter({
history: createWebHistory(),
routes
})
hash
模式在 URL 中使用哈希值( #
,可以通过监听哈希变化来实现路由导航)//Vue 2.x 或 3.x Options API
const router = new VueRouter({
mode: 'hash',
routes
});
// Vue 3.x Composition API
import { createRouter, createWebHashHistory} from 'vue-router';
const router = createRouter({
history: createWebHashHistory(),
routes
})
const router = new VueRouter({
routes
})
/src/router/index.js
)path:指定路径
element(React)/component(Vue):对应组件
children:嵌套路由
params 的自动编码/解码
{
path: '/about/foo/:id',
name: 'foo',
component: Foo
}
{ name: 'foo', params: {id: 123} }
meta: { auth: false }
this.$route.meta.auth
import { useLocation, matchRoutes, Navigate } from 'react-router-dom'
import { routes } from '../../router';
export default function BeforeEach(props) {
const location = useLocation();
const matchs = matchRoutes(routes, location)
const meta = matchs[matchs.length-1].route.meta
if(meta.auth){
return
}
else{
return (
{ props.children }
)
}
}
http://example.com/page?param1=value1¶m2=value2#section1
? | 分隔实际的URL和参数 |
& | URL中指定的参数间的分隔符 |
= | 左边为参数名、右边参数值 |
# | 锚点(Anchor),用于标识文档中的特定位置或元素, 仅在客户端使用,并且由浏览器处理,不发送到服务器 指示浏览器滚动到具有 |
window的全局对象,表示当前页面http://www.example.com/path/index.html
window.location.href:获取/设置 url
window.location.orgin:协议、主机名和端口号部分
//https://www.example.com:8080/page.html
// :// :
//https%3A%2F%2Fwww.example.com%3A8080。
encodeURIComponent(window.location.origin)
//encodeURIComponent用于将字符串中的特殊字符(空格、&、+、= 、?)转换为编码形式,确保URL中不包含任何无效字符
//查询参数时 或者 动态参数时 需要encodeURIComponent
const url = 'https://example.com/api?param=' + encodeURIComponent(queryParam);
window.location.href =`https://www.example.com/path/to/resource.html/domain=${location.host}&req=${encodeURIComponent(location.pathname)}&protocol=https${location.hash}`
window.location.protocol: 协议http
window.location.host:主机+端口(host:8080)/IP地址(127.123.32.1唯一)/域名(www.example.com助记)
window.location.hostname:主机host
window.location.port:端口8080
window.location.pathname: 资源路径path/index.html,资源index.html
window.location.hash:
window.location.search: 搜索
var searchParams = new URLSearchParams(window.location.search);
console.log(searchParams.get('name')); // 输出 "John"
import { useLocation } from 'react-router-dom'
hash:哈希值
key:唯一标识
pathname:路径
search:query值(需要把字符串解析成对象。)
state:隐式数据
$route.query
import { useSearchParams } from 'react-router-dom'
const [searchParams, setSearchParams] = useSearchParams()
console.log( searchParams.get('age') );
const handleClick = () => {
setSearchParams({ age: 22 })
}
$route.params
显式:path: '/user/:id',
隐式:path: '/user/',
query显式 /workbenchConfiguration/upload?wpReleId=59
params显式 /workbenchConfiguration/upload/59
import { Outlet, Link } from 'react-router-dom'
export default function About() {
return (
foo 123 | foo 456
)
}
//...
{
path: 'foo/:id',
element:
}
//...
import { useParams } from 'react-router-dom'
export default function Foo() {
const params = useParams()
return (
Foo, { params.id }
)
}
//Vue与React唯一不同
this.$route.params.id
//vue
this.$router.push({
path: `/about/foo/${id}`
})
//react
import {useNavigate } from 'react-router-dom'
const navigate = useNavigate()
const handleClick= () => {
navigate('/about/foo/123')
}
import VueRouter from 'vue-router'
import Home from '@/views/Home.vue'
const About={template:'About'}
const routes: Array = [
{
path: '/',
redirect: '/workbenchConfiguration'
},
{
path: '/404',
meta: { title: '404' },
component: () => import('@/views/404.vue')
},
{ path: '*', redirect: '/404' }
]
const router = new VueRouter({
routes
})
import { createBrowserRouter, createHashRouter } from 'react-router-dom'
//路由表
export const routes = [
// 默认路由
{
index: true,
//重定向
element: ,
//自带errorElement
errorElement: 404,
},
//*局部404
{
path: '*',
element: 404
}
];
//路由对象
const router = createBrowserRouter(routes);
export default router;
默认同步,配合redirect做权限拦截。
{
path: 'bar',
element: ,
//async,await异步,Promise用于表示一个异步操作的最终完成(或失败)及其结果值。
loader: async() => {
let ret = await new Promise((resolve)=>{
setTimeout(()=>{
resolve({errcode: 0})
}, 2000)
})
return ret;
}
}
useLoaderData()获取loader函数返回的数据
import { useLoaderData } from 'react-router-dom'
export default function Bar() {
const data = useLoaderData()
console.log(data)
return (
Bar
)
loader
函数中是没有办法使用
{
path: 'bar',
element: ,
loader: async() => {
let ret = await new Promise((resolve)=>{
setTimeout(()=>{
resolve({errcode: Math.random() > 0.5 ? 0 : -1})
}, 2000)
})
if(ret.errcode === 0){
return ret;
}
else{
return redirect('/login')
}
}
}
//index.js
import { RouterProvider } from 'react-router-dom'
import router from './router';
const root = ReactDOM.createRoot(document.getElementById('root'));
root.render(
);
导航被触发。
在失活的组件里调用 beforeRouteLeave
守卫。
调用全局的 beforeEach
守卫。
在重用的组件里调用 beforeRouteUpdate
守卫(2.2+)。
在路由配置里调用 beforeEnter
解析异步路由组件。
在被激活的组件里调用 beforeRouteEnter
。
调用全局的 beforeResolve
守卫(2.5+)。
导航被确认。
调用全局的 afterEach
钩子。
触发 DOM 更新。
调用 beforeRouteEnter
守卫中传给 next
的回调函数,创建好的组件实例会作为回调函数的参数传入。
//to
router.beforeEach((to, from, next)=>{
if(to.meta.auth){
next('/');
}
else{
next();
}
})
//vue+ts
router.beforeEach((to: any, from: any, next: any) => {
const metaTitlt = (to.meta && to.meta.title) || ''
document.title = `${metaTitlt} - 默认模版`
//是否从根路径而来,当前路由的来源路径和即将进入的路由的路径是否相同
if (from.path !== '/' && from.matched[0].path !== to.matched[0].path) {
message.destroy()
}
next()
})
import React from 'react'
import { Navigate } from 'react-router-dom'
import { routes } from '../../router';
export default function BeforeEach(props) {
if(true){
return
}
else{
return (
{ props.children }
)
}
}
export const routes = [
{
path: '/',
element: //包裹根组件APP
}
]
const routes = [
{
name: 'bar',
component: Bar,
beforeEnter(to, from, next){
if(to.meta.auth){
next('/');
}
else{
next();
}
}
}
];
没有占位的话,默认整个页面
首页 |
关于
import React from "react";
import { Outlet, Link } from 'react-router-dom'
function App() {
return (
hello react
首页 | 关于
);
}
export default App;
带样式的声明式路由NavLink
修改 VueRouter 的原型方法 push
和 replace
,用来捕获导航重复错误并进行处理,而不会在控制台中抛出错误,从而避免了不必要的错误提示和潜在的问题。
import Vue from 'vue';
import VueRouter from 'vue-router';
Vue.use(VueRouter);
const originalPush = VueRouter.prototype.push;
VueRouter.prototype.push = function push(location) {
return originalPush.call(this, location).catch(err => {
if (err.name !== 'NavigationDuplicated') {
throw err;
}
});
};
const originalReplace = VueRouter.prototype.replace;
VueRouter.prototype.replace = function replace(location) {
return originalReplace.call(this, location).catch(err => {
if (err.name !== 'NavigationDuplicated') {
throw err;
}
});
};
const router = new VueRouter({
// 路由配置...
});
export default router;