Vue3 的组合式 API 浅谈(三)

396 阅读1分钟

前端路由 Vue Router 在组合式 API 中的使用

引入 setup 的组合式 API,让 Vue3 语法发生较大变化。众所周知,Vue Router 在 vue2 的组件中可以直接使用 this.$routethis.$router 等方法。要想在组合式 API 这一环境下充分使用 Vue Router 的功能,我们需要使用一些新的函数来代替访问 this 和组件内的导航守卫。

在 setup 中访问路由和当前路由

因为在 setup 里面无法访问指向活跃组件的 this,也不能再直接访问this.$router 或 this.$route

作为替代,想要在组件内正常使用 Vue Router 功能,需要使用 useRouteruseRoute 函数:

import { useRouter, useRoute } from 'vue-router'

export default {
  setup() {
    const router = useRouter()
    const route = useRoute()

    function pushQuery(query) {
      router.push({
        name: 'search',
        query: {
          ...route.query,
        },
      })
    }
  },
}

其中, route 对象是一个响应式对象,它的任何属性都可以被监听,但应该避免监听整个 route 对象,以免不必要的频繁触发影响性能。

在大多数情况下,应该直接监听你期望改变的参数。如:

 watch(
      () => route.params.id,
      async newId => {
        userData.value = await fetchUser(newId)
      }
    )

除了 setup 函数内部,在模板其他部分,仍然可以访问 $router 和 $route,所以不需要在 setup 中返回 router 或 route

导航守卫

一种方法是可以通过 setup 函数来使用组件内的导航守卫。

另外, Vue Router 将更新和离开守卫作为组合式 API 函数公开:

import { onBeforeRouteLeave, onBeforeRouteUpdate } from 'vue-router'
import { ref } from 'vue'

export default {
  setup() {
    // 与 beforeRouteLeave 相同,无法访问 `this`
    onBeforeRouteLeave((to, from) => {
      const answer = window.confirm(
        'Do you really want to leave? you have unsaved changes!'
      )
      // 取消导航并停留在同一页面上
      if (!answer) return false
    })

    const userData = ref()

    // 与 beforeRouteUpdate 相同,无法访问 `this`
    onBeforeRouteUpdate(async (to, from) => {
      //仅当 id 更改时才获取用户,例如仅 query 或 hash 值已更改
      if (to.params.id !== from.params.id) {
        userData.value = await fetchUser(to.params.id)
      }
    })
  },
}