/vue-sticky-scroll

vue.js 1.x directive to always auto-scroll to the bottom of an element!

Primary LanguageJavaScript

vue-sticky-scroll

update: this directive is for vue 1.x. a vue 2.0 compatible version is available by theomessin here.

a vue.js directive that keeps an element scrolled to the bottom

vue-sticky-scroll keeps an eye on your element and whenever content is added inside of it, it scrolls down so that the viewer can remain focused on the newest content!

install

NPM:
note: vue-sticky-scroll requires vue 1.x; check your version by running npm list vue; a 2.0 compatible version is available here

npm i --save vue-sticky-scroll

Require it in your vue.js component file:

// ES5
var stickyScroll = require('vue-sticky-scroll');
// ES6
import 'vue-sticky-scroll';

usage instructions

Add v-sticky-scroll as an attribute on the element you wish to always scroll to the bottom of:

<div class='i-wish-this-would-scroll' v-sticky-scroll></div>

options: animate

the scrolling will jump to the bottom by default.
if you prefer a smooth scroll, add:

  • argument 'animate'
  • optional: expression (default is 300)
<div class='i-wish-this-would-scroll' v-sticky-scroll:animate></div>

<div class='i-wish-this-would-scroll' v-sticky-scroll:animate=500></div>

how it works

vue-sticky-scroll uses a wonderful, highly underrated browser feature: mutation observers. By creating a new MutationObserver and telling it which events to .observe(), you can do wonderful things!
This method is much simpler than some implementations of sticky scrolling that use requestAnimationFrame.

license

WTFPL