Vue----vue-router 的基本使用

---

2 vue-router 的基本使用

2.1 vue-router

vue-router 是 vue.js 官方给出的路由解决方案。它只能结合 vue 项目进行使用，能够轻松的管理 SPA 项目中组件的切换。

2.1.1 vue-router 的版本

vue-router 目前有 3.x 的版本和 4.x 的版本。其中：

vue-router 3.x 只能结合 vue2 进行使用

vue-router 3.x 的官方文档地址：

vue-router 4.x 只能结合 vue3 进行使用

vue-router 4.x 的官方文档地址：

2.2 vue-router 3.x 的基本使用步骤

① 安装 vue-router 包
② 创建路由模块
③ 导入并挂载路由模块
④ 声明路由链接和占位符
⑤ 声明路由的匹配规则

2.2.1 在项目中安装 vue-router

在 vue2 的项目中，安装 vue-router 的命令如下：

npm i vue-router@3.5.2 -S

2.2.2 创建路由模块

在 src 源代码目录下，新建 router/index.js 路由模块，并初始化如下的代码：

// src/router/index.js 就是当前项目的路由模块

// 导入Vue和VueRouter包
import Vue from 'vue'
import VueRouter from 'vue-router'

// 把 VueRouter 安装为 Vue 项目的插件
// Vue.use() 函数的作用，就是来安装插件的
Vue.use(VueRouter)

// 创建路由的实例对象
const router = new VueRouter()

// 向外共享路由的实例对象
export default router

此时路由模块与当前项目还未有联系。

2.2.3 导入并挂载路由模块

在 src/main.js 入口文件中，导入并挂载路由模块。

// 导入路由模块，目的：拿到路由的实例对象
// 在进行模块化导入的时候，如果给定的是文件夹，则默认导入这个文件夹下，名字叫做 index.js 的文件
import router from '@/router'
// 完整的写法如下
// import router from '@/router/index.js'

new Vue({
  render: h => h(App),
  // 在 Vue 项目中，要想把路由用起来，必须把路由实例对象，通过下面的方式进行挂载
  // router: 路由的实例对象
  // router: router,
  // 由于一样可以简写成如下
  router
}).$mount('#app')

此时以及完成了路由的声明和挂载导入，可以使用路由了。

2.2.4 声明路由链接和占位符

    
    
    <router-link to="/home">首页router-link>
    <router-link to="/movie">电影router-link>
    <router-link to="/about">关于router-link>

    
    
    <router-view>router-view>

此时还需要声明路由的匹配规则，才可以实现页面的组件切换。

2.2.5 声明路由的匹配规则

在 src/router/index.js 路由模块中，通过 routes 数组声明路由的匹配规则。
routes 是一个数组，作用：定义 “hash 地址” 与 “组件” 之间的对应关系。

// 导入需要的组件
import Home from '@/components/Home.vue'
import Movie from '@/components/Movie.vue'
import About from '@/components/About.vue'

// 创建路由的实例对象
const router = new VueRouter({
  // routes 是一个数组，作用：定义 “hash 地址” 与 “组件” 之间的对应关系
  routes: [
    // 路由规则
    { path: '/home', component: Home },
    { path: '/movie', component: Movie },
    { path: '/about', component: About }
  ]
})

2.2.6 完成代码

main.js

import Vue from 'vue'
import App from './App2.vue'
// 导入路由模块，目的：拿到路由的实例对象
// 在进行模块化导入的时候，如果给定的是文件夹，则默认导入这个文件夹下，名字叫做 index.js 的文件
import router from '@/router'
// 完整的写法
// import router from '@/router/index.js'

// 导入 bootstrap 样式
import 'bootstrap/dist/css/bootstrap.min.css'
// 全局样式
import '@/assets/global.css'

Vue.config.productionTip = false

new Vue({
  render: h => h(App),
  // 在 Vue 项目中，要想把路由用起来，必须把路由实例对象，通过下面的方式进行挂载
  // router: 路由的实例对象
  // router: router,
  // 由于一样可以简写成如下
  router
}).$mount('#app')

App.vue

<template>
  <div class="app-container">
    <h1>App 组件h1>

    
    
    <router-link to="/home">首页router-link>
    <router-link to="/movie">电影router-link>
    <router-link to="/about">关于router-link>

    
    
    <router-view>router-view>
  div>
template>

<script>
export default {
  name: 'App'
}
script>

<style lang="less" scoped>
.app-container {
  background-color: #efefef;
  overflow: hidden;
  margin: 10px;
  padding: 15px;
  > a {
    margin-right: 10px;
  }
}
style>

src/router/index.js

// src/router/index.js 就是当前项目的路由模块

// 导入Vue和VueRouter包
import Vue from 'vue'
import VueRouter from 'vue-router'

// 导入需要的组件
import Home from '@/components/Home.vue'
import Movie from '@/components/Movie.vue'
import About from '@/components/About.vue'


// 把 VueRouter 安装为 Vue 项目的插件
// Vue.use() 函数的作用，就是来安装插件的
Vue.use(VueRouter)

// 创建路由的实例对象
const router = new VueRouter({
  // routes 是一个数组，作用：定义 “hash 地址” 与 “组件” 之间的对应关系
  routes: [
    // 路由规则
    { path: '/home', component: Home },
    { path: '/movie', component: Movie },
    { path: '/about', component: About }
  ]
})

// 向外共享路由的实例对象
export default router

2.3 vue-router 4.x 的基本使用步骤

① 在项目中安装 vue-router
② 定义路由组件
③ 声明路由链接和占位符
④ 创建路由模块
⑤ 导入并挂载路由模块

2.3.1 在项目中安装 vue-router

在 vue3 的项目中，只能安装并使用 vue-router 4.x。安装的命令如下：

npm i vue-router@next -S

2.3.2 定义路由组件

在项目中定义 MyHome.vue、MyMovie.vue、MyAbout.vue 三个组件，将来要使用 vue-router 来控制它们的展示与切换：

MyHome.vue

<template>
  <div>
    <h3>MyHome 组件h3>
  div>
template>

<script>
export default {
  name: 'MyHome',
}
script>

<style lang="less" scoped>style>

MyMovie.vue

<template>
  <div>
    <h3>MyMovie 组件h3>
  div>
template>

<script>
export default {
  name: 'MyMovie',
}
script>

<style lang="less" scoped>style>

MyAbout.vue

<template>
  <div>
    <h3>MyAbout 组件h3>
  div>
template>

<script>
export default {
  name: 'MyAbout',
}
script>

<style lang="less" scoped>style>

2.3.3 声明路由链接和占位符

可以使用 标签来声明路由链接，并使用 标签来声明路由占位符。

App.vue

<template>
  <div>
    <h1>vue-router 的基本使用h1>
    
    <router-link to="/home">首页router-link> 
    <router-link to="/movie">电影router-link> 
    <router-link to="/about">关于router-link>
    <hr />

    
    <router-view>router-view>
  div>
template>

<script>
export default {
  name: 'MyApp',
}
script>

<style>style>

2.3.4 创建路由模块

在项目中创建 router.js 路由模块，在其中按照如下 5 个步骤创建并得到路由的实例对象：

① 从 vue-router 中按需导入两个方法
② 导入需要使用路由控制的组件
③ 创建路由实例对象
④ 向外共享路由实例对象
⑤ 在 main.js 中导入并挂载路由模块

2.3.4.1 从 vue-router 中按需导入两个方法

//  从 vue-router 中按需导入两个方法
// createRouter 方法用于创建路由的实例对象
// createwebHashHistory 用于指定路由的工作模式hash模式>
import { createRouter, createWebHashHistory } from 'vue-router'

2.3.4.2 导入需要使用路由控制的组件

import Home from './MyHome.vue'
import Movie from './MyMovie.vue'
import About from './MyAbout.vue'

2.3.4.3 创建路由实例对象

// 创建路由对象
const router = createRouter({
  // 指定路由的工作模式
  history: createWebHashHistory(),
  // 声明路由的匹配规则
  routes: [
    { path: '/', redirect: '/home' },
    { path: '/home', component: Home },
    { path: '/movie', component: Movie },
    { path: '/about', component: About },
  ],
})

2.3.4.4 向外共享路由实例对象

// 导出路由对象
export default router

2.3.4.5 完整代码

//  从 vue-router 中按需导入两个方法
import { createRouter, createWebHashHistory } from 'vue-router'

import Home from './MyHome.vue'
import Movie from './MyMovie.vue'
import About from './MyAbout.vue'

// 创建路由对象
const router = createRouter({
  // 指定路由的工作模式
  history: createWebHashHistory(),
  // 声明路由的匹配规则
  routes: [
    { path: '/', redirect: '/home' },
    { path: '/home', component: Home },
    { path: '/movie', component: Movie },
    { path: '/about', component: About },
  ],
})

// 导出路由对象
export default router

2.3.4.6 在 main.js 中导入并挂载路由模块

import { createApp } from 'vue'

// 导入App组件
import App from './components/02.start/App.vue'
//导入路由模块
import router from './components/02.start/router'

const app = createApp(App)

// 挂载路由模块
app.use(router)

app.mount('#app')

完整代码：

//导入创建Vue实例对象的方法
import { createApp } from 'vue'

// 导入App组件
import App from './components/02.start/App.vue'
//导入路由模块
import router from './components/02.start/router'

import './assets/css/bootstrap.css'
import './index.css'

const app = createApp(App)

// 挂载路由模块
app.use(router)

app.mount('#app')