Skip to content
On this page

useScroll

监听元素的滚动位置

代码演示

基础用法

API

javascript
type UseScrollOptions = {
    shouldUpdate?: (value: ScrollPosition) => boolean;
    eventListenerOptions?: AddEventListenerOptions;
    behavior?: ScrollBehavior,
    wait?: number,
}
const { x,y } = useScroll<T extends Target = Document>(
    target: T,
    options?: UseScrollOptions
)
type UseScrollOptions = {
    shouldUpdate?: (value: ScrollPosition) => boolean;
    eventListenerOptions?: AddEventListenerOptions;
    behavior?: ScrollBehavior,
    wait?: number,
}
const { x,y } = useScroll<T extends Target = Document>(
    target: T,
    options?: UseScrollOptions
)

Params

参数说明类型默认值
target必填,DOM 节点或者 ref` ElementDocument
options可选,详见下面的 UseModelOptionsUseScrollOptions-

UseScrollOptions

参数说明类型默认值
shouldUpdate控制是否更新滚动信息({ top: number, left: number }) => boolean-
eventListenerOptions滚动事件的侦听器选项AddEventListenerOptions{capture: false, passive: true}
behavior滚动动画ScrollBehaviorauto
wait滚动事件的限制时间number-