Vue3 中路由Vue Router 的使用实例详解

npm install vue-router@4

// router/index.js

import { createRouter, createWebHistory } from "vue-router";
import HomeView from '@/views/HomeView.vue'

// 创建路由规则
let routes = [
    {
        path: '/', // URL 地址
        name: 'home',  // 名称
        component: HomeView  // 渲染该组件
    },
]

// 创建路由
const router = createRouter({
    // 使用 history 模式
    history: createWebHistory(),
    // 路由规则
    routes
})

// 将路由对象暴露出去
export default router
// main.js

import { createApp } from 'vue'
import App from './App.vue'
import router from './router'  // 引入路由模块
let app = createApp(App)

app.use(router) // 初始化路由插件

app.mount('#app')

<template>
	<!--   路由链接，点击是路由地址会切换到属性 to 的地方   -->
    <router-link to="/">首页</router-link>
    |
    <router-link to="/blog">博客</router-link>
    <hr>
	<!--   路由试图，路由切换组件的地方   -->
    <router-view/>
</template>

// 路径写法
const routes = [{ path: '/home', redirect: '/' }]
// 命名写法
const routes = [{ path: '/home', redirect: { name: 'home' } }]
]

// alias是别名的key
const routes = [{ path: '/', component: HomeView, alias: '/home' }]

// router/index.js

{
    path: '/father',
    name: 'father',
    component:  () => import('@/views/father.vue'),
    // 嵌套路由
    children: [
        {
            path: 'son', // path 前面不要加 /
            name: 'son',
            component: () => import('@/views/son.vue')
        },
    ]
}


// father.vue 页面
<template>  
    <div class="school">
        我是 father 页面：
        <router-link to="/father/son">子页面</router-link>
        <hr>
		<!-- 该组件中自己的路由视图 -->
        <router-view />
    </div>
</template>

// router/index.js
{
    path: '/father',
    name: 'father',
    component:  () => import('@/views/father.vue'),
    // 嵌套路由
    children: [
        {
            path: 'son/:id', // path 前面不要加 / （路径传参）
            name: 'son',
            component: () => import('@/views/son.vue'),
            props: true  // 将路径参数传递到展示组件的 props 中
        },
    ]
}


// father.vue
<template>  
    <div class="school">
        我是 father 页面：
        <router-link to="/father/son">子页面</router-link>
        <hr>
		<!-- 该组件中自己的路由视图 -->
        <router-view />
    </div>
</template>


// son.vue 选项式
<script>
export default {
    // 通过 props 来接收路径参数
    props: { id: String },
    methods: {
        showRouteParams() {
            // 通过 `this.$route.params` 获取路径参数
            console.log(this.$route.params)
          	// 取出指定的路径参数
            console.log(this.$route.params.id)
            // 输出 props 中得到的路径参数
            console.log("输出 props 中得到的路径参数：" + this.id)
        }
    }
}
</script>

<template>
    <div class="math">
        我是 BlogContent 页面
        <ul>
            <li>通过 `this.$route.params` 获取路径参数 -- {{ $route.params }}</li>
            <li>取出指定的路径参数 -- {{ $route.params.id }}</li>
            <li>输出 props 中得到的路径参数 id -- {{ id }}</li>
        </ul>
        <button @click="showRouteParams">在 JS 中访问路径参数</button>
    </div>
</template>


// son.vue 组合式
<script setup>
import { useRoute } from 'vue-router'

// 通过 props 来接收路径参数
let propsData = defineProps({ id: String })

// 获取路由跳转对象
let route = useRoute()

function showRouteParams() {
    console.log(route.params) // 通过 `route` 获取路径参数
    console.log(route.params.id) // 取出指定的路径参数
    console.log("输出 props 中得到的路径参数：" + propsData.id)
}
</script>

<template>
    <div class="math">
        我是 BlogContent 页面
        <ul>
            <li>通过 `route` 获取路径参数 -- {{ route.params }}</li>
            <li>取出指定的路径参数：{{ route.params.id }}</li>
            <li>输出 props 中得到的路径参数 id -- {{ id }}</li>
        </ul>
        <button @click="showRouteParams">在 JS 中访问路径参数</button>
    </div>
</template>

// 编程式导航
const username = 'eduardo'

// 我们可以手动建立 url，但我们必须自己处理编码
router.push(`/user/${username}`) // -> /user/eduardo

// 同样
router.push({ path: `/user/${username}` }) // -> /user/eduardo

// 如果可能的话，使用 `name` 和 `params` 从自动 URL 编码中获益（params名必须和 router规则中的名一致）
router.push({ name: 'user', params: { username } }) // -> /user/eduardo

// `params` 不能与 `path` 一起使用
router.push({ path: '/user', params: { username } }) // -> /user

router.push({ path: '/home', replace: true })

// 相当于
router.replace({ path: '/home' })

// 向前移动一条记录，与 router.forward() 相同
router.go(1)

// 返回一条记录，与 router.back() 相同
router.go(-1)

// 前进 3 条记录
router.go(3)

// 如果没有那么多记录，静默失败
router.go(-100)
router.go(100)