1. vue路由简介和基础使用

1.1 什么是路由

设备和ip的映射关系

接口和服务的映射关系

路径和组件的映射关系

1.2 为什么使用路由？

在一个页面里, 切换业务场景，具体使用示例: 网易云音乐 网易云音乐

单页面应用(SPA): 所有功能在一个html页面上实现

前端路由作用: 实现业务场景切换

优点：

• 整体不刷新页面，用户体验更好

• 数据传递容易, 开发效率高

缺点：

• 开发成本高(需要学习专门知识)

• 首次加载会比较慢一点。不利于seo

1.3 vue-router介绍

如何在Vue项目中集成路由

官网: Vue Router | Vue.js 的官方路由

vue-router模块包

它和 Vue.js 深度集成

可以定义 - 视图表(映射规则)

模块化的

提供2个内置全局组件

声明式导航自动激活的 CSS class 的链接

1.4 路由 - 组件分类

 .vue文件分2类, 一个是页面组件, 一个是复用组件

.vue文件本质无区别, 方便大家学习和理解, 总结的一个经验

src/views(或pages) 文件夹 和 src/components文件夹

• 页面组件 - 页面展示 - 配合路由用

• 复用组件 - 展示数据/常用于复用

 views下的页面组件， 配合路由切换，

components下的一般引入到views下的vue中复用展示数据

1.5 vue-router使用

vue-router路由系统功能模块使用

vue-router文档

简单搭建尝试：

• 安装

npm install vue-router@4

• 1、创建views文件夹用来存储跳转的页面，HomeView，AboutView两个vue页面

<!--AboutView.vue-->
<template>
  <div class="about">
    <h1>This is an about page</h1>
  </div>
</template>
<!--HomeView.vue-->
<template>
  <div class="home">
    <h1>This is an Home page</h1>
  </div>
</template>

• 2、创建router文件夹/里面创建index.js

import { createRouter, createWebHashHistory } from 'vue-router'
// 1.定义路由组件
// 第一种定义
import HomeView from '../views/HomeView.vue'
// 2. 定义路由表
// 每个路由都需要映射到一个组件。
const routes = [
  {
    path: '/',
    name: 'home',
    component: HomeView
  },
  {
    path: '/about',
    name: 'about',
    // 第二种 router 拆分使用hash模式
    // 这为此路由生成一个单独的块（about.[hash].js）
    // 当访问该路线时，其是惰性加载的。
    component: () => import('../views/AboutView.vue')
  }
]
// 3.创建路由实例并传递 `routes` 配置
const router = createRouter({
// 4.内部提供了 history 模式的实现。为了简单起见，我们在这里使用 hash 模式。
  history: createWebHashHistory(),
  routes
})
// 5.导出 供main.js 挂载
export default router

• 3、到mian.js里面挂载 导入router 是从index.js里面导出的名字

import router from './router'
// 两种挂载方式
// createApp(App).use(store).use(router).mount('#app')
// 5.创建并挂载根实例
const app = createApp(App)
app.use(router)
app.mount('#app')

• 4、app.vue里面使用路由

<template>
  <div>
    <h1>vue 路由模式</h1>
  <nav>
    <!--使用 router-link 组件进行导航 -->
    <!--通过传递 `to` 来指定链接 -->
    <!--`<router-link>` 将呈现一个带有正确 `href` 属性的 `<a>` 标签-->
    <router-link to="/">Home</router-link> |
    <router-link to="/about">About</router-link>
  </nav>
  <!-- 路由出口 -->
  <!-- 路由匹配到的组件将渲染在这里 -->
  <router-view></router-view>
</div>
</template>

1.6 根据链接样式设定路由表

App.vue - 页面标签和样式准备

<template>
  <div>
    <div class="footer_wrap">
      <a href="#/find">发现音乐</a>
      <a href="#/my">我的音乐</a>
      <a href="#/part">朋友</a>
    </div>
    <div class="top">
      
    </div>
  </div>
</template>

<script>
export default {};
</script>

<style scoped>
.footer_wrap {
  position: fixed;
  left: 0;
  top: 0;
  display: flex;
  width: 100%;
  text-align: center;
  background-color: #333;
  color: #ccc;
}
.footer_wrap a {
  flex: 1;
  text-decoration: none;
  padding: 20px 0;
  line-height: 20px;
  background-color: #333;
  color: #ccc;
  border: 1px solid black;
}
.footer_wrap a:hover {
  background-color: #555;
}
.top {
  padding-top: 62px;
}
</style>

• 创建路由规则数组

const routes = [
  {
    path: "/find",
    
    component: Find
  },
  {
    path: "/my",
    component: My
  },
  {
    path: "/part",
    component: Part
  }
]

• 创建路由页面 find，my，part

<!--find.vue-->
<template>
    <div>
        <p>推荐</p>
        <p>排行榜</p>
        <p>歌单</p>
    </div>
</template>
<script>
export default {
}
</script>

• my.vue

<template>
    <div>
      <p>我的收藏</p>
      <p>我的历史记录</p>
  </div>
</template>
<script>
export default {
}
</script>
<style scoped>
​
</style>

• Part.vue

<template>
  <div>
    <p>关注明星</p>
    <p>发现精彩</p>
    <p>寻找伙伴</p>
    <p>加入我们</p>
    <p>人名</p>
  </div>
</template>
<script>
export default {
}
</script>

下载路由模块, 编写对应规则注入到vue实例上, 使用router-view挂载点显示切换的路由

一切都围绕着hash值变化为准

2. vue路由 - 声明式导航

2.1 声明式导航 - 基础使用

可用全局组件router-link来替代a标签

1. vue-router提供了一个全局组件 router-link

2. router-link实质上最终会渲染成a链接 to属性等价于提供 href属性(to无需#)

3. router-link提供了声明式导航高亮的功能(自带类名)

<template>
  <div>
    <div class="footer_wrap">
      <router-link to="/find">发现音乐</router-link>
      <router-link to="/my">我的音乐</router-link>
      <router-link to="/part">朋友</router-link>
    </div>
    <div class="top">
      <router-view></router-view>
    </div>
  </div>
</template>
​
<script>
export default {};
</script>
​
<style scoped>
/* 省略了 其他样式 */
.footer_wrap .router-link-active{
  color: white;
  background: black;
}
</style>

  链接导航, 用router-link配合to, 实现点击切换路由

2.2 声明式导航 - 跳转传参

在跳转路由时, 可以给路由对应的组件内传值

在router-link上的to属性传值, 语法格式如下

• /path?参数名=值

• /path/值 – 需要路由对象提前配置 path: “/path/参数名”

对应页面组件接收传递过来的值

• $route.query.参数名

• $route.params.参数名

创建components/Part.vue - 准备接收路由上传递的参数和值

<template>
  <div>
      <p>关注明星</p>
      <p>发现精彩</p>
      <p>寻找伙伴</p>
      <p>加入我们</p>
      <p>人名: {{ $route.query.name }} -- {{ $route.params.username }}</p>
  </div>
</template>

路由定义

{
    path: "/part",
    component: Part
  },
  {
    path: "/part/:username", // 有:的路径代表要接收具体的值
    component: Part
  },

导航跳转, 传值给MyGoods.vue组件

<router-link to="/part?name=小蔚">朋友-小蔚</router-link>
<router-link to="/part/大奔">朋友-大奔</router-link>

 ?key=value 用$route.query.key 取值/值

提前在路由规则/path/:key 用$route.params.key 取值

3. vue路由 - 重定向和模式

3.1 路由 - 重定向

匹配path后, 强制切换到目标path上

• 网页打开url默认hash值是/路径

• redirect是设置要重定向到哪个路由路径

例如: 网页默认打开, 匹配路由"/", 强制切换到"/find"上

const routes = [
  {
    path: "/", // 默认hash值路径
    redirect: "/find" // 重定向到/find
    // 浏览器url中#后的路径被改变成/find-重新匹配数组规则
  }
]

强制重定向后, 还会重新来数组里匹配一次规则

3.2 路由 - 404页面

如果路由hash值, 没有和数组里规则匹配

默认给一个404页面

语法: 路由最后, path匹配*(任意路径) – 前面不匹配就命中最后这个, 显示对应组件页面

1. 创建NotFound页面

<template>
  <img src="../assets/404.png" alt="">
</template>

<script>
export default {

}
</script>

<style scoped>
    img{
        width: 100%;
    }
</style>

1. 在main.js - 修改路由配置

import NotFound from '@/views/NotFound'

const routes = [
  // ...省略了其他配置
  // 404在最后(规则是从前往后逐个比较path)
  {
    path: '/:path(.*)',
    component: NotFound
  }
]

 如果路由未命中任何规则, 给出一个兜底的404页面

3.3 路由 - 模式设置

修改路由在地址栏的模式

hash路由例如: http://localhost:8080/#/home

history路由例如: http://localhost:8080/home (以后上线需要服务器端支持, 否则找的是文件夹)

模式文档

router/index.js

//引入 createWebHistory
const router = createRouter({
  history: createWebHistory(),// 打包上线后需要后台支持, 模式是hash
  routes,
  
})

4. vue路由 - 编程式导航

用JS代码跳转, 声明式导航用a标签

4.1 编程式导航 - 基础使用

用JS代码来进行跳转

语法:

this.$router.push({
    path: "路由路径", // 都去 router/index.js定义
    name: "路由名"
})

main.js - 路由数组里, 给路由起名字

{
    path: "/find",
    name: "Find",
    component: Find
},
{
    path: "/my",
    name: "My",
    component: My
},
{
    path: "/part",
    name: "Part",
    component: Part
},

App.vue - 换成span 配合js的编程式导航跳转

<template>
  <div>
    <div class="footer_wrap">
      <span @click="btn('/find', 'Find')">发现音乐</span>
      <span @click="btn('/my', 'My')">我的音乐</span>
      <span @click="btn('/part', 'Part')">朋友</span>
    </div>
    <div class="top">
      <router-view></router-view>
    </div>
  </div>
</template>
​
<script>
// 目标: 编程式导航 - js方式跳转路由
// 语法:
// this.$router.push({path: "路由路径"})
// this.$router.push({name: "路由名"})
// 注意:
// 虽然用name跳转, 但是url的hash值还是切换path路径值
// 场景:
// 方便修改: name路由名(在页面上看不见随便定义)
// path可以在url的hash值看到(尽量符合组内规范)
export default {
  methods: {
    btn(targetPath, targetName){
      // 方式1: path跳转
      this.$router.push({
        // path: targetPath,
        name: targetName
      })
    }
  }
};
</script>

4.2 编程式导航 - 跳转传参

JS跳转路由, 传参

语法 query / params 任选 一个

this.$router.push({
    path: "路由路径"
    name: "路由名",
    query: {
        "参数名": 值
    }
    params: {
        "参数名": 值
    }
})
​
// 对应路由接收   $route.params.参数名   取值
// 对应路由接收   $route.query.参数名    取值

使用path会自动忽略params

App.vue

<template>
  <div>
    <div class="footer_wrap">
      <span @click="btn('/find', 'Find')">发现音乐</span>
      <span @click="btn('/my', 'My')">我的音乐</span>
      <span @click="oneBtn">朋友-小蔚</span>
      <span @click="twoBtn">朋友-大奔</span>
    </div>
    <div class="top">
      <router-view></router-view>
    </div>
  </div>
</template>
​
<script>
// 目标: 编程式导航 - 跳转路由传参
// 方式1:
// params => $route.params.参数名
// 方式2:
// query => $route.query.参数名
// 重要: path会自动忽略params 使用name的情况下params优先级要高于query 
// 推荐: name+query方式传参
// 注意: 如果当前url上"hash值和?参数"与你要跳转到的"hash值和?参数"一致, 爆出冗余导航的问题, 不会跳转路由
export default {
  methods: {
    btn(targetPath, targetName){
      // 方式1: path跳转
      this.$router.push({
        // path: targetPath,
        name: targetName
      })
    },
    oneBtn(){
      this.$router.push({
        name: 'Part',
        params: {
          username: '小蔚'
        }
      })
    },
    twoBtn(){
      this.$router.push({
        name: 'Part',
        query: {
          name: '大奔'
        }
      })
    }
  }
};
</script>

传参2种方式query方式 params方式

5. vue路由 - 嵌套和守卫

5.1 vue路由 - 路由嵌套

在现有的一级路由下, 再嵌套二级路由

二级路由示例-网易云音乐-发现音乐下

router-view嵌套架构图

1. 创建需要用的所有组件

src/views/Find.vue -- 发现音乐页
src/views/My.vue -- 我的音乐页
src/views/Second/Recommend.vue  -- 发现音乐页 / 推荐页面
src/views/Second/Ranking.vue      -- 发现音乐页 / 排行榜页面
src/views/Second/SongList.vue     -- 发现音乐页 / 歌单页面

1. main.js– 继续配置2级路由一级路由path从/开始定义二级路由往后path直接写名字, 无需/开头嵌套路由在上级路由的children数组里编写路由信息对象

2. 说明：App.vue的router-view负责发现音乐和我的音乐页面, 切换Find.vue的的router-view负责发现音乐下的, 三个页面, 切换

3.配置二级导航和样式在Find.vue中

<template>
  <div>
    <!-- <p>推荐</p>
    <p>排行榜</p>
    <p>歌单</p> -->
    <div class="nav_main">
      <router-link to="/find/recommend">推荐</router-link>
      <router-link to="/find/ranking">排行榜</router-link>
      <router-link to="/find/songlist">歌单</router-link>
    </div>
​
    <div style="1px solid red;">
      <router-view></router-view>
    </div>
  </div>
</template>
​
<script>
export default {};
</script>
​
<style scoped>
.nav_main {
  background-color: red;
  color: white;
  padding: 10px 0;
}
.nav_main a {
  text-align: center;
  text-decoration: none;
  color: white;
  font-size: 12px;
  margin: 7px 17px 0;
  padding: 0px 15px 2px 15px;
  height: 20px;
  display: inline-block;
  line-height: 20px;
  border-radius: 20px;
}
.nav_main a:hover {
  background-color: brown;
}
.nav_main .router-link-active{
  background-color: brown;
}
</style>

配置路由规则-二级路由展示

const routes = [
  // ...省略其他
  {
    path: "/find",
    name: "Find",
    component: Find,
    children: [
      {
        path: "recommend",
        component: Recommend
      },
      {
        path: "ranking",
        component: Ranking
      },
      {
        path: "songlist",
        component: SongList
      }
    ]
  }
  // ...省略其他
]

说明：

• App.vue, 外层的router-view负责发现音乐和我的音乐页面切换

• Find.vue 内层的router-view负责发现音乐下的子tab对应的组件切换

运行 - 点击导航观察嵌套路由在哪里展示

嵌套路由, 找准在哪个页面里写router-view和对应规则里写children

5.2 声明导航 - 类名区别

router-link自带的2个类名的区别是什么

观察路由嵌套导航的样式

• router-link-exact-active (精确匹配) url中hash值路径, 与href属性值完全相同, 设置此类名

• router-link-active (模糊匹配) url中hash值, 包含href属性值这个路径

5.3 全局前置守卫

路由跳转之前, 先执行一次前置守卫函数, 判断是否可以正常跳转

使用例子: 在跳转路由前, 判断用户登陆了才能去<我的音乐>页面, 未登录弹窗提示回到发现音乐页面

在路由对象上使用固定方法beforeEach

// 目标: 路由守卫
// 场景: 当你要对路由权限判断时
// 语法: router.beforeEach((to, from, next)=>{//路由跳转"之前"先执行这里, 决定是否跳转})
// 参数1: 要跳转到的路由 (路由对象信息)    目标
// 参数2: 从哪里跳转的路由 (路由对象信息)  来源
// 参数3: 函数体 - next()才会让路由正常的跳转切换, next(false)在原地停留, next("强制修改到另一个路由路径上")
// 注意: 如果不调用next, 页面留在原地
​
// 例子: 判断用户是否登录, 是否决定去"我的音乐"/my
const isLogin = true; // 登录状态(未登录)
router.beforeEach((to, from, next) => {
  if (to.path === "/my" && isLogin === false) {
    alert("请登录")
    next(false) // 阻止路由跳转
  } else {
    next() // 正常放行
  }
})

 next()放行, next(false)留在原地不跳转路由, next(path路径)强制换成对应path路径跳转