Custom scrollbars vanilla javascript library with native scroll, done simple, lightweight, easy to use and cross-browser.
Installations
npm install simplebar
Developer
Developer Guide
Module System
CommonJS
Min. Node Version
Typescript Support
Yes
Node Version
20.11.1
NPM Version
lerna/6.4.1/node@v20.11.1+x64 (darwin)
Statistics
6,082 Stars
1,362 Commits
533 Forks
69 Watching
8 Branches
52 Contributors
Updated on 26 Nov 2024
Bundle Size
94.08 kB
Minified
30.21 kB
Minified + Gzipped
Languages
TypeScript (52.84%)
JavaScript (38.15%)
CSS (7.86%)
HTML (1.13%)
SCSS (0.03%)
Total Downloads
Cumulative downloads
Total Downloads
234,061,471
Last day
1%
98,487
Compared to previous day
Last week
3.9%
519,626
Compared to previous week
Last month
11.5%
2,138,741
Compared to previous month
Last year
-26.5%
27,114,669
Compared to previous year
Daily Downloads
Weekly Downloads
Monthly Downloads
Yearly Downloads
Dependencies
2
Dev Dependencies
4
SimpleBar does only one thing: replace the browser's default scrollbar with a custom CSS-styled one without losing performances.
Unlike some popular plugins, SimpleBar doesn't mimic scroll with Javascript, causing janks and strange scrolling behaviours...
You keep the awesomeness of native scrolling...with a custom scrollbar!
SimpleBar does NOT implement a custom scroll behaviour. It keeps the native overflow: auto
scroll and only replace the scrollbar visual appearance.
- 🐦 Follow me on Twitter! or Mastodon!
- 👨💻 If you like Simplebar, buy me a coffee!
Design it as you want
SimpleBar uses pure CSS to style the scrollbar. You can easily customize it as you want! Or even have multiple style on the same page...or just keep the default style ("Mac OS" scrollbar style).
Lightweight and performant
Only 6kb minified. SimpleBar doesn't use Javascript to handle scrolling. You keep the performances/behaviours of the native scroll.
Supported everywhere
SimpleBar has been tested on the following browsers: Chrome, Firefox, Safari, Edge, IE11.
Getting started
The easiest way to use SimpleBar is with the default dependency-free version: npm install simplebar
.
If you are using a framework, SimpleBar also supports the most popular ones: Vue, Angular and React.
Demo
You can check our demo page (which is also the one we use for automated tests).
Changelog
See changelog here : https://github.com/Grsmto/simplebar/releases
Credits
- KingSora for multiple features and inspirations (
height: auto
detection, RTL mode cross browser support and more) with OverlayScrollbars. - Jonathan Nicol for original idea with Trackpad Scroll Emulator.
- Cassio Bittencourt for the logo design.
No vulnerabilities found.
Reason
13 commit(s) out of 30 and 3 issue activity out of 30 found in the last 90 days -- score normalized to 10
Reason
no vulnerabilities detected
Reason
license file detected
Details
- Info: : LICENSE:1
Reason
no dangerous workflow patterns detected
Reason
tokens are read-only in GitHub workflows
Reason
all dependencies are pinned
Details
- Info: GitHub-owned GitHubActions are pinned
- Info: Third-party GitHubActions are pinned
- Info: Dockerfile dependencies are pinned
- Info: no insecure (not pinned by hash) dependency downloads found in Dockerfiles
- Info: no insecure (not pinned by hash) dependency downloads found in shell scripts
Reason
no binaries found in the repo
Reason
GitHub code reviews found for 8 commits out of the last 30 -- score normalized to 2
Details
- Warn: no reviews found for commit: 6b4a691871591338df6f6a542a2f8a24680a4129
- Warn: no reviews found for commit: 02a84c097d104d649ac2ed6b4436a34052c87e8f
- Warn: no reviews found for commit: 41676d3a8b49c09b52d95c9ce715d899c295d967
- Warn: no reviews found for commit: f524042b04c820492ac6784a9a5315df554542d9
- Warn: no reviews found for commit: b6efacd644721147c50d50be7f8621e5218bd68f
- Warn: no reviews found for commit: cc2c78f5bfc69ea7819e9f0276550274bd940fe2
- Warn: no reviews found for commit: cd2908ea1d6b5a49560c81db8594fd6b8fa51765
- Warn: no reviews found for commit: 19152e874c760768fc00f6c9afd829cff8b54511
- Warn: no reviews found for commit: 63b14223d47b4c4cd75b9a57e442149d87c82e06
- Warn: no reviews found for commit: 6058fcf99b671244b64c6c0ecf918ed14c92ec3f
- Warn: no reviews found for commit: dba7414fe04ee70dca781b7b28557f65d3c204b6
- Warn: no reviews found for commit: c6808084c89267afe6160c2be42a6627fe3788be
- Warn: no reviews found for commit: 683691483ac409797b13362cbe172280b0ecbcd2
- Warn: no reviews found for commit: 821de84170227aacca8eb7537213ad547b32501e
- Warn: no reviews found for commit: 40b847916bfdd96a46dce6e9af0128b239dc70d5
- Warn: no reviews found for commit: 1406cb47acb7d7d80b45aed07b2427ad9110f699
- Warn: no reviews found for commit: 340ad74a456bda347da7bf8b8e0d23ec3351adfd
- Warn: no reviews found for commit: 3875dbbc5019214cd41467ae1cd7958bae7824da
- Warn: no reviews found for commit: 3509cc410687d394966359ffb766fd91fc329b64
- Warn: no reviews found for commit: d5a03ef12568134bbb45c76ab02d91fe1f814171
- Warn: no reviews found for commit: 8fd53fc4cd860e146c3f6af4db2ce232cc7a37a4
- Warn: no reviews found for commit: 53fcda777d6e0b38ec09d741663adcef270821bb
Reason
no badge detected
Reason
branch protection not enabled on development/release branches
Details
- Warn: branch protection not enabled for branch 'master'
- Warn: branch protection not enabled for branch 'feature/vue-component'
Reason
security policy file not detected
Reason
no update tool detected
Details
- Warn: dependabot config file not detected in source location. We recommend setting this configuration in code so it can be easily verified by others.
- Warn: renovatebot config file not detected in source location. We recommend setting this configuration in code so it can be easily verified by others.
Reason
project is not fuzzed
Score
5.9
/10
Last Scanned on 2022-08-15
The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.
Learn More