useRouteParams

类别

@Router

导出大小

496 B

包

@vueuse/router

最后更改

5 天前

响应式 route.params 的简写。在 @vueuse/router 附加组件中可用。

用法

import { useRouteParams } from '@vueuse/router'

const userId = useRouteParams('userId')

const userId = useRouteParams('userId', '-1') // or with a default value

const userId = useRouteParams('page', '1', { transform: Number }) // or transforming value

console.log(userId.value) // route.params.userId
userId.value = '100' // router.replace({ params: { userId: '100' } })

类型声明

export declare function useRouteParams(
  name: string,
): Ref<null | string | string[]>
export declare function useRouteParams<
  T extends RouteParamValueRaw = RouteParamValueRaw,
  K = T,
>(
  name: string,
  defaultValue?: MaybeRefOrGetter<T>,
  options?: ReactiveRouteOptionsWithTransform<T, K>,
): Ref<K>

源码

Source • 文档

贡献者

Anthony Fu

Anthony Fu

Antério Vieira

IlyaL

alexchexes

Stefan Vojvodic

Guillaume Chau

jack-allocate

Lindsay Gaines

huiliangShen

Manoah Tervoort

Shean de Montigny-Desautels

Eduardo Wesley

Dvir Hazout

Curt Grimes

DevilTea

更新日志

v12.8.0 于 2025/3/5

7432f - feat(types): 弃用 MaybeRef 和 MaybeRefOrGetter，支持 Vue 的原生类型 (#4636)

v12.3.0 于 2025/1/2

bba3f - feat(router): 支持部分转换 (#4426)

59f75 - feat(toValue): 弃用来自 @vueuse/shared 的 toValue，支持 Vue 的原生类型

v12.1.0 于 2024/12/22

23fdb - fix(useRouteParams,useRouteQuery): 当 defaultValue 是 ref 或 getter 时，将 route param/query 设置为 undefined (#3977)

v12.0.0-beta.1 于 2024/11/21

0a9ed - feat!: 移除 Vue 2 支持，优化 bundles 并清理代码 (#4349)

v11.3.0 于 2024/11/21

65aa0 - feat(router): 转换 get / set (#4326)

44772 - fix(useRouteParams, useRouteQuery): 使用对象 getter 作为 watch source 时，effect 触发两次 (#4283)

v11.0.0-beta.3 于 2024/8/14

965bf - fix(useRouteHash, useRouteParams, useRouteQuery): 修复 effect 多次触发的问题 (#4113)

v10.10.0 于 2024/5/27

4a882 - fix: 支持可选参数 (#3934)

v10.8.0 于 2024/2/20

c44fe - fix(useRouteParams,useRouteQuery): 当 null 或 defaultValue 时，将 route param/query 设置为 undefined (#3583)

v10.6.0 于 2023/11/9

771e7 - fix(useRouteQuery,useRouteParams): 阻止在其他 scope dispose 时重置 (#3418)

v10.3.0 于 2023/7/30

0d02f - fix(router): 改进 router 函数：同步值，添加测试，并优化性能 (#3184)

v10.2.0 于 2023/6/16

d5252 - fix(useRouteHash,useRouteQuery,useRouteParams): 立即重新评估值 (#3002)

v10.0.0-beta.4 于 2023/4/13

d23ca - feat(useRouteQuery,useRouteParams): 新增 transform 处理程序 (#2191)