Introduction
react-lenis provides a <ReactLenis>
component that creates a Lenis instance and provides it to its children via context. This allows you to use Lenis in your React app without worrying about passing the instance down through props. It also provides a useLenis
hook that allows you to access the Lenis instance from any component in your app.
Installation
For npm users:
npm i @studio-freight/react-lenis
For yarn users:
yarn add @studio-freight/react-lenis
Usage
import { ReactLenis, useLenis } from '@studio-freight/react-lenis'
function Layout() {
const lenis = useLenis(({ scroll }) => {
})
return (
<ReactLenis root>
{ /* content */ }
</ReactLenis>
)
}
Props
options
: Lenis options.root
: Lenis will be instanciate using <html>
scroll. Default: false
.autoRaf
: if false
, lenis.raf
needs to be called manually. Default: true
.rAFpriority
: Tempus execution priority. Default: 0
.
Hooks
Once the Lenis context is set (components mounted inside <ReactLenis>
) you can use these handy hooks:
useLenis
is a hook that returns the Lenis instance
The hook takes three argument:
callback
: The function to be called whenever a scroll event is emitteddeps
: Trigger callback on changepriority
: Manage callback execution order
Examples
GSAP integration
function Component() {
const lenisRef = useRef()
useEffect(() => {
function update(time) {
lenisRef.current?.lenis?.raf(time * 1000)
}
gsap.ticker.add(update)
return () => {
gsap.ticker.remove(update)
}
})
return (
<ReactLenis ref={lenisRef} autoRaf={false}>
{ /* content */ }
</ReactLenis>
)
}
@studio-freight/react-lenis in use
Authors
This tool is maintained by the darkroom.engineering team:
License
The MIT License.