当前位置：首页 > news >正文

《Vue Router实战教程》3.动态路由匹配

news 来源：原创 2025/9/14 21:34:44

欢迎观看《Vue Router 实战（第4版）》视频课程

1. 动态路由匹配

带参数的动态路由匹配

很多时候，我们需要将给定匹配模式的路由映射到同一个组件。例如，我们可能有一个 User 组件，它应该对所有用户进行渲染，但用户 ID 不同。在 Vue Router 中，我们可以在路径中使用一个动态字段来实现，我们称之为路径参数：

import User from './User.vue'

// 这些都会传递给 `createRouter`

const routes = [

// 动态字段以冒号开始

{ path: '/users/:id', component: User },

]

现在像 /users/johnny 和 /users/jolyne 这样的 URL 都会映射到同一个路由。

路径参数用冒号 : 表示。当一个路由被匹配时，它的 params 的值将在每个组件中以 route.params 的形式暴露出来。因此，我们可以通过更新 User 的模板来呈现当前的用户 ID：

<div>

User {{ $route.params.id }}

</div>

</template>

你可以在同一个路由中设置有多个路径参数，它们会映射到 $route.params 上的相应字段。例如：

匹配模式	匹配路径	route.params
/users/:username	/users/eduardo	{ username: 'eduardo' }
/users/:username/posts/:postId	/users/eduardo/posts/123	{ username: 'eduardo', postId: '123' }

除了 route.params 之外，route 对象还公开了其他有用的信息，如 route.query（如果 URL 中存在参数）、route.hash 等。你可以在 API 参考中查看完整的细节。

这个例子的 demo 可以在这里找到。

1. 1. 响应路由参数的变化

使用带有参数的路由时需要注意的是，当用户从 /users/johnny 导航到 /users/jolyne 时，相同的组件实例将被重复使用。因为两个路由都渲染同个组件，比起销毁再创建，复用则显得更加高效。不过，这也意味着组件的生命周期钩子不会被调用。

要对同一个组件中参数的变化做出响应的话，你可以简单地 watch $route 对象上的任意属性，在这个场景中，就是 $route.params ：

Composition API

import { watch } from 'vue'

import { useRoute } from 'vue-router'

const route = useRoute()

watch(() => route.params.id, (newId, oldId) => {

// 对路由变化做出响应...

})

</script>

Options API

export default {

created() {

this.$watch(

() => this.$route.params.id,

(newId, oldId) => {

// 对路由变化做出响应...

}

)

}

</script>

或者，使用 beforeRouteUpdate 导航守卫，它还允许你取消导航：

Composition API

import { onBeforeRouteUpdate } from 'vue-router'

// ...

onBeforeRouteUpdate(async (to, from) => {

// 对路由变化做出响应...

userData.value = await fetchUser(to.params.id)

})

</script>

Options API

export default {

async beforeRouteUpdate(to, from) {

// 对路由变化做出响应...

this.userData = await fetchUser(to.params.id)

// ...

}

</script>

1. 1. 捕获所有路由或 404 Not found 路由

常规参数只匹配 url 片段之间的字符，用 / 分隔。如果我们想匹配任意路径，我们可以使用自定义的路径参数正则表达式，在路径参数后面的括号中加入正则表达式 :

const routes = [

// 将匹配所有内容并将其放在 `route.params.pathMatch` 下

{ path: '/:pathMatch(.*)*', name: 'NotFound', component: NotFound },

// 将匹配以 `/user-` 开头的所有内容，并将其放在 `route.params.afterUser` 下

{ path: '/user-:afterUser(.*)', component: UserGeneric },

]

在这个特定的场景中，我们在括号之间使用了自定义正则表达式，并将pathMatch 参数标记为可选可重复。这样做是为了让我们在需要的时候，可以通过将 path 拆分成一个数组，直接导航到路由：

router.push({

name: 'NotFound',

// 保留当前路径并删除第一个字符，以避免目标 URL 以 `//` 开头。

params: { pathMatch: this.$route.path.substring(1).split('/') },

// 保留现有的查询和 hash 值，如果有的话

query: route.query,

hash: route.hash,

})

更多内容请参见重复参数部分。

如果你正在使用历史模式，请务必按照说明正确配置你的服务器。

1. 1. 高级匹配模式

Vue Router 使用自己的路径匹配语法，其灵感来自于 express，因此它支持许多高级匹配模式，如可选的参数，零或多个 / 一个或多个，甚至自定义的正则匹配规则。请查看高级匹配文档来探索它们。

欢迎观看《Vue Router 实战（第4版）》视频课程

相关文章：