Easing function for use with or without jQuery. In addition to the standard list of easing functions, it adds an easier to remember syntax for when you want to use Sine, Circ, Quad, Expo, etc.
easing
accepts easeInX
, easeOutX
, and easeInOutX
where X is a
number between 1 and 9; 1 is the least dramatic curve, similar to Sine
. 9 is the most dramatic curve, even more than Expo
.
// get the easeIn3 value at 50% of the ease between 5 and 10
easing( 'easeIn3', 0.5, 5, 10 );
715 bytes min'd and gzip'd.
Download the production version or the development version.
In your web page using jQuery:
<script src="jquery.js"></script>
<script src="dist/easing.js.min.js"></script>
<script>
$( document ).ready( function() {
// easing functions will work with jq functions
$( '#idOfElement' ).slideUp( 1000, 'easeOutBounce' );
// and even the easy to remember ones
$( '#someElement' ).slideDown( 600, 'easeOut4' );
});
</script>
Using standalone:
<script src="dist/easing.js.min.js"></script>
<script>
// easing returns a number between 0 and 1 if you don't specify a
// a start and end.
var start = 50,
end = 100;
// easeIn2 at 50% between 50 and 100
easing( 'easeIn2', 0.5, start, end ); // returns 62.5
// easeIn2 at 50%
easing( 'easeIn2', 0.5 ) * ( end - start ) + start; // returns 62.5
</script>
http://jsfiddle.net/danheberden/rWGm2/
easing
only requires the first two arguments:
The type of easing you want to perform, such as easeInBounce
,
easeInSine
or the easier to remember easeInX
, easeOutX
, and
easeInOutX
where X
can any number between 1 and 9. If type
cannot
be found, 'linear' will be used.
This is at what point you wish to calculate the easing. This is a number between 0 and 1.
The start value to use for the easing value calculation
The end value to use for the easing value calculation
For a list of what easing functions are supported, check out the demo.
We were working to write new easing plugins for jQuery UI because the existing ones, borrowed from here, were just a bit too big; this plugin works without jQuery, is smaller, and offers more usability.
1.1.2 - Fix manifest file naming
1.1.1 - Add manifest file for the jQuery Plugins Site
1.1.0 - Removed arc function, improved bounce to calculate # of bounces
1.0.0 - Removed constructor design in favor of easier to use utilities, simpler math and quicker load time.
0.0.1 - Initial release
Copyright (c) 2012 Dan Heberden Licensed under the MIT license.