useRouteParams

类别

@Router

导出体积

612 B

依赖包

@vueuse/router

上次更改

2 weeks ago

对响应式的 route.params 的简写。 Available in the @vueuse/router add-on.

用法

import { useRouteParams } from '@vueuse/router'

const userId = useRouteParams('userId')

const userId = useRouteParams('userId', '-1') // 或者带有默认值

const userId = useRouteParams('page', '1', { transform: Number }) // 或者进行值转换

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>

源码

源码 • 文档

贡献者

一纸忘忧

Antério Vieira

Anthony Fu

Anthony Fu

Lindsay Gaines

huiliangShen

Manoah Tervoort

Shean de Montigny-Desautels

Eduardo Wesley

Dvir Hazout

Curt Grimes

DevilTea

更新日志

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

965bf - fix(useRouteHash, useRouteParams, useRouteQuery): fix effect triggering multiple times (#4113)

v10.10.0 on 5/27/2024

4a882 - fix: support optional params (#3934)

v10.8.0 on 2/20/2024

c44fe - fix(useRouteParams,useRouteQuery): set route param/query to undefined when null or defaultValue (#3583)

v10.6.0 on 11/9/2023

771e7 - fix(useRouteQuery,useRouteParams): prevent reset on other scope dispose (#3418)

v10.3.0 on 7/30/2023

0d02f - fix(router): improves router functions: synchronize values, adds tests, and optimize performance (#3184)

v10.2.0 on 6/16/2023

d5252 - fix(useRouteHash,useRouteQuery,useRouteParams): re-evaluates the value immediately (#3002)

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

d23ca - feat(useRouteQuery,useRouteParams): new transform handler (#2191)

v9.4.0 on 10/25/2022

be36a - fix(useRouteHash, useRouteParams, useRouteQuery): override only selected route param (#2350)