Skip to content

toRefs

Category
Export Size
451 B
Last Changed
15 minutes ago

扩展了 toRefs,还接受对象引用的 refs。

用法

ts
import { toRefs } from '@vueuse/core'
import { reactive, ref } from 'vue'

const objRef = ref({ a: 'a', b: 0 })
const arrRef = ref(['a', 0])

const { a, b } = toRefs(objRef)
const [a, b] = toRefs(arrRef)

const obj = reactive({ a: 'a', b: 0 })
const arr = reactive(['a', 0])

const { a, b } = toRefs(obj)
const [a, b] = toRefs(arr)

使用场景

解构 props 对象

vue
<script lang="ts">
import { toRefs, useVModel } from '@vueuse/core'

export default {
  setup(props) {
    const refs = toRefs(useVModel(props, 'data'))

    console.log(refs.a.value) // props.data.a
    refs.a.value = 'a' // emit('update:data', { ...props.data, a: 'a' })

    return { ...refs }
  }
}
</script>

<template>
  <div>
    <input v-model="a" type="text">
    <input v-model="b" type="text">
  </div>
</template>

类型声明

typescript
export interface ToRefsOptions {
  /**
   * 当属性更新时,是否用副本替换原始的 ref。
   *
   * @default true
   */
  replaceRef?: MaybeRefOrGetter<boolean>
}
/**
 * 扩展的 `toRefs`,还接受对象的 ref。
 *
 * @see https://vueuse.org/toRefs
 * @param objectRef 一个 ref 或普通对象或数组。
 */
export declare function toRefs<T extends object>(
  objectRef: MaybeRef<T>,
  options?: ToRefsOptions,
): ToRefs<T>

Source

SourceDocs

贡献者

Anthony Fu
丶远方
Anthony Fu
Aaron-zon
Kasper Seweryn
ByMykel
vaakian X
chaii3
webfansplz
William T. Kirby

变更日志

v10.3.0 on 7/30/2023
5309c - fix: don't trigger unwanted watchEffects (#3260)
v10.2.1 on 6/28/2023
9f998 - fix: fix stack overflow caused by recursive setPrototypeOf (#3166)

Released under the MIT License.