1.19 动态路由

1.19.1 概述

添加路由到你的路由上通常是通过 ​​routes​​​，但是在某些情况下，你可能想在应用程序已经运行的时候添加或删除路由。具有可扩展接口(如 ​​Vue CLI UI​​ )这样的应用程序可以使用它来扩展应用程序。

1.19.2 添加路由

动态路由主要通过两个函数实现。​​router.addRoute()​​​ 和 ​​router.removeRoute()​​。它们只注册一个新的路由，也就是说，如果新增加的路由与当前位置相匹配，就需要你用 ​​router.push()​​​ 或 ​​router.replace()​​ 来手动导航，才能显示该新路由。我们来看一个例子：

想象一下，只有一个路由的以下路由：

const router = createRouter({
  history: createWebHistory(),
  routes: [{ path: '/:articleName', component: Article }],
})

进入任何页面，​​/about​​​，​​/store​​​，或者 ​​/3-tricks-to-improve-your-routing-code​​​ 最终都会呈现 ​​Article​​​ 组件。如果我们在 ​​/about​​ 上添加一个新的路由：

router.addRoute({ path: '/about', component: About })

页面仍然会显示 ​​Article​​​ 组件，我们需要手动调用 ​​router.replace()​​ 来改变当前的位置，并覆盖我们原来的位置（而不是添加一个新的路由，最后在我们的历史中两次出现在同一个位置）：

router.addRoute({ path: '/about', component: About })
// 我们也可以使用 this.$route 或 route = useRoute() （在 setup 中）
router.replace(router.currentRoute.value.fullPath)

记住，如果你需要等待新的路由显示，可以使用 ​​await router.replace()​​。

1.19.3 在导航守卫中添加路由

如果你决定在导航守卫内部添加或删除路由，你不应该调用 ​​router.replace()​​，而是通过返回新的位置来触发重定向：

router.beforeEach(to => {
  if (!hasNecessaryRoute(to)) {
    router.addRoute(generateRoute(to))
    // 触发重定向
    return to.fullPath
  }
})

上面的例子有两个假设：第一，新添加的路由记录将与 ​​to​​​ 位置相匹配，实际上导致与我们试图访问的位置不同。第二，​​hasNecessaryRoute()​​​ 在添加新的路由后返回 ​​false​​，以避免无限重定向。

因为是在重定向中，所以我们是在替换将要跳转的导航，实际上行为就像之前的例子一样。而在实际场景中，添加路由的行为更有可能发生在导航守卫之外，例如，当一个视图组件挂载时，它会注册新的路由。

1.19.4 删除路由

有几个不同的方法来删除现有的路由：

  • 通过添加一个名称冲突的路由。如果添加与现有途径名称相同的途径，会先删除路由，再添加路由：
router.addRoute({ path: '/about', name: 'about', component: About })
// 这将会删除之前已经添加的路由，因为他们具有相同的名字且名字必须是唯一的
router.addRoute({ path: '/other', name: 'about', component: Other })
  • 通过调用 ​​router.addRoute()​​ 返回的回调：（当路由没有名称时，这很有用）
const removeRoute = router.addRoute(routeRecord)
removeRoute() // 删除路由如果存在的话
  • 通过使用 ​​router.removeRoute()​​ 按名称删除路由：
router.addRoute({ path: '/about', name: 'about', component: About })
// 删除路由
router.removeRoute('about')

需要注意的是，如果你想使用这个功能，但又想避免名字的冲突，可以在路由中使用 ​​Symbol​​ 作为名字。

当路由被删除时，所有的别名和子路由也会被同时删除

1.19.5 添加嵌套路由

要将嵌套路由添加到现有的路由中，可以将路由的 name 作为第一个参数传递给 ​​router.addRoute()​​​，这将有效地添加路由，就像通过 ​​children​​ 添加的一样：

router.addRoute({ name: 'admin', path: '/admin', component: Admin })
router.addRoute('admin', { path: 'settings', component: AdminSettings })

这等效于：

router.addRoute({
  name: 'admin',
  path: '/admin',
  component: Admin,
  children: [{ path: 'settings', component: AdminSettings }],
})

1.19.6 查看现有路由

Vue Router 提供了两个功能来查看现有的路由：

1.20 总结

之前使用过 Vue Router ， 只是不太全面，也通过课程学习了一遍，发现在线课程内教的内容非常少，仅仅是一少部分常用的功能，因此我就想把全部的功能都过一遍，有个印象。发现《Vue.js 3.0 从入门到实践》这本书内容很全，就跟着学，后来发现特别是后面的部分，书竟然完全抄的是官方文档！哈哈哈！我也逐渐转向了查看官方文档，官方文档比书里面的内容更多，只是书里面有些常用的功能做了代码演示。这篇文档，包含官方文档、书籍里面的代码演示以及本人自己进行的代码演示，当然后面的部分不是特别常用的功能，我也是 copy 的官方文档，哈哈！学习一遍，建立初步印象，并在此记录，以备后续查询吧！