@nathanyoung/react-animate-on-scroll

v1.2.4

Published

2 years ago

React component to animate elements on scroll with animate.css

Downloads

0High
0Medium
0Low

nathanyoung

reactScrollEffects react reactJS react-component animate scroll animation reactAnimateOnScroll

React Animate On Scroll

React component to animate elements on scroll with animate.css. Inspired by React-Scroll-Effect

Demo

Install:

npm install react-animate-on-scroll --save

If you want to use the animations from animate.css, be sure to include animate.css in someway in your project This can be done in a number of ways, eg:

npm install --save animate.css

and then importing in your project:

import "animate.css/animate.min.css";

Or by simply including a link to the file hosted by CDNJS:

<head>
  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/animate.css/3.5.2/animate.min.css">
</head>

Most Simple Use:

import ScrollAnimation from 'react-animate-on-scroll';
<ScrollAnimation animateIn="fadeIn">
  Some Text
</ScrollAnimation>

Properties:

offset - default 100

The "viewport" is by default 100 pixels from the top and bottom of the screen. When an element is completely contained within the "viewport", animateIn is triggered. When the element is leaving the "viewport", animateOut is triggered. This can be overridden by setting the offset property.

If the element is bigger than the viewport animateIn is triggered when the position of the top of the element is is less than the position of the middle of the screen plus the offset, and the position of the bottom of the element is greater than the middle of the screen minus the offset. AnimateOut happens when the element moves out of these constraints.

animateIn

Any animation from animate.css. The Animation triggers when the element is contained within the "viewport" (see offset property for more details on this).

animateOut

Any animation from animate.css. The Animation triggers when the element is leaving the "viewport" (see offset property for more details on this).

duration - default 1

Animation duration in seconds.

initiallyVisible - default false

Whether the element should be visible to begin with or not. If animateIn is an entrance animation, then should probably be false.

delay - default 0

How long to delay the animation for (in milliseconds) once it enters or leaves the view.

animateOnce - default false

Whether the element should only animate once or not.

Development:

In the project root:

Install Dependencies:

npm install

Run Tests:

There are some automated test cases with karma and a Chrome headless browser. I attempted to use Jest, and then to use PhantomJS, but could get neither to work with scroll events. To run them:

npm test

Build the component:

gulp build

Run the Demo project:

cd demo
npm install
npm install ..
npm start

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme