refThrottled
参考值的节流变化。
¥Throttle changing of a ref value.
示例
用法
¥Usage
js
import { refThrottled } from '@vueuse/core'
import { shallowRef } from 'vue'
const input = shallowRef('')
const throttled = refThrottled(input, 1000)
一个使用对象引用的示例。
¥An example with object ref.
js
import { refThrottled } from '@vueuse/core'
import { shallowRef } from 'vue'
const data = shallowRef({
count: 0,
name: 'foo',
})
const throttled = refThrottled(data, 1000)
data.value = { count: 1, name: 'foo' }
console.log(throttled.value) // { count: 1, name: 'foo' } (immediate)
data.value = { count: 2, name: 'bar' }
data.value = { count: 3, name: 'baz' }
data.value = { count: 4, name: 'qux' }
console.log(throttled.value) // { count: 1, name: 'foo' } (still first value)
// After 1000ms, next change will be applied
await sleep(1100)
data.value = { count: 5, name: 'final' }
await nextTick()
console.log(throttled.value) // { count: 5, name: 'final' } (updated)
尾随
¥Trailing
如果你不想查看跟踪更改,请设置第三个参数 false
(默认为 true
):
¥If you don't want to watch trailing changes, set 3rd param false
(it's true
by default):
js
import { refThrottled } from '@vueuse/core'
import { shallowRef } from 'vue'
const input = shallowRef('')
const throttled = refThrottled(input, 1000, false)
领导
¥Leading
允许立即调用回调(在 ms
超时的前沿)。如果你不希望出现此行为,请设置第四个参数 false
(默认为 true
):
¥Allows the callback to be invoked immediately (on the leading edge of the ms
timeout). If you don't want this behavior, set the 4th param false
(it's true
by default):
js
import { refThrottled } from '@vueuse/core'
import { shallowRef } from 'vue'
const input = shallowRef('')
const throttled = refThrottled(input, 1000, undefined, false)
推荐阅读
¥Recommended Reading
类型声明
typescript
export type RefThrottledReturn<T = any> = Ref<T>
/**
* Throttle execution of a function. Especially useful for rate limiting
* execution of handlers on events like resize and scroll.
*
* @param value Ref value to be watched with throttle effect
* @param delay A zero-or-greater delay in milliseconds. For event callbacks, values around 100 or 250 (or even higher) are most useful.
* @param trailing if true, update the value again after the delay time is up
* @param leading if true, update the value on the leading edge of the ms timeout
*/
export declare function refThrottled<T = any>(
value: Ref<T>,
delay?: number,
trailing?: boolean,
leading?: boolean,
): RefThrottledReturn<T>
export { refThrottled as throttledRef, refThrottled as useThrottle }