@joinbox/joinimation
v1.1.4
Published
Adds classes to HTML elements when they become visible
Downloads
156
Readme
Joinimation
Adds classes to HTML elements when they become visible (as the user scrolls through a page).
Example
<body>
<div data-animation-visible-class="animateMe">
I get the class animatesMe as soon as I become visible.
</div>
<div
class="animator"
data-animation-visible-class="animateMeLater"
data-animation-delay="100"
data-animation-element-name="trigger"
>
I get the class animatesMe 100ms after I became visible.
</div>
<div data-animation-visible-class="animateMe" data-animation-trigger="trigger">
I get the class animateMe when the element .animator becomes visible.
</div>
</body>Usage
Import and setup Joinimation
import Joinimation from '@joinbox/joinimation'; const joinimation = new Joinimation(); // Animate all elements with the relevant data attributes; use a selector different than // 'body' to only animate their child elements joinimation.add(document.querySelector('body'));Add the following attributes to all HTML elements that should get classes when they (or another specified element) become visible:
- An element with the attribute
data-animation-visible-class="className"gets the orresponding class (classNamein this case) as soon as it becomes visible. - If an element with a
data-animation-visible-classattribute also has an attributedata-animation-delay="100", the correspdonging class will be set with a delay (of 100 ms in this case) - If an element with a
data-animation-visible-classattribute also has an attributedata-animation-stagger="200", the animation will be delayed (200 ms in this case), but only if multiple elements become visible at the same time. The staggering effect will take place in the same order as the elements have in the DOM. The delay is relative to the previous elements that became visible simultaneously: If element1 has a stagger of 200 ms and element2 has a stagger of 300 ms, element2 will only become visible 500 ms after it became visible. What are staggers good for? Mainly to have elements fade in one after another on large screens (where they are aligned horizontally) but not on small screens (where they are aligned vertically). - If an element with a
data-animation-visible-classattribute also has an attributedata-animation-trigger="name1", classes will be added as soon as an other element that has the attributedata-animation-element-name="name1"becomes visible. Make sure their delay the animation of an element depending on the visibility of another element. attribute values match exactly. Can be used in combination withdata-animation-delayto
- An element with the attribute
If you need different transition settings (duration, timing function, delay) at the time when elements become visible (than e.g. when they are hovered later), initialize Joinimation with a class name that will only be added to the Joinimation elements while its initial transitions are running:
const joinimation = new Joinimation({ isTransitioningClassName: 'isTransitioning' });Build
Setup: npm i
Test: npm test
Run demo:
- Use node 16
npm run demo