refDebounced

分类

响应性

导出大小

451 B

上次更改

上个月

别名

useDebouncedebouncedRef

演示

源码演练场 (beta)

此演示的延迟设置为 1000 毫秒。

防抖

更新次数：0

用法

import { refDebounced
 } from '@vueuse/core'
import { shallowRef
 } from 'vue'

const input
 = shallowRef
('foo')
const debounced
 = refDebounced
(input
, 1000)

input
.value
 = 'bar'
console
.log
(debounced
.value
) // 'foo'

await sleep
(1100)

console
.log
(debounced
.value
) // 'bar'

一个对象 ref 的例子。

import { refDebounced } from '@vueuse/core'
import { shallowRef } from 'vue'

const data = shallowRef({
  name: 'foo',
  age: 18,
})
const debounced = refDebounced(data, 1000)

function update() {
  data.value = {
    ...data.value,
    name: 'bar',
  }
}

console.log(debounced.value) // { name: 'foo', age: 18 }
update()
await sleep(1100)

console.log(debounced.value) // { name: 'bar', age: 18 }

你也可以传入一个可选的第三个参数，包括 maxWait 选项。详见 useDebounceFn。

类型声明

export type RefDebouncedReturn
<T
 = any> = Readonly
<Ref
<T
>>
/**
 * Debounce updates of a ref.
 *
 * @return A new debounced ref.
 */
export declare function refDebounced
<T
>(
  value
: Ref
<T
>,
  ms
?: MaybeRefOrGetter
<number>,
  options
?: DebounceFilterOptions
,
): RefDebouncedReturn
<T
>
/** @deprecated use `refDebounced` instead */
export declare const debouncedRef
: typeof refDebounced

/** @deprecated use `refDebounced` instead */
export declare const useDebounce
: typeof refDebounced