Vue3-路由详解

文章目录

• 路由
• • 对路由的理解
  • [安装 Vue Router](#安装 Vue Router)
  • 基本切换效果
  • 两个注意点
  • 路由器工作模式
  • to的两种写法
  • 命名路由
  • 嵌套路由
  • 路由传参
  • • query参数
    • params参数
  • 路由的props配置
  • replace属性
  • 编程式导航
  • 重定向

更多相关内容可查看

路由

附git地址：https://gitee.com/its-a-little-bad/vue.git
git中有以下相关代码，可以拉取测试，node版本为20.8.1，详解看注释

对路由的理解

• 动态路由匹配：你可以基于 URL 的不同部分来动态地匹配和渲染不同的组件。
• 嵌套路由：你可以将路由映射到嵌套的组件结构中，以构建复杂的用户界面。
• 路由参数：你可以在 URL 中添加参数，并在组件中访问它们。
• 查询参数和哈希片段：除了路径参数外，你还可以从 URL 的查询字符串或哈希片段中访问数据。
• 滚动行为：你可以自定义路由切换时的滚动行为。
• 导航守卫：你可以在路由切换前、切换后或切换失败时运行一些逻辑，如检查用户是否已登录或加载异步数据。
• 路由懒加载：Vue Router 支持将路由组件异步加载，以提高应用的初始加载速度。
• 编程式导航：除了使用 组件进行声明式导航外，你还可以使用 Vue Router 的 API 进行编程式导航。
• HTML5 History 模式：默认情况下，Vue Router 使用 HTML5 History 模式来构建
  URL，但它也支持传统的哈希模式（使用 URL 的哈希片段）。
• 过渡效果：你可以使用 Vue 的过渡组件（）为路由切换添加过渡效果。

安装 Vue Router

npm install vue-router
# 或者  
yarn add vue-router

基本切换效果

• Vue3中要使用vue-router的最新版本，目前是4版本。
• 路由配置文件代码如下：

import {createRouter,createWebHistory} from 'vue-router'
import Home from '@/pages/Home.vue'
import News from '@/pages/News.vue'
import About from '@/pages/About.vue'

const router = createRouter({
	history:createWebHistory(),//工作模式 ，还有一种是hash
	routes:[
		{
			path:'/home', //pages下的vue文件的路径
			component:Home //pages下的vue文件
		},
		{
			path:'/about',
			component:About
		}
	]
})
export default router //向外抛出

• main.ts或main.js代码如下：

import router from './router/index'
app.use(router)//使用路由
app.mount('#app')//挂载

• App.vue代码如下

<template>
  <div class="app">
    <h2 class="title">Vue路由测试</h2>
    <!-- 导航区 -->
    <div class="navigate">
      <RouterLink to="/home" active-class="active">首页</RouterLink>
      <RouterLink to="/news" active-class="active">新闻</RouterLink>
      <RouterLink to="/about" active-class="active">关于</RouterLink>
    </div>
    <!-- 展示区 -->
    <div class="main-content">
      <RouterView></RouterView>
    </div>
  </div>
</template>

<script lang="ts" setup name="App">
  import {RouterLink,RouterView} from 'vue-router'  
</script>

两个注意点

1. 路由组件通常存放在pages 或 views文件夹，一般组件通常存放在components文件夹。
2. 通过点击导航，视觉效果上"消失" 了的路由组件，默认是被卸载 掉的，需要的时候再去挂载。

路由器工作模式

1. history模式

优点：URL更加美观，不带有#，更接近传统的网站URL。

缺点：后期项目上线，需要服务端配合处理路径问题，否则刷新会有404错误。

const router = createRouter({
  	history:createWebHistory(), //history模式
  	/******/
})

2. hash模式

优点：兼容性更好，因为不需要服务器端处理路径。

缺点：URL带有#不太美观，且在SEO优化方面相对较差。

const router = createRouter({
  	history:createWebHashHistory(), //hash模式
  	/******/
})

to的两种写法

<!-- 第一种：to的字符串写法 -->
<router-link active-class="active" to="/home">主页</router-link>

<!-- 第二种：to的对象写法 -->
<router-link active-class="active" :to="{path:'/home'}">Home</router-link>

命名路由

作用：可以简化路由跳转及传参。

给路由规则命名：

routes:[
  {
    name:'zhuye',
    path:'/home',
    component:Home
  },
  {
    name:'xinwen',
    path:'/news',
    component:News,
  },
  {
    name:'guanyu',
    path:'/about',
    component:About
  }
]

跳转路由：

<!--简化前：需要写完整的路径（to的字符串写法） -->
<router-link to="/news/detail">跳转</router-link>

<!--简化后：直接通过名字跳转（to的对象写法配合name属性） -->
<router-link :to="{name:'guanyu'}">跳转</router-link>

嵌套路由

1. 编写News的子路由：Detail.vue
2. 配置路由规则，使用children配置项：

const router = createRouter({
  history:createWebHistory(),
	routes:[
		{
			name:'zhuye',
			path:'/home',
			component:Home
		},
		{
			name:'xinwen',
			path:'/news',
			component:News,
			children:[
				{
					name:'xiang',
					path:'detail',
					component:Detail
				}
			]
		},
		{
			name:'guanyu',
			path:'/about',
			component:About
		}
	]
})
export default router

3. 跳转路由（记得要加完整路径）：

<router-link to="/news/detail">xxxx</router-link>
<!-- 或 -->
<router-link :to="{path:'/news/detail'}">xxxx</router-link>

4. 记得去Home组件中预留一个<router-view>

<template>
  <div class="news">
    <nav class="news-list">
      <RouterLink v-for="news in newsList" :key="news.id" :to="{path:'/news/detail'}">
        {{news.name}}
      </RouterLink>
    </nav>
    <div class="news-detail">
      <RouterView/>
    </div>
  </div>
</template>

路由传参

query参数

1. 传递参数

<!-- 跳转并携带query参数（to的字符串写法） -->
<router-link to="/news/detail?a=1&b=2&content=欢迎你">
	跳转
</router-link>
				
<!-- 跳转并携带query参数（to的对象写法） -->
<RouterLink 
  :to="{
    //name:'xiang', //用name也可以跳转
    path:'/news/detail',
    query:{
      id:news.id,
      title:news.title,
      content:news.content
    }
  }"
>
  {{news.title}}
</RouterLink>

2. 接收参数：

import {useRoute} from 'vue-router'
const route = useRoute()
// 打印query参数
console.log(route.query)

params参数

1. 传递参数

<!-- 跳转并携带params参数（to的字符串写法） -->
<RouterLink :to="`/news/detail/001/新闻001/内容001`">{{news.title}}</RouterLink>
				
<!-- 跳转并携带params参数（to的对象写法） -->
<RouterLink 
  :to="{
    name:'xiang', //用name跳转
    params:{
      id:news.id,
      title:news.title,
      content:news.title
    }
  }"
>
  {{news.title}}
</RouterLink>

2. 接收参数：

import {useRoute} from 'vue-router'
const route = useRoute()
// 打印params参数
console.log(route.params)

备注1：传递params参数时，若使用to的对象写法，必须使用name配置项，不能用path。

备注2：传递params参数时，需要提前在规则中占位。

路由的props配置

作用：让路由组件更方便的收到参数（可以将路由参数作为props传给组件）

{
	name:'xiang',
	path:'detail/:id/:title/:content',
	component:Detail,

  // props的对象写法，作用：把对象中的每一组key-value作为props传给Detail组件
  // props:{a:1,b:2,c:3}, 

  // props的布尔值写法，作用：把收到了每一组params参数，作为props传给Detail组件
  // props:true
  
  // props的函数写法，作用：把返回的对象中每一组key-value作为props传给Detail组件
  props(route){
    return route.query
  }
}

replace属性

1. 作用：控制路由跳转时操作浏览器历史记录的模式。
2. 浏览器的历史记录有两种写入方式：分别为push和replace：

• push是追加历史记录（默认值）。
• replace是替换当前记录。

3. 开启replace模式：

<RouterLink replace .......>News</RouterLink>

编程式导航

路由组件的两个重要的属性：$route和$router变成了两个hooks

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

const route = useRoute()
const router = useRouter()

console.log(route.query)
console.log(route.parmas)
console.log(router.push)
console.log(router.replace)

重定向

1. 作用：将特定的路径，重新定向到已有路由。
2. 具体编码：

{
    path:'/',
    redirect:'/about'
}