5. 编程式的导航this.$router——VueRouter实例

LXLong
122 阅读2分钟

1. 进行路由跳转的两种方式

  • 使用 <router-link> 创建 a 标签
  • 还可以借助 VueRouter 实例this.$router的方法，通过编写代码来实现。

2. router.push(location, onComplete?, onAbort?)

注意：在 Vue 实例内部，可以通过 this.$router 访问路由实例。因此可以调用 this.$router.push。

  • 想要导航到不同的 URL，则使用 router.push 方法。这个方法会向 history 栈添加一个新的记录，所以，当用户点击浏览器后退按钮时，则回到之前的 URL。
  • 当你点击 <router-link> 时，这个方法会在内部调用，因此，点击 <router-link :to="..."> 等同于调用 router.push(...)。
声明式编程式
<router-link :to="...">router.push(...)
  • this.$router.push()方法的参数可以是一个字符串路径，或者一个描述地址的对象。例如：
// 字符串
router.push('home')

// 对象
router.push({ path: 'home' })

// 命名的路由
router.push({ name: 'user', params: { userId: '123' }})

// 带查询参数，变成 /register?plan=private
router.push({ path: 'register', query: { plan: 'private' }})

1.gif

<!DOCTYPE html>
<html>
  <head>
    <title>vue-router</title>
    <script src="https://cdn.jsdelivr.net/npm/vue@2.7.8/dist/vue.js"></script>
    <script src="https://unpkg.com/vue-router@3.1.3/dist/vue-router.js"></script>
  </head>
  <body>
    <div id="app">
      <router-view></router-view>
    </div>
    <script>
      const User = {
        template: `<div class="user">
            <h2>User {{ $route.params.userId }}</h2>
          </div>`
      };
      const Register = {
        template: `<div class="Register">
            <h2>Register {{ $route.query.plan }}</h2>
          </div>`
      };
      const Home = {
        template: `<div class="Home">
            <h2>Home</h2>
          </div>`
      };
      const router = new VueRouter({
        routes: [
          {
            path: "/user/:userId",
            component: User,
            name: "user"
          },
          {
            path: "/home",
            component: Home
          },
          {
            path: "/register",
            component: Register
          }
        ]
      });
      const app = new Vue({
        router,
        el: "#app"
      }).$mount("#app");
    </script>
  </body>
</html>

注意：如果提供了 path，params 会被忽略，上述例子中的 query 并不属于这种情况。这种情况下，你需要提供路由的 name 或手写完整的带有参数的 path：下面例子

const userId = '123'
router.push({ name: 'user', params: { userId }}) // -> /user/123
router.push({ path: `/user/${userId}` }) // -> /user/123
// 这里的 params 不生效
router.push({ path: '/user', params: { userId }}) // -> /user

1.gif

1.gif 同样的规则也适用于 router-link 组件的 to 属性。

  • 在 router.push 或 router.replace 中提供可选的 onComplete 和 onAbort 回调作为第二个和第三个参数。
  • 这些回调将会在导航成功完成 (在所有的异步钩子被解析之后) 或终止 (导航到相同的路由、或在当前导航完成之前导航到另一个不同的路由) 的时候进行相应的调用。
  • 可以省略第二个和第三个参数，此时如果支持 Promise，router.push 或 router.replace 将返回一个 Promise。

注意： 如果目的地和当前路由相同，只有参数发生了改变 (比如从 /users/1 -> /users/2)，你需要使用 beforeRouteUpdate 来响应这个变化 。

3. router.replace(location, onComplete?, onAbort?)

  • 跟 router.push 很像，唯一的不同就是，它不会向 history 添加新记录，而是跟它的方法名一样 —— 替换掉当前的 history 记录。
声明式编程式
<router-link :to="..." replace>router.replace(...)

4.router.go(n)

  • router.go(n)方法的参数是一个整数，意思是在 history 记录中向前或者后退多少步，类似 window.history.go(n)。

例子

// 在浏览器记录中前进一步，等同于 history.forward()
router.go(1)

// 后退一步记录，等同于 history.back()
router.go(-1)

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

// 如果 history 记录不够用，那就默默地失败呗
router.go(-100)
router.go(100)

5. Vue Router 中操作 History

 router.push、 router.replace 和 router.go 跟 window.history.pushState、 window.history.replaceState 和 window.history.go 类似， 实际上它们确实是效仿 window.history API 的。

因此，如果已经熟悉 Browser History APIs ，那么在 Vue Router 中操作 history 也是类似的。

还有，Vue Router 的导航方法 (push、 replace、 go) 在各类路由模式 (history、 hash 和 abstract) 下表现一致。

avatar
文章
阅读
粉丝