vue3结合ts从零实现vueuse的useRouteQuery方法

 更新时间:2024年03月28日 11:29:21   作者:求知若饥  
这篇文章主要为大家详细介绍了如何使用vue3与ts从零实现一个类vueuse的useRouteQuery方法,并解决vueuse的useRouteQuery方法存在的一些问题,感兴趣的可以了解下

本文将使用vue3ts从零实现一个类vueuseuseRouteQuery方法,接受基本相同的参数(移除了router与route参数),并解决vueuseuseRouteQuery方法存在的一些问题。

使用 vueuse 的 useRouteQuery 碰到的问题

问:为什么不使用vueuse的提供的useRouteQuery方法?

答:因为在使用<KeepAlive>保活的页面级组件之间切换时,在所有组件中使用vueuseuseRouteQuery方法定义的变量都会更新。

例如:打开A页面(保活)后,修改page为2,假设url现在为/pageA?page=2,然后切换到B页面,A页面将会触发watchpage将会更新为默认值,并且每次修改B页面的query都会触发A页面的query更新。代码如下。

import { useRouteQuery } from '@vueuse/router'
import { watch } from 'vue'

// 页面A (KeepAlive)
const page = useRouteQuery('page', 1, { transform: Number })
watch(page, (value) => {
    console.log('page A', value)
})

// 页面B  (KeepAlive)
const pageSize = useRouteQuery('pagesize', 10, { transform: Number })
watch(pageSize, (value) => {
    console.log('page B', value)
})

查看vueuseuseRouteQuery的源码后发现它是根据router对象去保存query信息的,因此每次urlquery变化时,所有已存在的相关变量都会更新。

从零实现一个 useRouteQuery

思考:

  • 监听route.query的变化,在值变化时更新响应式变量的值;
  • 监听响应式变量的变化,在值变化时修改route.query的值;
  • route.query变化时,判断是否是当前页面,不是则跳过更新过程。

1. 简易实现

import { watch, ref, type Ref } from 'vue'
import { useRoute, useRouter } from 'vue-router'

type IQuery = string | number | string[] | null | undefined

/**
 * 获取当前页面的query
 * @param name
 * @param defaultValue
 * @param options
 * @returns
 */
export const useRouteQuery = <T extends IQuery, K extends IQuery = T>(
  name: string,
  defaultValue?: T,
  options: {
    transform?: (value: any) => K
    mode?: 'push' | 'replace'
    isEncodeURIComponent?: boolean
  } = {}
) => {
  const { mode = 'push', transform = (value) => value, isEncodeURIComponent = false } = options

  const route = useRoute()
  const router = useRouter()
  const currentPath = route.path
  const query = ref(defaultValue) as Ref<T | K>

  watch(
  () => route.query[name],
    (value) => {
      // 不是当前页面时不更新
      if (route.path !== currentPath) {
        return
      }
      if (value === undefined) {
        query.value = defaultValue as T
        return
      }
      if (!isEncodeURIComponent) {
        query.value = transform(value)
        return
      }
      query.value = transform(decodeURIComponent(value as string))
    },
    { immediate: true })

  watch(query, (value) => {
    const { params, query: oldQuery, hash } = route
    router[mode]({
      params,
      query: {
        ...oldQuery,
        [name]: isEncodeURIComponent ? encodeURIComponent(value as string) : value
      },
      hash
    })
  })

  return query
}

实际使用过后,我们会发现以上实现存在一些问题:

多个变量同步修改时,route.query上只会保留最后一个修改的响应式变量,代码如下;

import { useRouteQuery } from '@/hooks/useRouteQuery'

const disabled = useRouteQuery('disabled', 0)
const title = useRouteQuery('title', '')

disabled.value = 1
title.value = 'test'
// 预想:?disabled=1&title=test
// 实际:?title=test

特殊值undefinednull经过encodeURIComponent处理后会转换为字符串格式,因此还会带在route.query上,如“?diabled=null&title=undefined”。

2. 完整实现

解决方案:

  • 通过在函数外定义一个队列来保存所有需要更新的值,并异步更新route.query
  • 特殊值不使用encodeURIComponent方法转义。
import { nextTick, watch, ref, type Ref } from 'vue'
import { useRoute, useRouter } from 'vue-router'

type IQuery = string | number | string[] | null | undefined
// 用来保存所有的query
const queriesQueue = new Map<string, Record<string, IQuery>>()
/**
 * 获取当前页面的query
 * @param name
 * @param defaultValue
 * @param options
 * @returns
 */
export const useRouteQuery = <T extends IQuery, K extends IQuery = T>(
  name: string,
  defaultValue?: T,
  options: {
    transform?: (value: any) => K
    mode?: 'push' | 'replace'
    isEncodeURIComponent?: boolean
  } = {}
) => {
  const { mode = 'push', transform = (value) => value, isEncodeURIComponent = false } = options

  const route = useRoute()
  const router = useRouter()
  const currentPath = route.path
  const query = ref(defaultValue) as Ref<T | K>

  watch(
    () => route.query[name],
    (value) => {
      if (route.path !== currentPath) {
        return
      }
      if (value === undefined) {
        query.value = defaultValue as T
        return
      }
      if (!isEncodeURIComponent) {
        query.value = transform(value)
        return
      }
      query.value = transform(decodeURIComponent(value as string))
    },
    { immediate: true })

  const setQueryQueue = (value: IQuery) => {
    const currentPageQueries = queriesQueue.get(currentPath) || {}
    // 特殊值不转义
    if (value === null || value === undefined) {
      currentPageQueries[name] = value
    } else {
      currentPageQueries[name] = isEncodeURIComponent ? encodeURIComponent(value as string) : value
    }

    queriesQueue.set(currentPath, currentPageQueries)
  }

  watch(query, (value) => {
    setQueryQueue(value as IQuery)
    // 异步更新
    nextTick(() => {
      // 获取当前页面所有的query
      const currentPageQueries = queriesQueue.get(currentPath) || {}
      const { params, query: oldQuery, hash } = route
      router[mode]({
        params,
        query: {
          ...oldQuery,
          ...currentPageQueries
        },
        hash
      })
    })
  })

  return query
}

查看完整实现源码

到此这篇关于vue3结合ts从零实现vueuse的useRouteQuery方法的文章就介绍到这了,更多相关vue实现vueuse的useRouteQuery内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 浅谈vue的props,data,computed变化对组件更新的影响

    浅谈vue的props,data,computed变化对组件更新的影响

    本篇文章主要介绍了浅谈vue的props,data,computed变化对组件更新的影响,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-01-01
  • 详解vue父子组件间传值(props)

    详解vue父子组件间传值(props)

    本篇文章主要介绍了详解vue父子组件间传值(props),小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-06-06
  • vue3新拟态组件库开发流程之table组件源码分析

    vue3新拟态组件库开发流程之table组件源码分析

    这篇文章主要介绍了vue3新拟态组件库开发流程——table组件源码,本文通过示例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2023-04-04
  • 深入理解Vue生命周期、手动挂载及挂载子组件

    深入理解Vue生命周期、手动挂载及挂载子组件

    本篇文章主要介绍了深入理解Vue生命周期和手动挂载,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-09-09
  • vue实现购物车抛物线小球动画效果的方法详解

    vue实现购物车抛物线小球动画效果的方法详解

    这篇文章主要介绍了vue实现购物车抛物线小球动画效果的方法,结合实例形式较为详细的分析了vue.js实现抛物线动画效果购物车功能相关原理与操作注意事项,需要的朋友可以参考下
    2019-02-02
  • avue-crud多级复杂的动态表头的实现示例

    avue-crud多级复杂的动态表头的实现示例

    Avue.js 是基于现有的element-ui库进行的二次封装,本文主要介绍了avue-crud多级复杂的动态表头,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-12-12
  • vue.js实现格式化时间并每秒更新显示功能示例

    vue.js实现格式化时间并每秒更新显示功能示例

    这篇文章主要介绍了vue.js实现格式化时间并每秒更新显示功能,结合实例形式分析了vue.js时间格式化显示与基于定时器进行实时更新的相关操作技巧,需要的朋友可以参考下
    2018-07-07
  • vue+openlayers+nodejs+postgis实现轨迹运动效果

    vue+openlayers+nodejs+postgis实现轨迹运动效果

    使用postgres(postgis)数据库以及nodejs作为后台,vue和openlayers做前端,openlayers使用http请求通过nodejs从postgres数据库获取数据,这篇文章主要介绍了vue+openlayers+nodejs+postgis实现轨迹运动,需要的朋友可以参考下
    2024-05-05
  • vue中用qrcode库将超链接生成二维码图片的示例代码

    vue中用qrcode库将超链接生成二维码图片的示例代码

    生成二维码是一种常见的需求,无论是用于商业宣传还是个人分享,二维码都可以提供快速方便的方式来传递信息,在Vue框架中,我们可以使用qrcode库来轻松地生成二维码,本篇博文将介绍如何安装qrcode库,并通过一个实际例子来展示如何生成二维码,需要的朋友可以参考下
    2023-12-12
  • Vue中的directive指令快速使用

    Vue中的directive指令快速使用

    这篇文章主要介绍了Vue中的directive指令快速使用,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-10-10

最新评论