/smooth-scrollbar

Customizable, Pluginable, and High Performance Scrollbars!

Primary LanguageTypeScriptMIT LicenseMIT

Smooth Scrollbar

npm monthly downloads core size gzip size Build status Gitpod Ready-to-Code

Customizable, Flexible, and High Performance Scrollbars!

Installation

⚠️ DO NOT use custom scrollbars unless you know what you are doing. Read more

Via NPM (recommended):

npm install smooth-scrollbar --save

Via Bower:

bower install smooth-scrollbar --save

Browser Compatibility

Browser Version
IE 10+
Chrome 22+
Firefox 16+
Safari 8+
Android Browser 4+
Chrome for Android 32+
iOS Safari 7+

Demo

https://idiotwu.github.io/smooth-scrollbar/

Usage

Since this package has a pkg.module field, it's highly recommended to import it as an ES6 module with some bundlers like webpack or rollup:

import Scrollbar from 'smooth-scrollbar';

Scrollbar.init(document.querySelector('#my-scrollbar'));

If you are not using any bundlers, you can just load the UMD bundle:

<script src="dist/smooth-scrollbar.js"></script>

<script>
  var Scrollbar = window.Scrollbar;

  Scrollbar.init(document.querySelector('#my-scrollbar'));
</script>

Documentation

latest 7.x

FAQ

  • How to deal with position: fixed elements? #49
  • How to temporarily stop scrolling? #119
  • How to enable hash/anchor scrolling? #128
  • How to direct all scrolling to a particular direction? #181
  • How to disable scrolling in a particular direction? #206
  • more...

Who's Using It

  • conference.awwwards.com: Awwwards Conference - An Event for UX / UI Designers and Web Developers.
  • lp.anzi.kr: Listeners Playlist.
  • Matter: A new and better way to grow your professional skills.
  • Feel free to add yours here 🤗.

License

MIT