react-use-scroll-position
v2.0.0
Published
A react hook to use scroll position
Downloads
8,321
Maintainers
Readme
react-use-scroll-position
A react hook to use scroll position.
Usage
In a React functional component:
import React from 'react';
// Usually you would just need to import one of the following
import { useScrollPosition, useScrollXPosition, useScrollYPosition } from 'react-use-scroll-position';
function Example() {
const { x, y } = useScrollPosition();
const scrollX = useScrollXPosition();
const scrollY = useScrollYPosition();
return (
<>
<p>
{x} should equal to {scrollX}.
</p>
<p>
{y} should equal to {scrollY}.
</p>
</>
);
}
In a custom React hook
import { useScrollPosition } from 'react-use-scroll-position';
function useYourImagination() {
const { x, y } = useScrollPosition();
return getSomethingAwesomeWith(x, y);
}
Implementation details
The scroll event handler is throttled by requestAnimationFrame
.