Skip to content

useScroll ​

Get the scroll position of an element.

Code demonstration ​

Basic Usage ​

Detect Whole Page Scroll ​

Control listen on scroll status ​

API ​

typescript
const position = useScroll(target, shouldUpdate)

Params ​

PropertyDescriptionTypeDefault
targetDOM element or ref objectElement | Document | (() => Element) | JSX.Elementdocument
shouldUpdateWhether update position({ top: number, left: number }) => boolean-

Result ​

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

Source ​

Source · Document · Demo

Released under the MIT License.