animate-plus.js is a jQuery plugin that extends animate.css functionality. No javascript coding required!
- Do multiple animations, on multiple elements
- Do animations in order or at the same time
- Make elements animate while scrolling
- Group elements in independent animation groups
Quick start
- Include jQuery and Animate.css
- Add
animate-pluscss class to element - Define animations using the
data-animationsattribuite - Specify duration and delay using
data-animation-durationanddata-animation-delay
<span class="animate-plus" data-animations="bounceIn,fadeOutRight" data-duration="1s,500ms" data-delay="0s, 2s" > Animated content </span>See more examples here.
For a full list of options see Attributes.
Documentation
First things first
Begin by downloading and including animate.css and jQuery in your HTML document. Next, download and include animate-plus.min.js
<link rel="stylesheet" href="path/to/animate.css" /> <script type="text/javascript" src="path/to/jQuery-x.x.x.js"></script> <script type="text/javascript" src="path/to/animate-plus.min.js"></script>Finally, add the animate-plus css class to any elements you want to animate.
<span class="animate-plus">...</span>Attributes
Everything is specified using HTML5 data-* attributes. Attributes always start with data-animation-* except for data-animations. See a list of available attribuites below.
|                     Attribute                    | Description |
|---|---|
data-animations | List of comma delimited animation names. By default the animations are executed from left to rigth. Valid values are animate.css class names. This is the only required attribute. |
data-animation-group | Name of the animation group. You can group animated elements using this attribute. Please refrain from using names that begin with an underscore (_), that's reserved for internal use. |
data-animation-order | List of comma delimited integer values. You can override the order of animation inside a group using the attribute. |
data-animation-duration | List of comma delimited duration values. This attribute will set the duration for the specified animations. For valid values see animation-duration css property. |
data-animation-delay | List of comma delimited delay values. This attribute will set how many time to wait before executing the animations. For valid values see animation-delay css property. |
data-animation-when-visible | Animate group only when visible on screen (binds on scroll and resize). This will begin animation as soon as one group element is visible. Valid value is true. |
data-animation-reset-offscreen | Reset animation when group goes off screen. The group will be reseted as soon as one group element goes off screen. This attribute only has effect when used together with data-animation-when-visible. Valid value is true. |
data-animation-repeat | Loop animation group indefinitely. Valid value is true. |
Examples
-
One element with multiple animations. The animations will execute one at a time, from left to right, using default duration and delay.
<span class="animate-plus" data-animations="bounceIn,shake,fadeOutRight,fadeIn">...</span>
-
One element looping indefinitely.
<span class="animate-plus" data-animations="bounceIn, fadeOutLeft" data-animation-repeat="true">...</span>
-
Group of 2 elements, animated in a specified order. Animations will go as follows:
- bounceIn
- tada
- fadeOutLeft and fadeOutRight at the same time
<span class="animate-plus" data-animation-group="group1" data-animations="bounceIn, fadeOutLeft" data-animation-order="1,3" > ... </span> <span class="animate-plus" data-animation-group="group1" data-animations="tada, fadeOutRight" data-animation-order="2,3" > ... </span>
-
Group of 2 elements, animated with specified duration and delay. Both elements will start animating at the same time (except when delay is specified), always waiting for the previous animation in the group to finish.
<span class="animate-plus" data-animation-group="group2" data-animations="bounceIn, fadeOutLeft" data-animation-duration="3s,5s" > ... </span> <span class="animate-plus" data-animation-group="group2" data-animations="tada, fadeOutRight" data-animation-delay="0s,2s" > ... </span>
-
One element that animates when it's visible on screen (ex. on scroll). The animation resets when the element goes off screen.
<span class="animate-plus" data-animations="tada" data-animation-when-visible="true" data-animation-reset-offscreen="true" > ... </span>
Contributing
Contributions welcome via pull request!
License
Animate-plus.js is licensed under the MIT License. Please see LICENSE.txt file distributed with this software.
