入门
基础
- 动态路由匹配 Dynamic Route Matching
- 路由的匹配语法 Routes' Matching Syntax
- 嵌套路由 Nested Routes
- 编程式导航 Programmatic Navigation
- 命名路由 Named Routes
- 命名视图 Named Views
- 重定向和别名 Redirect and Alias
- 路由组件传参 Passing Props to Route Components
- 不同的历史记录模式 Different History modes
进阶
- 导航守卫 Navigation guards
- 导航故障 Navigation Failures
- 路由元信息 Route Meta Fields
- 数据获取 Data Fetching
- 组合式 API Composition API
- 过渡动效 Transitions
- 滚动行为 Scroll Behavior
- 路由懒加载 Lazy Loading Routes
- 类型化路由 Typed Routes
- 扩展路由链接 Extending RouterLink
- 动态路由 Dynamic Routing
迁移
API 手册
接口
- 历史记录状态 HistoryState
- 导航故障 NavigationFailure
- 导航卫士 NavigationGuard
- 导航卫士下一页 NavigationGuardNext
- 导航卫士用这个 NavigationGuardWithThis
- 导航后 NavigationHookAfter
- 路由位置 RouteLocation
- 路由位置匹配 RouteLocationMatched
- 路由位置规范化 RouteLocationNormalized
- 路线位置规范加载 RouteLocationNormalizedLoaded
- 路由位置选项 RouteLocationOptions
- 路线梅塔 RouteMeta
- 路由记录规范化 RouteRecordNormalized
- 路由器 Router
- 路由器历史 RouterHistory
- 路由器链接配置文件 RouterLinkProps
- 路由器选项 RouterOptions
- 路由器滚动行为 RouterScrollBehavior
- 路由器视图Props RouterViewProps
动态路由匹配 Dynamic Route Matching
很多时候,我们需要将给定匹配模式的路由映射到同一个组件。例如,我们可能有一个 User
组件,它应该对所有用户进行渲染,但用户 ID 不同。在 Vue Router 中,我们可以在路径中使用一个动态字段来实现,我们称之为 路径参数 :
const User = {
template: '<div>User</div>',
}
// 这些都会传递给 `createRouter`
const routes = [
// 动态字段以冒号开始
{ path: '/users/:id', component: User },
]
现在像 /users/johnny
和 /users/jolyne
这样的 URL 都会映射到同一个路由。
路径参数 用冒号 :
表示。当一个路由被匹配时,它的 params 的值将在每个组件中以 this.$route.params
的形式暴露出来。因此,我们可以通过更新 User
的模板来呈现当前的用户 ID:
const User = {
template: '<div>User {{ $route.params.id }}</div>',
}
你可以在同一个路由中设置有多个 路径参数,它们会映射到 $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 可以在这里找到。
响应路由参数的变化
使用带有参数的路由时需要注意的是,当用户从 /users/johnny
导航到 /users/jolyne
时,相同的组件实例将被重复使用。因为两个路由都渲染同个组件,比起销毁再创建,复用则显得更加高效。不过,这也意味着组件的生命周期钩子不会被调用。
要对同一个组件中参数的变化做出响应的话,你可以简单地 watch $route
对象上的任意属性,在这个场景中,就是 $route.params
:
const User = {
template: '...',
created() {
this.$watch(
() => this.$route.params,
(toParams, previousParams) => {
// 对路由变化做出响应...
}
)
},
}
或者,使用 beforeRouteUpdate
导航守卫,它也可以取消导航:
const User = {
template: '...',
async beforeRouteUpdate(to, from) {
// 对路由变化做出响应...
this.userData = await fetchUser(to.params.id)
},
}
捕获所有路由或 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
拆分成一个数组,直接导航到路由:
this.$router.push({
name: 'NotFound',
// 保留当前路径并删除第一个字符,以避免目标 URL 以 `//` 开头。
params: { pathMatch: this.$route.path.substring(1).split('/') },
// 保留现有的查询和 hash 值,如果有的话
query: this.$route.query,
hash: this.$route.hash,
})
更多内容请参见 重复参数 部分。
如果你正在使用历史模式,请务必按照说明正确配置你的服务器。
高级匹配模式
Vue Router 使用自己的路径匹配语法,其灵感来自于 express
,因此它支持许多高级匹配模式,如可选的参数,零或多个 / 一个或多个,甚至自定义的正则匹配规则。请查看高级匹配文档来探索它们。
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论