toRef
Normalize value/ref/getter to ref
or computed
.
Usage
ts
import { toRef } from '@vueuse/core'
const foo = ref('hi')
const a = toRef(0) // Ref<number>
const b = toRef(foo) // Ref<string>
const c = toRef(() => 'hi') // ComputedRef<string>
Type Declarations
typescript
/**
* Normalize value/ref/getter to `ref` or `computed`.
*/
export declare function toRef<T>(r: () => T): Readonly<Ref<T>>
export declare function toRef<T>(r: ComputedRef<T>): ComputedRef<T>
export declare function toRef<T>(r: MaybeRefOrGetter<T>): Ref<T>
export declare function toRef<T>(r: T): Ref<T>
export declare function toRef<T extends object, K extends keyof T>(
object: T,
key: K,
): ToRef<T[K]>
export declare function toRef<T extends object, K extends keyof T>(
object: T,
key: K,
defaultValue: T[K],
): ToRef<Exclude<T[K], undefined>>
/**
* @deprecated use `toRef` instead
*/
export declare const resolveRef: typeof toRef
Source
Contributors
Changelog
v13.0.0
on 2025/3/10v12.8.0
on 2025/3/5v12.0.0-beta.1
on 2024/11/21v10.0.0
on 2023/4/14v10.0.0-beta.4
on 2023/4/134d757
- feat(types)!: 將 MaybeComputedRef
重新命名為 MaybeRefOrGetter
f307f
- feat: 支援來自 Vue 的雙參數覆蓋10e98
- feat!: 將 resolveRef
重新命名為 toRef