Back to Hooks

useScroll

packages/hooks/src/useScroll/index.en-US.md

3.9.71.2 KB
Original Source

useScroll

Get the scroll position of an element.

Examples

Basic Usage

<code src="./demo/demo1.tsx" />

Detect Whole Page Scroll

<code src="./demo/demo2.tsx" />

Control listen on scroll status

<code src="./demo/demo3.tsx" />

API

typescript
const position = useScroll(target, shouldUpdate);

Params

PropertyDescriptionTypeDefault
targetDOM element or ref objectElement | Document | (() => Element) | MutableRefObject<Element>document
shouldUpdateWhether update position({ top: number, left: number }) => boolean() => true

Result

PropertyDescriptionType
positionThe current scroll position of the element.{ left: number, top: number } | undefined