jQuery.fn.extend({
- // overwrite the old show method
- _show: jQuery.fn.show,
+ /**
+ * Displays each of the set of matched elements if they are hidden.
+ *
+ * @example $("p").show()
+ * @before <p style="display: none">Hello</p>
+ * @result [ <p style="display: block">Hello</p> ]
+ *
+ * @name show
+ * @type jQuery
+ * @cat Effects
+ */
/**
* Show all matched elements using a graceful animation and firing an
* @type jQuery
* @param String|Number speed A string representing one of the three predefined speeds ("slow", "normal", or "fast") or the number of milliseconds to run the animation (e.g. 1000).
* @param Function callback (optional) A function to be executed whenever the animation completes.
- * @param String easing (optional) easing effect
- * @cat Effects/Animations
+ * @cat Effects
* @see hide(String|Number,Function)
*/
- show: function(speed,callback, easing){
- return speed ? this.animate({
- height: "show", width: "show", opacity: "show"
- }, speed, callback, easing) : this._show();
+ show: function(speed,callback){
+ var hidden = this.filter(":hidden");
+ speed ?
+ hidden.animate({
+ height: "show", width: "show", opacity: "show"
+ }, speed, callback) :
+
+ hidden.each(function(){
+ this.style.display = this.oldblock ? this.oldblock : "";
+ if ( jQuery.css(this,"display") == "none" )
+ this.style.display = "block";
+ });
+ return this;
},
- // Overwrite the old hide method
- _hide: jQuery.fn.hide,
+ /**
+ * Hides each of the set of matched elements if they are shown.
+ *
+ * @example $("p").hide()
+ * @before <p>Hello</p>
+ * @result [ <p style="display: none">Hello</p> ]
+ *
+ * @name hide
+ * @type jQuery
+ * @cat Effects
+ */
/**
* Hide all matched elements using a graceful animation and firing an
* @type jQuery
* @param String|Number speed A string representing one of the three predefined speeds ("slow", "normal", or "fast") or the number of milliseconds to run the animation (e.g. 1000).
* @param Function callback (optional) A function to be executed whenever the animation completes.
- * @param String easing (optional) easing effect
- * @cat Effects/Animations
+ * @cat Effects
* @see show(String|Number,Function)
*/
- hide: function(speed,callback, easing){
- return speed ? this.animate({
- height: "hide", width: "hide", opacity: "hide"
- }, speed, callback, easing) : this._hide();
+ hide: function(speed,callback){
+ var visible = this.filter(":visible");
+ speed ?
+ visible.animate({
+ height: "hide", width: "hide", opacity: "hide"
+ }, speed, callback) :
+
+ visible.each(function(){
+ this.oldblock = this.oldblock || jQuery.css(this,"display");
+ if ( this.oldblock == "none" )
+ this.oldblock = "block";
+ this.style.display = "none";
+ });
+ return this;
+ },
+
+ // Save the old toggle function
+ _toggle: jQuery.fn.toggle,
+
+ /**
+ * Toggles each of the set of matched elements. If they are shown,
+ * toggle makes them hidden. If they are hidden, toggle
+ * makes them shown.
+ *
+ * @example $("p").toggle()
+ * @before <p>Hello</p><p style="display: none">Hello Again</p>
+ * @result [ <p style="display: none">Hello</p>, <p style="display: block">Hello Again</p> ]
+ *
+ * @name toggle
+ * @type jQuery
+ * @cat Effects
+ */
+ toggle: function( fn, fn2 ){
+ var args = arguments;
+ return fn && fn.constructor == Function && fn2 && fn2.constructor == Function ?
+ this._toggle( fn, fn2 ) :
+ this.each(function(){
+ jQuery(this)[ jQuery(this).is(":hidden") ? "show" : "hide" ]
+ .apply( jQuery(this), args );
+ });
},
/**
* @type jQuery
* @param String|Number speed (optional) A string representing one of the three predefined speeds ("slow", "normal", or "fast") or the number of milliseconds to run the animation (e.g. 1000).
* @param Function callback (optional) A function to be executed whenever the animation completes.
- * @param String easing (optional) easing effect
- * @cat Effects/Animations
+ * @cat Effects
* @see slideUp(String|Number,Function)
* @see slideToggle(String|Number,Function)
*/
- slideDown: function(speed,callback, easing){
- return this.animate({height: "show"}, speed, callback, easing);
+ slideDown: function(speed,callback){
+ return this.animate({height: "show"}, speed, callback);
},
/**
* @type jQuery
* @param String|Number speed (optional) A string representing one of the three predefined speeds ("slow", "normal", or "fast") or the number of milliseconds to run the animation (e.g. 1000).
* @param Function callback (optional) A function to be executed whenever the animation completes.
- * @param String easing (optional) easing effect
- * @cat Effects/Animations
+ * @cat Effects
* @see slideDown(String|Number,Function)
* @see slideToggle(String|Number,Function)
*/
- slideUp: function(speed,callback, easing){
- return this.animate({height: "hide"}, speed, callback, easing);
+ slideUp: function(speed,callback){
+ return this.animate({height: "hide"}, speed, callback);
},
/**
* @type jQuery
* @param String|Number speed (optional) A string representing one of the three predefined speeds ("slow", "normal", or "fast") or the number of milliseconds to run the animation (e.g. 1000).
* @param Function callback (optional) A function to be executed whenever the animation completes.
- * @param String easing (optional) easing effect
- * @cat Effects/Animations
+ * @cat Effects
* @see slideDown(String|Number,Function)
* @see slideUp(String|Number,Function)
*/
- slideToggle: function(speed, callback, easing){
+ slideToggle: function(speed, callback){
return this.each(function(){
var state = jQuery(this).is(":hidden") ? "show" : "hide";
- jQuery(this).animate({height: state}, speed, callback, easing);
+ jQuery(this).animate({height: state}, speed, callback);
});
},
* @type jQuery
* @param String|Number speed (optional) A string representing one of the three predefined speeds ("slow", "normal", or "fast") or the number of milliseconds to run the animation (e.g. 1000).
* @param Function callback (optional) A function to be executed whenever the animation completes.
- * @param String easing (optional) easing effect
- * @cat Effects/Animations
+ * @cat Effects
* @see fadeOut(String|Number,Function)
* @see fadeTo(String|Number,Number,Function)
*/
- fadeIn: function(speed, callback, easing){
- return this.animate({opacity: "show"}, speed, callback, easing);
+ fadeIn: function(speed, callback){
+ return this.animate({opacity: "show"}, speed, callback);
},
/**
* @type jQuery
* @param String|Number speed (optional) A string representing one of the three predefined speeds ("slow", "normal", or "fast") or the number of milliseconds to run the animation (e.g. 1000).
* @param Function callback (optional) A function to be executed whenever the animation completes.
- * @param String easing (optional) easing effect
- * @cat Effects/Animations
+ * @cat Effects
* @see fadeIn(String|Number,Function)
* @see fadeTo(String|Number,Number,Function)
*/
- fadeOut: function(speed, callback, easing){
- return this.animate({opacity: "hide"}, speed, callback, easing);
+ fadeOut: function(speed, callback){
+ return this.animate({opacity: "hide"}, speed, callback);
},
/**
* @param String|Number speed A string representing one of the three predefined speeds ("slow", "normal", or "fast") or the number of milliseconds to run the animation (e.g. 1000).
* @param Number opacity The opacity to fade to (a number from 0 to 1).
* @param Function callback (optional) A function to be executed whenever the animation completes.
- * @param String easing (optional) easing effect
- * @cat Effects/Animations
+ * @cat Effects
* @see fadeIn(String|Number,Function)
* @see fadeOut(String|Number,Function)
*/
- fadeTo: function(speed,to,callback, easing){
- return this.animate({opacity: to}, speed, callback, easing);
+ fadeTo: function(speed,to,callback){
+ return this.animate({opacity: to}, speed, callback);
},
/**
* left: 50, opacity: 'show'
* }, 500);
*
+ * @example $("p").animate({
+ * opacity: 'show'
+ * }, "slow", "easein");
+ * @desc An example of using an 'easing' function to provide a different style of animation. This will only work if you have a plugin that provides this easing function (Only 'linear' is provided by default, with jQuery).
+ *
* @name animate
* @type jQuery
* @param Hash params A set of style attributes that you wish to animate, and to what end.
* @param String|Number speed (optional) A string representing one of the three predefined speeds ("slow", "normal", or "fast") or the number of milliseconds to run the animation (e.g. 1000).
+ * @param String easing (optional) The name of the easing effect that you want to use (Plugin Required).
* @param Function callback (optional) A function to be executed whenever the animation completes.
- * @param String easing (optional) easing effect
- * @cat Effects/Animations
+ * @cat Effects
*/
- animate: function(prop,speed,callback, easing) {
+ animate: function( prop, speed, easing, callback ) {
return this.queue(function(){
this.curAnim = jQuery.extend({}, prop);
+ var opt = jQuery.speed(speed, easing, callback);
for ( var p in prop ) {
- var e = new jQuery.fx( this, jQuery.speed(speed,callback), p, easing );
+ var e = new jQuery.fx( this, opt, p );
if ( prop[p].constructor == Number )
e.custom( e.cur(), prop[p] );
else
jQuery.extend({
- speed: function(s,o) {
- o = o || {};
-
- if ( o.constructor == Function )
- o = { complete: o };
-
- var ss = { slow: 600, fast: 200 };
- o.duration = (s && s.constructor == Number ? s : ss[s]) || 400;
+ speed: function(speed, easing, fn) {
+ var opt = speed && speed.constructor == Object ? speed : {
+ complete: fn || !fn && easing ||
+ speed && speed.constructor == Function && speed,
+ duration: speed,
+ easing: fn && easing || easing && easing.constructor != Function && easing
+ };
+
+ opt.duration = (opt.duration && opt.duration.constructor == Number ?
+ opt.duration :
+ { slow: 600, fast: 200 }[opt.duration]) || 400;
// Queueing
- o.oldComplete = o.complete;
- o.complete = function(){
+ opt.oldComplete = opt.complete;
+ opt.complete = function(){
jQuery.dequeue(this, "fx");
- if ( o.oldComplete && o.oldComplete.constructor == Function )
- o.oldComplete.apply( this );
+ if ( opt.oldComplete && opt.oldComplete.constructor == Function )
+ opt.oldComplete.apply( this );
};
- return o;
+ return opt;
},
+ easing: {},
+
queue: {},
dequeue: function(elem,type){
* people. You've been warned.
*/
- fx: function( elem, options, prop, easing ){
+ fx: function( elem, options, prop ){
var z = this;
- // The users options
- z.o = {
- duration: options.duration || 400,
- complete: options.complete,
- step: options.step,
- easing : easing || 'linear'
- };
-
- // The element
- z.el = elem;
-
// The styles
- var y = z.el.style;
+ var y = elem.style;
// Store display property
- var oldDisplay = jQuery.css(z.el, 'display');
+ var oldDisplay = jQuery.css(elem, 'display');
// Set display property to block for animation
y.display = "block";
// Make sure that nothing sneaks out
// Figure out the maximum number to run to
z.max = function(){
- return parseFloat( jQuery.css(z.el,prop) );
+ return parseFloat( jQuery.css(elem,prop) );
};
// Get the current size
z.cur = function(){
- var r = parseFloat( jQuery.curCSS(z.el, prop) );
+ var r = parseFloat( jQuery.curCSS(elem, prop) );
return r && r > -10000 ? r : z.max();
};
// Simple 'show' function
z.show = function(){
- if ( !z.el.orig ) z.el.orig = {};
+ if ( !elem.orig ) elem.orig = {};
// Remember where we started, so that we can go back to it later
- z.el.orig[prop] = this.cur();
+ elem.orig[prop] = this.cur();
- z.o.show = true;
+ options.show = true;
// Begin the animation
- z.custom(0, z.el.orig[prop]);
+ z.custom(0, elem.orig[prop]);
// Stupid IE, look what you made me do
if ( prop != "opacity" )
// Simple 'hide' function
z.hide = function(){
- if ( !z.el.orig ) z.el.orig = {};
+ if ( !elem.orig ) elem.orig = {};
// Remember where we started, so that we can go back to it later
- z.el.orig[prop] = this.cur();
+ elem.orig[prop] = this.cur();
- z.o.hide = true;
+ options.hide = true;
// Begin the animation
- z.custom(z.el.orig[prop], 0);
+ z.custom(elem.orig[prop], 0);
};
//Simple 'toggle' function
z.toggle = function() {
- if ( !z.el.orig ) z.el.orig = {};
+ if ( !elem.orig ) elem.orig = {};
// Remember where we started, so that we can go back to it later
- z.el.orig[prop] = this.cur();
+ elem.orig[prop] = this.cur();
if(oldDisplay == 'none') {
- z.o.show = true;
+ options.show = true;
// Stupid IE, look what you made me do
if ( prop != "opacity" )
y[prop] = "1px";
// Begin the animation
- z.custom(0, z.el.orig[prop]);
+ z.custom(0, elem.orig[prop]);
} else {
- z.o.hide = true;
+ options.hide = true;
// Begin the animation
- z.custom(z.el.orig[prop], 0);
+ z.custom(elem.orig[prop], 0);
}
};
z.step = function(firstNum, lastNum){
var t = (new Date()).getTime();
- if (t > z.o.duration + z.startTime) {
+ if (t > options.duration + z.startTime) {
// Stop the timer
clearInterval(z.timer);
z.timer = null;
z.now = lastNum;
z.a();
- if (z.el.curAnim) z.el.curAnim[ prop ] = true;
+ if (elem.curAnim) elem.curAnim[ prop ] = true;
var done = true;
- for ( var i in z.el.curAnim )
- if ( z.el.curAnim[i] !== true )
+ for ( var i in elem.curAnim )
+ if ( elem.curAnim[i] !== true )
done = false;
if ( done ) {
// Reset the display
y.display = oldDisplay;
- if (jQuery.css(z.el, 'display') == 'none')
+ if (jQuery.css(elem, 'display') == 'none')
y.display = 'block';
// Hide the element if the "hide" operation was done
- if ( z.o.hide )
+ if ( options.hide )
y.display = 'none';
// Reset the properties, if the item has been hidden or shown
- if ( z.o.hide || z.o.show )
- for ( var p in z.el.curAnim )
+ if ( options.hide || options.show )
+ for ( var p in elem.curAnim )
if (p == "opacity")
- jQuery.attr(y, p, z.el.orig[p]);
+ jQuery.attr(y, p, elem.orig[p]);
else
y[p] = '';
}
// If a callback was provided, execute it
- if( done && z.o.complete && z.o.complete.constructor == Function )
+ if ( done && options.complete && options.complete.constructor == Function )
// Execute the complete function
- z.o.complete.apply( z.el );
+ options.complete.apply( elem );
} else {
var n = t - this.startTime;
// Figure out where in the animation we are and set the number
- var p = n / z.o.duration;
- //if the easing function exists then use it else use default linear easing
- if (jQuery.easing[z.o.easing])
- z.now = jQuery.easing[z.o.easing](p, n, firstNum, (lastNum-firstNum), z.o.duration);
- else
- z.now = ((-Math.cos(p*Math.PI)/2) + 0.5) * (lastNum-firstNum) + firstNum;
+ var p = n / options.duration;
+
+ // If the easing function exists, then use it
+ z.now = options.easing && jQuery.easing[options.easing] ?
+ jQuery.easing[options.easing](p, n, firstNum, (lastNum-firstNum), options.duration) :
+ // else use default linear easing
+ ((-Math.cos(p*Math.PI)/2) + 0.5) * (lastNum-firstNum) + firstNum;
// Perform the next step of the animation
z.a();
}
};
- },
-
- /**
- *
- * @param Integer p period step in animation
- * @param Integer n current time
- * @param Mixed firstNum begin value
- * @param Mixed delta change in
- * @param Integer duration duration
- */
- easing : {
- linear: function(p, n, firstNum, delta, duration) {
- return ((-Math.cos(p*Math.PI)/2) + 0.5) * delta + firstNum;
- },
-
- easein: function(p, n, firstNum, delta, duration) {
- return delta*(n/=duration)*n*n + firstNum;
- },
-
- easeout: function(p, n, firstNum, delta, duration) {
- return -delta * ((n=n/duration-1)*n*n*n - 1) + firstNum;
- },
-
- easeboth: function(p, n, firstNum, delta, duration) {
- if ((n/=duration/2) < 1)
- return delta/2*n*n*n*n + firstNum;
- return -delta/2 * ((n-=2)*n*n*n - 2) + firstNum;
- },
-
- bounceout: function(p, n, firstNum, delta, duration) {
- if ((n/=duration) < (1/2.75)) {
- return delta*(7.5625*n*n) + firstNum;
- } else if (n < (2/2.75)) {
- return delta*(7.5625*(n-=(1.5/2.75))*n + .75) + firstNum;
- } else if (n < (2.5/2.75)) {
- return delta*(7.5625*(n-=(2.25/2.75))*n + .9375) + firstNum;
- } else {
- return delta*(7.5625*(n-=(2.625/2.75))*n + .984375) + firstNum;
- }
- },
-
- bouncein: function(p, n, firstNum, delta, duration) {
- if (jQuery.easing.bounceout)
- return delta - jQuery.easing.bounceout (p, duration - n, 0, delta, duration) + firstNum;
- return firstNum + delta;
- },
-
- bounceboth: function(p, n, firstNum, delta, duration) {
- if (jQuery.easing.bouncein && jQuery.easing.bounceout)
- if (n < duration/2)
- return jQuery.easing.bouncein(p, n*2, 0, delta, duration) * .5 + firstNum;
- return jQuery.easing.bounceout(p, n*2-duration, 0, delta, duration) * .5 + delta*.5 + firstNum;
- return firstNum + delta;
- },
-
- elasticin: function(p, n, firstNum, delta, duration) {
- var a, s;
- if (n == 0)
- return firstNum;
- if ((n/=duration)==1)
- return firstNum+delta;
- a = delta * 0.3;
- p=duration*.3;
- if (a < Math.abs(delta)) {
- a=delta;
- s=p/4;
- } else {
- s = p/(2*Math.PI) * Math.asin (delta/a);
- }
- return -(a*Math.pow(2,10*(n-=1)) * Math.sin( (n*duration-s)*(2*Math.PI)/p )) + firstNum;
- },
-
- elasticout:function(p, n, firstNum, delta, duration) {
- var a, s;
- if (n==0)
- return firstNum;
- if ((n/=duration/2)==2)
- return firstNum + delta;
- a = delta * 0.3;
- p=duration*.3;
- if (a < Math.abs(delta)){
- a = delta;
- s=p/4;
- } else {
- s = p/(2*Math.PI) * Math.asin (delta/a);
- }
- return a*Math.pow(2,-10*n) * Math.sin( (n*duration-s)*(2*Math.PI)/p ) + delta + firstNum;
- },
-
- elasticboth: function(p, n, firstNum, delta, duration) {
- var a, s;
- if (n==0)
- return firstNum;
- if ((n/=duration/2)==2)
- return firstNum + delta;
- a = delta * 0.3;
- p=duration*.3;
- if (a < Math.abs(delta)){
- a = delta;
- s=p/4;
- } else {
- s = p/(2*Math.PI) * Math.asin (delta/a);
- }
- if (n < 1) {
- return -.5*(a*Math.pow(2,10*(n-=1)) * Math.sin( (n*duration-s)*(2*Math.PI)/p )) + firstNum;
- }
- return a*Math.pow(2,-10*(n-=1)) * Math.sin( (n*duration-s)*(2*Math.PI)/p )*.5 + delta + firstNum;
- }
}
-
-});
\ No newline at end of file
+});