vue-router(vue中的路由) 基本使用

2024-01-30 16:08:58

由于Vue在开发时对路由支持的不足，于是官方补充了vue-router插件。vue的单页面应用是基于路由和组件的，路由用于设定访问路径，并将路径和组件映射起来。传统的页面应用，是用一些超链接来实现页面切换和跳转的。在vue-router单页面应用中，则是路径之间的切换，实际上就是组件的切换。路由就是SPA（单页应用）的路径管理器。再通俗的说，vue-router就是我们WebApp的链接路径管理系统。
有的小伙伴会有疑虑，为什么我们不能像原来一样直接用a标签编写链接呢？因为我们一般用Vue做的都是单页应用，只有一个主页面index.html，所以你写的<a></a>标签是不起作用的，要使用vue-router来进行管理。

一.安装

方式一:单独下载,手动引入:

yarn add vue-router---安装路由命令

在main.js中引入

//1.导入路由
import VueRouter from 'vue-router'
// 2.在vue中，使用使用vue的插件，都需要调用Vue.use()
//使用路由插件
Vue.use(VueRouter) 
//3.创建路由规则数组
const routes = [
  {
    path: "/find",
    component: Find
  },
  {
    path: "/my",
    component: My
  },
  {
    path: "/part",
    component: Part
  }
]
//4.创建路由对象 -  传入规则
const router = new VueRouter({
  routes
})
//5.关联到vue实例

new Vue({
  router
})


//6.将组件中的component组件导入,替换为如下标签
<router-view></router-view>

方式二:用vue-cli脚手架来搭建项目

配置过程会选择是否用到路由（详细见vue-cli 脚手架），如果选择y，后面下载依赖会自动下载vue-router

如果在一个模块化工程中使用它，必须要通过 Vue.use() 明确地安装路由功能，用vue-cli生产了我们的项目结构，src文件目录下会有一个router文件夹，此处就是编写路由组件的地方。在src/router/index.js，这个文件就是路由的核心文件

// src/router/index.js文件中

import Vue from 'vue'   //引入Vue
import Router from 'vue-router'  //引入vue-router
import Hello from '@/components/Hello'  //引入根目录下的Hello.vue组件
 
Vue.use(Router)  //Vue全局使用Router
 
export default new Router({
  routes: [              //配置路由，这里是个数组
    {                    //每一个链接都是一个对象
      path: '/',         //链接路径
      name: 'Hello',     //路由名称，
      component: Hello   //对应的组件模板
    }，{
      path:'/hi',
      component:Hi,
      children:[        //子路由,嵌套路由 （此处偷个懒，免得单独再列一点）
        {path:'/',component:Hi},
        {path:'hi1',component:Hi1},
        {path:'hi2',component:Hi2},
      ]
    }
  ]
})

二.声明式导航(跳转)

在说明声明式导航之前,先说明router-link 与 router-view

1.router-link 是一个组件，它默认会被渲染成一个带有链接的a标签，通过to属性指定链接地址。
注意：被选中的router-link将自动添加一个class属性值.router-link-active(如下显示:)

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

<router-link to="/">[text]</router-link>

to：导航路径，要填写的是你在router/index.js文件里配置的path值，如果要导航到默认首页，只需要写成 to="/" ，
[text] ：就是我们要显示给用户的导航名称。

2.router-view 用于渲染匹配到的组件。(延伸)

①.可以给router-view组件设置transition过渡（Vue2.0 Transition常见用法全解惑）。

 
<transition name="fade">
  <router-view ></router-view>
</transition>

css过渡类名：
组件过渡过程中，会有四个CSS类名进行切换，这四个类名与transition的name属性有关，比如name="fade",会有如下四个CSS类名：

fade-enter:进入过渡的开始状态，元素被插入时生效，只应用一帧后立刻删除。
fade-enter-active:进入过渡的结束状态，元素被插入时就生效，在过渡过程完成后移除。
fade-leave:离开过渡的开始状态，元素被删除时触发，只应用一帧后立刻删除。
fade-leave-active:离开过渡的结束状态，元素被删除时生效，离开过渡完成后被删除。

从上面四个类名可以看出，fade-enter-active和fade-leave-active在整个进入或离开过程中都有效，所以CSS的transition属性在这两个类下进行设置。

过渡模式mode：

in-out(mode默认in-out模式）：新元素先进入过渡，完成之后当前元素过渡离开。
out-in：当前元素先进行过渡离开，离开完成后新元素过渡进入。

②.还可以配合<keep-alive>使用，keep-alive可以缓存数据，这样不至于重新渲染路由组件的时候，之前那个路由组件的数据被清除了。比如对当前的路由组件a进行了一些DOM操作之后，点击进入另一个路由组件b，再回到路由组件a的时候之前的DOM操作还保存在，如果不加keep-alive再回到路由组件a时，之前的DOM操作就没有了，得重新进行。如果你的应用里有一个购物车组件，就需要用到keep-alive。

<transition>
  <keep-alive>
    <router-view></router-view>
  </keep-alive>
</transition>

进入正题:

2.1声明式导航 - 基础使用

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

vue-router提供了一个全局组件 router-link
router-link实质上最终会渲染成a链接 to属性等价于提供 href属性(to无需#)
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.参数名

步骤:

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

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

2.路由定义 (在路由规则中添加)

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

3.导航跳转, 传值给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.1编程式导航 - 基础使用

目标: 用JS代码来进行跳转(声明式利用to)

语法:

this.$router.push({path: "路由路径"})

this.$router.push({name: "路由名"})

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

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

2.App.vue - 配合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>
// 注意:
// 虽然用name跳转, 但是url的hash值还是切换path路径值
// 场景:
// 方便修改: name路由名(在页面上看不见随便定义)
// path可以在url的hash值看到(尽量符合组内规范)

export default {
  methods: {
    btn(targetPath, targetName){
      this.$router.push({
        // path: targetPath, // 方式1: path跳转
        name: targetName     // 方式2:name跳转
      })
    }
  }
};
</script>

3.2编程式导航 - 跳转传参

语法:

// 对应路由接收 $route.params.参数名取值
// 对应路由接收 $route.query.参数名取值

// 重要: path会自动忽略params
// 推荐: name+query方式传参
// 注意: 如果当前url上"hash值和?参数"与你要跳转到的"hash值和?参数"一致, 爆出冗余导航的问题, 不会跳转路由

在app.vue中

<template>
  <div>
    <div class="footer_wrap">
      <span @click="$router.push({ path: '/find' })">发现音乐</span>
      <span @click="$router.push({ path: '/my' })">我的音乐</span>
      <span @click="btn('Part')">朋友1</span>
      <span @click="oneBtn">朋友2</span>
      <span @click="twoBtn">朋友3</span>
    </div>
    <div class="top">
      <router-view></router-view>
    </div>
  </div>
</template>

<script>
export default {
  methods: {
    // 1.点击,传递name参数  匹配路由规则中符合name属性值的
    btn(uname) {
      // push方式可以保存历史记录,可以直接点击返回,前进
      // replace方式 不保存历史记录
      
        this.$router.push({
        name: uname,
        // path: targetPath,
      });
    },
    //2.path方式(接收得用query)

    oneBtn() {
      this.$router.push({
        // path: "/part/?name=小小", 
        //查询字符串形式传参,用$route.query.name接收
        
        path: "/part/reere",
         //用动态参数的形式传参,在路由规则中配置 path: '/part/:uname'后,用$route.params.uname接收参数,
        
        // 也可以单独用query的方式传递参数
        // query: {
        //   name: "dada",
        // },
      });
    },
    twoBtn() {
      this.$router.push({
        name: "Part", //路由对象中需要有 匹配的组件
        // 以params传递参数,在对应的组件中就需要用$route.params.属性名
        params: {
          uname: "小传",
        },
        // 以params传递参数,在对应的组件中就需要用$route.query.属性名
        query: {
          name: "小智",
        },
      });
    },
  },
};
</script>

在Part.vue 组件中

<template>
  <div>
    <p>关注明星</p>
    <p>发现精彩</p>
    <p>寻找伙伴</p>
    <p>
      查询字符串传值 接收:{{ $route.query.name }}-------动态传值 接收:{{
        $route.params.uname
      }}
    </p>
  </div>
</template>

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

<style>
</style>

在路由规则中:

{
        path: '/find',
        component: Find,
        children: [{
                path: "recommend",
                component: Recommend
            },
            {
                path: "ranking",
                component: Ranking
            },
            {
                path: "songlist",
                component: SongList
            }
        ]
    },
    {
        path: '/my',
        component: My
    },
    {
        path: '/part',
        name: 'Part',
        component: Part
    },
    // 动态参数的值传递时,需要 配置规则数组
    {
        path: '/part/:uname',
        component: Part
    },

四.vue路由的重定向

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

网页打开url默认hash值是/路径
redirect是设置要重定向到哪个路由路径

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

定义路由 - 404页面

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

1.创建NotFound页面

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

<script>
export default {

}
</script>

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

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

import NotFound from '@/views/NotFound'

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

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

五.路由 - 模式设置

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

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

const router = new VueRouter({
  routes,
  mode: "history" // 打包上线后需要后台支持, 模式是hash
})

五.vue路由 - 嵌套和守卫

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

router-view嵌套架构图

创建需要用的所有组件

src/views/Find.vue -- 发现音乐页

src/views/My.vue -- 我的音乐页

src/views/Second/Recommend.vue -- 发现音乐页 / 推荐页面

src/views/Second/Ranking.vue -- 发现音乐页 / 排行榜页面

src/views/Second/SongList.vue -- 发现音乐页 / 歌单页面
main.js– 继续配置2级路由

一级路由path从/开始定义

二级路由往后path直接写名字, 无需/开头

嵌套路由在上级路由的children数组里编写路由信息对象
说明：

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

Find.vue的的router-view负责发现音乐下的, 三个页面, 切换

1.配置二级导航和样式 - 在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>

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

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

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

只要路由值发生改变,找路由匹配规则===匹配成功找到对应组件之后===找坑位(router-view)

六.全局前置守卫

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

在路由对象上使用固定方法beforeEach(钩子函数)

目标: 路由守卫
场景: 当你要对路由权限判断时
语法: router.beforeEach((to, from, next)=>{//路由跳转"之前"先执行这里, 决定是否跳转})

// 参数1: 要跳转到的路由 (路由对象信息) 目标
// 参数2: 从哪里跳转的路由 (路由对象信息) 来源
// 参数3: 函数体 - next()才会让路由正常的跳转切换, next(false)在原地停留, next("强制修改到另一个路由路径上")
// 注意: 如果不调用next, 页面留在原地

const isLogin = false; // 登录状态(未登录)
router.beforeEach((to, from, next) => {
  if (to.path === "/my" && isLogin === false) {
    alert("请登录")
    next(false) // 阻止路由跳转
  } else {
    next() // 正常放行
  }
})

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

补充:

1.在二级路由的path设置时,如果不带'/' ,则会以父路由的路径开头进行拼接

如果带上'/'则直接以此进行跳转,不会带上父路由的路径(子组件需要在父组件的占位符中显示)

2.this.$router实际上就是全局路由对象,任何页面都可以调用push(),go()等方法

this.$route表示当前正在用于跳转的路由对象,可以调用其name,path,query,params等属性

码农公寓