prevent-scrolling

Prevent scrolling while optionally allowing scrolling on specified elements

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
prevent-scrolling
511.3.10a year ago6 years agoMinified + gzip package size for prevent-scrolling in KB

Readme

prevent-scrolling
Prevent scrolling while optionally allowing scrolling on specified elements.
GitHub release Build Status codecov Codacy Badge

Features

  • Prevents scrolling via keyboard
  • Maintains scrolling position
  • Scrollbar will not disappear
  • Can specify elements to still allow scrolling within
  • Elements without scrolling disabled do not allow scroll events to overflow out to parent elements

Install

You can install via npm or yarn.

npm

npm install --save prevent-scrolling

yarn

yarn add prevent-scrolling

Usage

Importing

You can import using ES6 imports.
import { PreventScrolling, ReEnableScrolling } from 'prevent-scrolling';

Preventing Scrolling

PreventScrolling();

Preventing Scrolling but keep scrolling available on one element

const myScrollableElement = document.querySelector('.MyScrollableElement');

PreventScrolling(myScrollableElement);

Preventing Scrolling but keep scrolling available on multiple elements

const myScrollableElements = [].slice.call(document.querySelectorAll('.MyScrollableElement'));

PreventScrolling(myScrollableElements);

Re-enabling Scrolling

ReEnableScrolling();