vue3使用vue-router路由（路由懒加载、路由传参）

vue-router 是 vue的一个插件库

1. 专门用来实现一个SPA单页面应用

2 .基于vue的项目基本都会用到此库

SPA的理解

1) 单页Web应用（single page web application，SPA）

2) 整个应用只有一个完整的页面

3) 点击页面中的链接不会刷新页面, 本身也不会向服务器发请求

4) 当点击路由链接时, 只会做页面的局部更新

路由的理解

1) 什么是路由?

a. 一个路由就是一个映射(对应)关系(key:value)

b. key为路由路径path, value可能是function/component

2) 路由分类

a. 后台路由: node服务器端路由, value是function, 用来处理客户端提交的请求并返回一个响应数据

b. 前台路由: 浏览器端路由, value是component, 当请求的是路由path时, 浏览器端没有发送http请求, 但界面会更新显示对应的组件

3) 后台路由

a. 注册路由:

1. app.get(path, function(req, res))
2.router.get(path, function(req, res))

b. 当node接收到一个请求时, 根据请求路径找到匹配的路由, 调用路由中的函数来处理请求, 返回响应数据

4) 前端路由

a. 注册路由

{

path: '/home',

component: Home

b. 当浏览器的path变为/home时, 当前路由组件就会变为home组件

下载终端执行命令: npm install vue-router

vue3 中使用 vue-router 需要4.x 版本，

安装完成后package.json 文件中会出现"vue-router": "^4.x.x"

npm install vue-router安装完成后：创建route文件夹和index.ts文件

index.ts文件代码：

@代表src路径

component: '@/views/Home/index.vue', 直接使用

component: () => import('@/views/Home/index.vue'), 路由懒加载写法
官网介绍路由懒加载：

当打包构建应用时，JavaScript 包会变得非常大，影响页面加载。如果我们能把不同路由对应的组件分割成不同的代码块，然后当路由被访问的时候才加载对应组件，这样就会更加高效。

Vue Router 支持开箱即用的动态导入，这意味着你可以用动态导入代替静态导入。

component (和 components) 配置接收一个返回 Promise 组件的函数，Vue Router 只会在第一次进入页面时才会获取这个函数，然后使用缓存数据。这意味着你也可以使用更复杂的函数，只要它们返回一个 Promise ：

const Home = () =>

Promise.resolve({

/* 组件定义 */

})
component: Home,

routes配置项：

path: 路由定义的路径

name: 路由名称 > 对应 .vue组件的name

redirect: 重定向到某个路由

component: 组件

meta：是一个用于描述路由元数据的对象。它允许你在定义路由时添加一些额外的信息，以便在路由导航过程中进行访问和处理。

通常，meta 被用来存储一些与路由相关的附加信息，例如页面标题、权限控制标识、页面级别的动画效果等。它可以在路由配置对象中的 meta 字段进行定义

这三种模式是用于配置路由的history、hash和memory模式。

createWebHistory() 该模式使用浏览器的历史记录API来存储和管理路径。使用该模式时，路径的变化会在浏览器的历史记录中进行更新，用户可以使用浏览器的后退和前进按钮来导航。该模式需要服务器配置支持。
createWebHashHistory() 该模式使用URL中的hash（#）来存储和管理路径。使用该模式时，路径的变化会在URL的hash值中进行更新，不会更新浏览器的历史记录。该模式适用于单页应用，可以在不支持HTML5 history API的浏览器中使用，但用户体验稍差。
createMemoryHistory() 该模式是一种内存路径管理器，它将路径存储在内存中，不会更新浏览器的历史记录或URL。该模式适用于需要模拟路径变化的开发环境或测试环境，但不适用于生产环境。

import {
  createRouter,
  createWebHashHistory,
  RouteRecordRaw
} from "vue-router";
// createWebHashHistory,createWebHistory

const routes: RouteRecordRaw[] = [
  {
    path: '/',
    redirect: '/home',
  },
  {
    path: '/home',
    name: 'Home',
    // component: '@/views/Home/index.vue', @代表src
    component: () => import('@/views/Home/index.vue'),
    meta: {
      title: 'Home Page',
      roles: ['admin', 'admin1']
    }
  },
  {
    path: '/lx',
    name: 'Lx',
    component: () => import('@/views/Home/Lx.vue'),
    // 也可以使用props传参方式接收传来的参数
    props: (propsRouter) => {
      console.log('props >router', propsRouter)
      // 可以return query 也可以return params支持两种传参方式
      return propsRouter.query
    }
  },
  {
    path: '/lxb/:id/:title', // 提前定义params参数（可以定义多个）
    name: 'Lxb',
    component: () => import('@/views/Home/Lxb.vue'),
  },
]

export const router = createRouter({
  // 路由的history模式，共有三种模式，
  // createWebHistory、createWebHashHistory、createMemoryHistory
  history: createWebHashHistory(),// history: createWebHistory(),
  // 路由配置
  routes,
  // 是否严格匹配路由
  strict: true,
  // 路由跳转完成后，页面滚动行为
  scrollBehavior: () => ({ left: 0, top: 0 }),
})

main.ts文件代码：

import { router } from './route/index'
import { createApp } from 'vue'

const app = createApp(App)
app.use(router).mount('#app')

App.vue文件代码：

<template>
  <router-view />
</template>

<script>
import { defineComponent } from 'vue'
 // vue3.0版本语法
export default defineComponent({
  name: 'App',
})
</script>

标签导航和编程式导航：

router-link的to属性有三个可选参数，分别是tag、replace、append。 replace：是否使用replace()替换当前history记录，而不是push。用户点击浏览器的后退按钮时，不会返回上一个页面，而是回到replace()指定的页面。 tag：组件的名称，路由组件会在该组件中渲染。 append：是否使用push()追加到history记录，而不是替换当前的history记录。

replace和push的区别是replace替换当前的history记录，而push追加到history记录。 replace()和push()方法是针对history.pushstate方法的封装，针对不同的业务场景，使用不同的方法。 history.pushstate：该方法会向web应用的历史记录列表添加一个新的记录，并替换当前的历史记录。 history.replacestate：该方法会向web应用的历史记录列表添加一个新的记录，但不会替换当前的历史记录。 history对象是window对象的属性，history对象代表当前窗口的历史记录，可以使用history.pushstate()和history.replacestate()来修改历史记录。 history对象的属性和方法如下表所示。

在Vue Router中，query和params都可以用来传递参数，但是它们的使用场景和作用方式有所不同。

query参数：query参数是附属于路由路径之后的参数，以?开头，多个参数用&连接。query参数是浏览器缓存的一部分，每次请求都会带有缓存的query参数。query参数会出现在请求的URL中，并且可以被浏览器的前进后退按钮所控制。

例如，对于路径/user/123，如果添加query参数{ query: 'foo' }，则路径变为/user/123?query=foo。

params参数：params参数是附属于路由路径内部的参数，用于在路径的不同部分之间传递参数。params参数不会出现在URL中，也不会被缓存，只能通过路由之间进行传递。

例如，对于路径/user/123/:id，如果传递的参数为{ name: 'john' }，则路径变为/user/123/john。

query参数和params参数的主要区别如下：

query参数可以在浏览器历史记录中被保存和恢复，而params参数则不行。
query参数可以被浏览器的前进后退按钮控制，而params参数则不会被更新。
query参数可以被搜索引擎索引，而params参数则不会被索引。
query参数可以被排序和过滤，而params参数则不可以。

在使用query参数和params参数时，可以根据实际需求选择合适的方式。如果需要在不同路由之间传递参数，建议使用params参数；如果需要缓存和控制浏览器前进后退按钮，建议使用query参数。

注意编程式导航：query传参可以用path 也可以用name，params传参只能用name！

router.push({path: '/url',query: {}})

router.push({name: 'xxx',query: {}})

router.push({name: 'xxx',params: {}})

useRoute()和useRouter()是Vue Router中提供的两个用于获取路由信息的指令。

useRoute()指令可以用于组件内，通过解构赋值获取当前路由的路径、参数、query等信息。

useRouter()指令可以用于组件内，通过解构赋值获取路由相关的各种信息，如导航、路由匹配等。

import { useRoute, useRouter } from 'vue-router'

const route = useRoute() // 相当于vue2的this.$route

const router = useRouter() // 相当于vue2的this.$router

views文件夹下的Home文件夹下的index.vue文件代码：

<template>
  <div class="home">
    <h2>首页{{ title }}</h2>
    <!-- 模拟有权限时显示 -->
    <div v-if="roles.includes(role)">
      <h2>标签式导航（标签来定义导航链接）</h2>
      <!-- router-link 最终生成的是a标签 -->
      <router-link to="/lx">push跳转到练习页面</router-link>
      <br>
      <!-- replace 跳转讲不会缓存之前的路由页面了 -->
      <router-link replace to="/lx">replace跳转到练习页面</router-link>
      <br>
      <router-link to="/lx?title=101&id=1">跳转到练习页面(query传参)</router-link>
      <br>
      <router-link to="/lxb/id:2/title:102">跳转到练习b页面(params传参)</router-link>

      <h2>编程式导航</h2>
      <div @click="routerGo('lx')">跳转到练习页面(query传参)</div>
      <div @click="routerGo('lxb')">跳转到练习b页面(params传参)</div>

    </div>
  </div>
</template>

<script lang="ts">
import { defineComponent, reactive, onMounted, toRefs, } from 'vue'
import { useRoute, useRouter } from 'vue-router'

export default defineComponent({
  name: 'Home',
  setup() {
    const router = useRouter()
    const route: any = useRoute()

    const state = reactive({
      title: '',
      role: '', // 我的当前角色
      roles: [''],
      routerGo: (path) => {
        if (path === 'lx' || path === '/home/childA') {
          // query传参可以用path 也可以用name: Lx
          router.push({
            path: path,
            query: {
              title: '101',
              id: 1
            }
          })
          // router.replace
        } else {
          // params传参只能用name
          router.replace({
            // path: path + '/id:2/title:102',
            name: 'Lxb',
            params: {
              title: '102',
              id: 2
            }
          })
        }
      },
    })
    onMounted(() => {
      console.log('/home', route)
      state.title = route.meta.title
      state.roles = route.meta.roles
      // 模拟一个接口
      setTimeout(() => {
        const res = {
          code: 200,
          data: {
            token: '123456',
            userName: '吴彦祖',
            role: 'admin'
          }
        }
        state.role = res.data.role
      }, 0)
    })
    return {
      ...toRefs(state)
    }
  }
})
</script>

<style lang="less" scoped>
.home {
  color: pink;
  font-size: 14px;
}
</style>

views文件夹下的Home文件夹下的Lx.vue文件代码：

<template>
  <div style="font-size: 14px;">
    <h2>我是练习{{ title }}页面</h2>
    <div>id:{{ id }}</div>
    <div>props: {{props}}</div>
    <button @click="routerGoBack">返回首页</button>
  </div>
</template>

<script lang="ts">
import { defineComponent, onMounted, reactive, toRefs } from 'vue';
import { useRoute, useRouter } from 'vue-router'

// vue3.0语法
export default defineComponent({
  name: 'Lx',
  props: {
    id: {
      type: String,
      default: ''
    },
    title: {
      type: String,
      default: ''
    },
  },
  setup(props) {
    const route = useRoute()
    const router = useRouter()
    const state = reactive({
      id: '',
      title: '',
      routerGoBack: () => {
        router.go(-1) // go(-1)回到上一个路由
        // 也可以用router.replace('/home')跳回首页
      }
    })

    onMounted(() => {
      console.log('lx route',route)
      console.log('lx props',props)
      if (route.query) {
        state.id = route.query.id
        state.title = route.query.title
      }
    })

    return {
      props,
      ...toRefs(state)
    }
  },
})
</script>

views文件夹下的Home文件夹下的Lxb.vue文件代码：

<template>
  <div style="font-size: 14px;">
    <h2>我是练习b{{ route?.params?.title }}页面</h2>
    <div>id:{{ route?.params?.id }}</div>
    <button @click="routerGoBack">返回首页</button>
  </div>
</template>

<script lang="ts">
import { defineComponent, onMounted, reactive, toRefs } from 'vue'
import { useRoute, useRouter } from 'vue-router'

// vue3.0语法
export default defineComponent({
  name: 'Lxb',
  setup() {
    const route = useRoute()
    const router = useRouter()
    const state: any = reactive({
      routerGoBack: () => {
        router.replace('/home')
        // 由replace跳转进来的不可以使用router.go(-1) 路由栈是空的》回不到上一个路由
      }
    })

    onMounted(() => {
      console.log(route)
    })

    return {
      route,
      ...toRefs(state)
    }
  },
})
</script>