refDebounced

类别

响应性

导出大小

440 B

上次更改

5 天前

别名

useDebouncedebouncedRef

相关

useThrottleFn

延迟 ref 值的执行。

演示

源代码

此演示的延迟设置为 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'

您还可以传递可选的第三个参数，包括 maxWait 选项。 有关详细信息，请参阅 useDebounceFn。

推荐阅读

• 防抖 vs 节流：权威可视化指南

类型声明

/**
 * Debounce updates of a ref.
 *
 * @return A new debounced ref.
 */
export declare function refDebounced<T>(
  value: Ref<T>,
  ms?: MaybeRefOrGetter<number>,
  options?: DebounceFilterOptions,
): Readonly<Ref<T>>
export { refDebounced as debouncedRef, refDebounced as useDebounce }

来源

Source • Demo • Docs

贡献者

Anthony Fu

IlyaL

Anthony Fu

Dominik Klein

更新日志

v12.8.0 于 2025/3/5

7432f - feat(types): 弃用 MaybeRef 和 MaybeRefOrGetter，转而使用 Vue 的原生 (#4636)

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

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

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

4d757 - feat(types)!: 将 MaybeComputedRef 重命名为 MaybeRefOrGetter