animation-listener

1.0.0 • Public • Published

CSS Animation & Transition Listener

Listen for css animation and transition events. You can delay callbacks and target specific transition types.

Listener functions

Three parameters are returned to the function.

Param Type Description
1 string The animation name or transition type.
2 number The iteration count.
3 object The full event object

Animation Examples

Call a function when the 'jump' animation ends.

$('.box').animationend('jump', function(name, count, event) {
   console.log(name + ' has finished transitioning');
   console.log(event);
});

Call a function when any animation has started.

$('.box').animationstart(function(name) {
   console.log(name + 'animation has started');
});

You can also pass in a number to delay the callback. Add as a number, in the milisecond format.

$('.box').animationend(2000, function() {
  console.log('animation ended 2 seconds ago');
});

If an animation loops, you can call a functioon on each iteration

$('.box').animationiteration(function(name, count) {
  console.log('This animation has happened' + count + 'times');
});

Transition Examples

Call a function when height and width transitions have ended (use space delimited string for multiple transition types or an array of strings). The transition type will be returned as the first parameter. The event object is returned as the second parameter.

$('.box').transitionend('height width', function(type) {
   console.log(type + ' has finished transitioning');
});

Call a function when only the height transition ends.

$('.box').transitionend('height', function(type) {
   console.log(type + ' has finished transitioning');
});

Call a function when every transition has ended. The callback function will be called for each transition type.

$('.box').transitionend(function(type) {
  console.log(type + ' has finished transitioning');
});

You can also pass in a number to delay the callback. Add as a number, in the milisecond format.

$('.box').transitionend(2000, function() {
  console.log('transition ended 2 seconds ago');
});

On or One

Passing in the string 'one' or 'on' will adjust the type of event handler you'd prefer to use. 'on' is used by default. What's the different? one removes the event listener after being run once. on will continue to listen for the transition/animation event.

$('.box').animationend('one', function(e) {
   console.log('hello world');
});

Go nuts

If you really want go nuts, you're welcome to concatenate the functions together too.

$('.box').animationstart(function(name) {
  console.log(name + ' animation has started');
}).animationend(1000, function() {
  console.log('and now it has ended, 1 second ago');
}).animationiteration('jump', function(name, count) {
  console.log('and the iteration count is: ' + count);
}).transitionend(function() {
  console.log('Just for fun, the transition end has been listened too');
});

Help is always appreciated

If anyone has the time and courtesy to fork out a vanilla (non-jQuery dependant) version of this plugin, that would be greatly appreciated.

Readme

Keywords

none

Package Sidebar

Install

npm i animation-listener

Weekly Downloads

1

Version

1.0.0

License

MIT

Last publish

Collaborators

  • marknotton