vue3使用vue-router的方法

# 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支持兩種路由模式：

1. history模式（推薦）：

createWebHistory()

1. 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')
})

十二、最佳實踐

1. 將路由配置拆分到單獨的文件中
2. 使用命名路由代替硬編碼路徑
3. 合理使用路由懶加載提升性能
4. 對需要認證的路由使用路由守衛
5. 為路由添加適當的元信息

結語

vue-router是Vue生態中非常重要的組成部分，掌握它的使用方法對于開發Vue單頁應用至關重要。本文介紹了vue-router在Vue3中的基本使用方法，包括安裝配置、路由導航、參數傳遞、嵌套路由、路由守衛等核心功能。希望這些內容能幫助你在Vue3項目中更好地使用vue-router。

隨著項目的復雜度增加，你可能還需要了解更多高級特性，如路由過渡動畫、數據獲取策略等。vue-router官方文檔是最佳的學習資源，建議在掌握基礎后進一步深入學習。 “`