@salvacmp/simplebar-vue
v1.6.9
Published
Vue component for SimpleBar
Downloads
2
Readme
SimplebarVue
Installation
- Via npm
npm install simplebar-vue --save
- Via Yarn
yarn add simplebar-vue
Usage
Check out the Demo project.
First, register it in your Vue app:
import simplebar from 'simplebar-vue';
import 'simplebar/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.