Installation
npm install locomotive-scroll
Usage
Basic
With simple detection.
HTML
<h1 data-scroll>Hey</h1>
<p data-scroll>?</p>
CSS
Add the base styles to your CSS file.
JS
With a bundler
import LocomotiveScroll from 'locomotive-scroll';
const scroll = new LocomotiveScroll();
Or without
<script src="locomotive-scroll.min.js"></script>
<script>
(function () {
var scroll = new LocomotiveScroll();
})();
</script>
Get the JS file.
Smooth
With smooth scrolling and parallax.
<div data-scroll-container>
<div data-scroll-section>
<h1 data-scroll>Hey</h1>
<p data-scroll>?</p>
</div>
<div data-scroll-section>
<h2 data-scroll data-scroll-speed="1">What's up?</h2>
<p data-scroll data-scroll-speed="2">?</p>
</div>
</div>
import LocomotiveScroll from 'locomotive-scroll';
const scroll = new LocomotiveScroll({
el: document.querySelector('[data-scroll-container]'),
smooth: true
});
Note: scroll-sections are optional but recommended to improve performance, particularly in long pages.
Advanced
Make it do what you want.
With methods
<section id="js-target">Come here please.</section>
import LocomotiveScroll from 'locomotive-scroll';
const scroll = new LocomotiveScroll();
const target = document.querySelector('#js-target');
scroll.scrollTo(target);
With events
<!-- Using modularJS -->
<div data-scroll data-scroll-call="function, module">Trigger</div>
<!-- Using jQuery events -->
<div data-scroll data-scroll-call="EVENT_NAME">Trigger</div>
<!-- Or do it your own way ? -->
<div data-scroll data-scroll-call="{y,o,l,o}">Trigger</div>
import LocomotiveScroll from 'locomotive-scroll';
const scroll = new LocomotiveScroll();
scroll.on('call', func => {
// Using modularJS
this.call(...func);
// Using jQuery events
$(document).trigger(func);
// Or do it your own way ?
});
Instance options, Option, Type, Default, Description, -------------------, ---------, ----------------------, -------------------------------------------------------------------------------------, el, object, document, Scroll container element., name, string, 'scroll', Data attribute prefix (data-scroll-xxxx)., offset, array(2), [0,0], Global in-view trigger offset : [bottom,top]Use a string with % to use a percentage of the viewport height.Use a numeric value for absolute pixels unit.E.g. ["30%",0], [100,0], ["30%", 100], repeat, boolean, false, Repeat in-view detection., smooth, boolean, false, Smooth scrolling., smoothMobile, boolean, false, Smooth scrolling on iOS and Android devices., direction, string, vertical, Scroll direction., inertianumber1lerp instead, lerp, number, 0.1, Linear interpolation (lerp) intensity. Float between 0 and 1.This defines the "smoothness" intensity. The closer to 0, the smoother., getDirection, boolean, false, Add direction to scroll event., getSpeed, boolean, false, Add speed to scroll event., class, string, is-inview, Element in-view class., initClass, string, has-scroll-init, Initialize class., scrollingClass, string, has-scroll-scrolling, Is scrolling class., draggingClass, string, has-scroll-dragging, Is dragging class., smoothClass, string, has-scroll-smooth, Has smooth scrolling class., scrollbarClass, string, c-scrollbar, Scrollbar element class., multiplier, number, 1, Factor applied to the scroll delta, allowing to boost/reduce scrolling speed (regardless of the platform)., firefoxMultiplier, number, 50, Boost scrolling speed of Firefox on Windows., touchMultiplier, number, 2, Mutiply touch action to scroll faster than finger movement., scrollFromAnywhere, boolean, false, (smooth only)By default locomotive-scroll listens for scroll events only on the scroll container (el option). With this option set to true, it listens on the whole document instead., ## Element attributes, Attribute, Values, Description, -----------------------, ------------------------, ----------------------------------------------------------------------------------------, data-scroll, Detect if in-view., data-scroll-container, Defines the scroll container. Required for basic styling., data-scroll-section, Defines a scrollable section. Splitting your page into sections may improve performance., data-scroll-class, string, Element in-view class., data-scroll-offset, string, Element in-view trigger offset : bottom,topFirst value is bottom offset, second (optional) is top offset. Percent is relative to viewport height, otherwise it's absolute pixels.E.g. "10", "100,50%", "25%, 15%", data-scroll-repeat, true, false, Element in-view detection repeat., data-scroll-call, string, Element in-view trigger call event., data-scroll-speed, number, Element parallax speed. A negative value will reverse the direction., data-scroll-target, string, Target element's in-view position., data-scroll-position, top, bottom, Window position of in-view trigger., data-scroll-direction, vertical, horizontal, Element's parallax direction., data-scroll-delay, number, Element's parallax lerp delay., data-scroll-sticky, Sticky element. Starts and stops at data-scroll-target position., ## Instance methods, Method, Description, Arguments, --------------------------, ------------------------------, -------------------------------------------------------------------------------, init(), Reinitializes the scroll., on(eventName, function), Listen [instance events] ⬇., update(), Updates all element positions., destroy(), Destroys the scroll events., start(), Restarts the scroll events., stop(), Stops the scroll events., scrollTo(target, offset, duration, easing, disableLerp, callback), Scroll to an element., target: Defines where you want to scroll. Available values types are :node : a dom elementstring : you can type your own selector, or use values "top" and "bottom" to reach scroll boundariesint : An absolute scroll coordinate in pixelsoffset (optional) : An integer that defines an offset from your target. E.g. -100 if you want to scroll 100 pixels above your targetduration (optional, smooth only) : An integer defining the duration of the scroll animation in milliseconds. Defaults to 1000easing (optional, smooth only) : An array of 4 floats between 0 and 1 defining the bezier curve for the animation's easing.Defaults to [0.25, 0.00, 0.35, 1.00]See http://greweb.me/bezier-easing-editor/example/Keep in mind this will also be affected by the lerp unless you set disableLerp to true.disableLerp (optional, smooth only) : Lerp effect won't be applied if set to truecallback (optional) : function called when scrollTo completes (note that it won't wait for lerp to stabilize), ## Instance events, Event, Arguments, Description, --------, ---------, ---------------------------------------------------------------------, scroll, obj, Returns scroll instance (position, limit, speed, direction)., call, func, Trigger if in-view. Returns your string or array if contains ,., ## Dependencies, Name, Description, ----------------, ------------------------------------------------------------------, Virtual Scroll, Custom scroll event with inertia/momentum., modularScroll, Elements in viewport detection. Forked from it, not a dependency., bezier-easing, Improve scrollTo system and add duration & easing parameters, [instance events]: #instance-events
inertianumber1Browser support
Works on most modern browsers. Chrome, Firefox, Safari, Edge...
To get IE 11 support, you need polyfills.
You can use your own or include these before our script.
<script nomodule src="https://cdnjs.cloudflare.com/ajax/libs/babel-polyfill/7.6.0/polyfill.min.js" crossorigin="anonymous"></script>
<script nomodule src="https://polyfill.io/v3/polyfill.min.js?features=Object.assign%2CElement.prototype.append%2CNodeList.prototype.forEach%2CCustomEvent%2Csmoothscroll" crossorigin="anonymous"></script>
Who's using Locomotive Scroll?
- thierrychopain.com
- clmt.paris
- miragefestival.com/2020
- mazellier.design
- ccccontemple.com
- abhishekjha.me/muteza
- normal.studio
- mixlegno.com
- nfq.group
- works.studio
- beangels.eu
- izakaya-caen.fr
- white-elephant.fr
- henge07.com
- loirevalleylodges.com