moveto

MoveTo

A lightweight, smooth scrolling javascript library without any dependency.

Installation

Using NPM

npm install moveTo --save

Using Yarn

yarn add moveTo

Using Bower

bower install moveTo --save

Usage

const moveTo = new MoveTo();

const target = document.getElementById('target');

moveTo.move(target);

// or register a trigger

const trigger = document.getElementsByClassName('js-trigger')[0];

moveTo.registerTrigger(trigger);

Trigger HTML markup

You can pass all options as data attributes with mt prefix. Option name should be written in kebab case format.

  <a href="#target" class="js-trigger" data-mt-duration="300">Trigger</a>

Options

The default options are as follows:

new MoveTo({
  tolerance: 0,
  duration: 800,
  easing: 'outQuart'
})

Option	Default	Desctiption
tolerance	0	The tolerance of the target to be scrolled, can be negative or positive.
duration	800	Duration of scrolling, in milliseconds.
easing	easeOutQuart	Ease function name

API

move(target, options)

Scrolls to target

target

Type: HTMLElement|Number

Target element/position to be scrolled. Target position is the distance to the top of the page

options

Type: Object

Pass custom options

addEaseFunction(name, fn)

Adds custom ease function

name

Type: string

Ease function name

fn

Type: function

Ease function. See http://gizma.com/easing/ for more ease function.

Examples

Pass ease function(s) when creating instance

document.addEventListener('DOMContentLoaded', function(){
  const easeFunctions = {
    easeInQuad: function (t, b, c, d) {
      t /= d;
      return c * t * t + b;
    },
    easeOutQuad: function (t, b, c, d) {
      t /= d;
      return -c * t* (t - 2) + b;
    }
  }
  const moveTo = new MoveTo({
    duration: 1000,
    easing: 'inQuad'
  }, easeFunctions);
  const trigger = document.getElementsByClassName('js-trigger')[0];
  moveTo.registerTrigger(trigger);
});

Development setup

# To install dev dependencies run:

yarn

# or

npm install

# To start the development server run:

gulp serve

# To lint your code run:

gulp scripts:lint

# To make a full new build run:

gulp build

# To run tests

yarn test

# or

npm test

Browser Support

It should work in the current stable releases of Chrome, Firefox, Safari as well as IE9 and up.

License

Copyright (c) 2017 Hasan Aydoğdu. See the LICENSE file for license rights and limitations (MIT).