vue3使用vue-router的方法

发布时间：2022-05-05 17:54:12 作者：iii
来源：亿速云阅读：2078

# Vue3使用vue-router的方法

## 前言

在Vue3项目中，路由管理是构建单页面应用(SPA)的核心功能之一。vue-router是Vue.js官方的路由管理器，它与Vue.js深度集成，使构建单页应用变得轻而易举。本文将详细介绍在Vue3项目中如何使用vue-router 4.x版本。

## 一、安装vue-router

### 1. 创建Vue3项目
首先确保你已经创建了一个Vue3项目。如果还没有，可以通过以下命令创建：

```bash
npm init vue@latest my-vue-app
# 或
yarn create vue my-vue-app

2. 安装vue-router

在项目目录下运行以下命令安装vue-router：

npm install vue-router@4
# 或
yarn add vue-router@4

二、基本配置

1. 创建路由实例

在src目录下新建router/index.js文件：

import { createRouter, createWebHistory } from 'vue-router'

const routes = [
  {
    path: '/',
    name: 'Home',
    component: () => import('@/views/Home.vue')
  },
  {
    path: '/about',
    name: 'About',
    component: () => import('@/views/About.vue')
  }
]

const router = createRouter({
  history: createWebHistory(),
  routes
})

export default router

2. 在main.js中引入路由

修改main.js文件：

import { createApp } from 'vue'
import App from './App.vue'
import router from './router'

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

3. 添加路由视图

在App.vue中添加<router-view>：

<template>
  <div id="app">
    <nav>
      <router-link to="/">Home</router-link> |
      <router-link to="/about">About</router-link>
    </nav>
    <router-view />
  </div>
</template>

三、路由导航

1. 声明式导航

使用<router-link>组件：

<router-link to="/about">About</router-link>

2. 编程式导航

在组件方法中使用：

// 字符串路径
router.push('/about')

// 带有路径的对象
router.push({ path: '/about' })

// 命名的路由
router.push({ name: 'About' })

// 替换当前路由
router.replace({ path: '/about' })

// 前进/后退
router.go(1) // 前进1步
router.go(-1) // 后退1步

四、路由参数

1. 动态路由

定义带参数的路由：

{
  path: '/user/:id',
  name: 'User',
  component: () => import('@/views/User.vue')
}

在组件中获取参数：

import { useRoute } from 'vue-router'

export default {
  setup() {
    const route = useRoute()
    const userId = route.params.id
    return { userId }
  }
}

2. 查询参数

传递查询参数：

router.push({ path: '/search', query: { q: 'vue' } })

获取查询参数：

const route = useRoute()
const searchQuery = route.query.q

五、嵌套路由

1. 配置嵌套路由

在路由配置中添加children属性：

{
  path: '/user/:id',
  component: () => import('@/views/User.vue'),
  children: [
    {
      path: 'profile',
      component: () => import('@/views/UserProfile.vue')
    },
    {
      path: 'posts',
      component: () => import('@/views/UserPosts.vue')
    }
  ]
}

2. 在父组件中添加`<router-view>`

在User.vue中：

<template>
  <div class="user">
    <h2>User {{ $route.params.id }}</h2>
    <router-link to="/user/1/profile">Profile</router-link>
    <router-link to="/user/1/posts">Posts</router-link>
    
    <router-view />
  </div>
</template>

六、路由守卫

1. 全局前置守卫

router.beforeEach((to, from, next) => {
  // 可以在这里进行权限验证
  if (to.meta.requiresAuth && !isAuthenticated) {
    next('/login')
  } else {
    next()
  }
})

2. 路由独享守卫

{
  path: '/admin',
  component: Admin,
  beforeEnter: (to, from, next) => {
    // 仅针对这个路由的守卫
  }
}

3. 组件内守卫

在组件中使用：

import { onBeforeRouteLeave } from 'vue-router'

export default {
  setup() {
    onBeforeRouteLeave((to, from) => {
      const answer = window.confirm('确定要离开吗？')
      if (!answer) return false
    })
  }
}

七、路由元信息

1. 定义元信息

{
  path: '/admin',
  component: Admin,
  meta: { requiresAuth: true }
}

2. 访问元信息

在导航守卫中：

router.beforeEach((to, from) => {
  if (to.meta.requiresAuth) {
    // 需要认证
  }
})

八、路由懒加载

使用动态导入实现路由懒加载：

{
  path: '/settings',
  component: () => import('@/views/Settings.vue')
}

九、滚动行为

自定义路由切换时的滚动行为：

const router = createRouter({
  history: createWebHistory(),
  routes,
  scrollBehavior(to, from, savedPosition) {
    if (savedPosition) {
      return savedPosition
    } else {
      return { top: 0 }
    }
  }
})

十、路由模式

Vue-router支持两种路由模式：

history模式（推荐）：

createWebHistory()

hash模式：

createWebHashHistory()

十一、常见问题解决

1. 路由重复导航错误

// 在push时捕获错误
router.push('/somewhere').catch(err => {
  if (err.name !== 'NavigationDuplicated') {
    throw err
  }
})

2. 动态添加路由

router.addRoute({
  path: '/new-route',
  component: () => import('@/views/NewRoute.vue')
})

十二、最佳实践

将路由配置拆分到单独的文件中
使用命名路由代替硬编码路径
合理使用路由懒加载提升性能
对需要认证的路由使用路由守卫
为路由添加适当的元信息

结语

vue-router是Vue生态中非常重要的组成部分，掌握它的使用方法对于开发Vue单页应用至关重要。本文介绍了vue-router在Vue3中的基本使用方法，包括安装配置、路由导航、参数传递、嵌套路由、路由守卫等核心功能。希望这些内容能帮助你在Vue3项目中更好地使用vue-router。

随着项目的复杂度增加，你可能还需要了解更多高级特性，如路由过渡动画、数据获取策略等。vue-router官方文档是最佳的学习资源，建议在掌握基础后进一步深入学习。 “`