Skip to content

Repository files navigation

React Scroll Lock

Prevent scroll on the <body /> when a component is mounted.

Install

yarn add react-scrolllock

Usage

importScrollLock,{TouchScrollable}from'react-scrolllock';classModalextendsComponent{state={lockScroll: false}render(){return(<div>
...
// the lock accepts a single child element, which supports touch-scrolling.
<ScrollLock><ElementWithScrollableContent>...</ElementWithScrollableContent></ScrollLock>
// if your app structure doesn't allow wrapping like above, the `TouchScrollable`
// component is exposed as a named export.
<ScrollLock/><TouchScrollable><ElementWithScrollableContent>...</ElementWithScrollableContent></TouchScrollable>
// you can also toggle the lock based on some state.
<ScrollLockisActive={this.state.lockScroll}/></div>);}}

Props

ScrollLock

PropertyDescription
accountForScrollbars booleanDefault: true -- Whether or not to replace the scrollbar width when active.
isActive booleanDefault: true -- Whether or not the lock is active.
children elementDefault: null -- This element is wrapped internally by the TouchScrollable component.

TouchScrollable

Wrap an element in the TouchScrollable component if you need an area that supports scroll on mobile.

This is necessary because the touchmove event is explicitly cancelled — iOS doesn't observe overflow: hidden; when applied to the <body /> element 😢

PropertyDescription
children elementref => element

About

🔒 Prevent scroll on the <body />

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages