SimplebarVue

• 🐦 Follow me on Twitter! or Mastodon!
• 👨‍💻 I'm available for hire! Reach out to me!
• 🚧 Check out my new project Scroll Snap Carousel!

Installation

- Via npm npm install simplebar-vue --save

- Via Yarn yarn add simplebar-vue

Usage

Check out the Demo project(vue2) and the Demo project(vue3)

First, register it in your Vue app:

import simplebar from 'simplebar-vue';
import 'simplebar-vue/dist/simplebar.min.css';

export default {
  components: {
    simplebar,
  },
};

Then you can use it in your template

<template>
  <simplebar data-simplebar-auto-hide="false">
    // your content elements
  </simplebar>
</template>

Don't forget to import both css and js in your project!

:warning: Warning!

SimpleBar is not intended to be used on the body element! I don't recommend wrapping your entire web page inside a custom scroll as it will often badly affect the user experience (slower scroll performance compared to the native body scroll, no native scroll behaviours like click on track, etc.). Do it at your own risk! SimpleBar is meant to improve the experience of internal web page scrolling; such as a chat box or a small scrolling area. Please read the caveats section first to be aware of the limitations!

Options

Find the list of available options on the core documentation.

Troubleshooting

If you are experiencing issues when setting up SimpleBar, it is most likely because your styles are clashing with SimpleBar ones. Make sure the element you are setting SimpleBar on does not override any SimpleBar css properties! We recommend to not style that element at all and use an inner element instead.

Sponsors

Thanks to BrowserStack for sponsoring open source projects and letting us test SimpleBar for free.