X-Git-Url: http://git.asbjorn.biz/?a=blobdiff_plain;f=src%2Ffx%2Ffx.js;h=fe1c1e2ba530c9a3d5b7642b3e6664bc760aa0db;hb=dbee06de85859af59591813d3004e6695b8bb278;hp=eb27c3a4b5842722e42a346a344e9d49b762ae3e;hpb=25802e8bd07f6c50df2159a031f005950f509819;p=jquery.git diff --git a/src/fx/fx.js b/src/fx/fx.js index eb27c3a..fe1c1e2 100644 --- a/src/fx/fx.js +++ b/src/fx/fx.js @@ -1,7 +1,7 @@ jQuery.fn.extend({ // overwrite the old show method - //_show: jQuery.fn.show, + _show: jQuery.fn.show, /** * Show all matched elements using a graceful animation. @@ -39,7 +39,7 @@ jQuery.fn.extend({ }, // Overwrite the old hide method - //_hide: jQuery.fn.hide, + _hide: jQuery.fn.hide, /** * Hide all matched elements using a graceful animation. @@ -141,6 +141,42 @@ jQuery.fn.extend({ slideUp: function(speed,callback){ return this.animate({height: "hide"}, speed, callback); }, + + /** + * Toggle the visibility of all matched elements by adjusting their height. + * Only the height is adjusted for this animation, causing all matched + * elements to be hidden in a "sliding" manner. + * + * @example $("p").slideToggle("slow"); + * + * @name slideToggle + * @type jQuery + * @param Object 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). + * @cat Effects/Animations + */ + + /** + * Toggle the visibility of all matched elements by adjusting their height + * and firing a callback function after completion. + * Only the height is adjusted for this animation, causing all matched + * elements to be hidden in a "sliding" manner. + * + * @example $("p").slideToggle("slow",function(){ + * alert("Animation Done."); + * }); + * + * @name slideToggle + * @type jQuery + * @param Object 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 A function to be executed whenever the animation completes. + * @cat Effects/Animations + */ + slideToggle: function(speed,callback){ + return this.each(function(){ + var state = jQuery(this).is(":hidden") ? "show" : "hide"; + jQuery(this).animate({height: state}, speed, callback); + }); + }, /** * Fade in all matched elements by adjusting their opacity. @@ -250,18 +286,45 @@ jQuery.fn.extend({ }, /** - * @private + * A function for making your own, custom, animations. The key aspect of + * this function is the object of style properties that will be animated, + * and to what end. Each key within the object represents a style property + * that will also be animated (for example: "height", "top", or "opacity"). + * + * The value associated with the key represents to what end the property + * will be animated. If a number is provided as the value, then the style + * property will be transitioned from its current state to that new number. + * Oterwise if the string "hide", "show", or "toggle" is provided, a default + * animation will be constructed for that property. + * + * @example $("p").animate({ + * height: 'toggle', opacity: 'toggle' + * }, "slow"); + * + * @example $("p").animate({ + * left: 50, opacity: 'show' + * }, 500); + * + * @name animate + * @type jQuery + * @param Hash params A set of style attributes that you wish to animate, and to what end. + * @param Object 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 A function to be executed whenever the animation completes. + * @cat Effects/Animations */ animate: function(prop,speed,callback) { return this.queue(function(){ - var i = 0; + + this.curAnim = prop; + for ( var p in prop ) { - var e = new jQuery.fx( this, jQuery.speed(speed,callback,i++), p ); + var e = new jQuery.fx( this, jQuery.speed(speed,callback), p ); if ( prop[p].constructor == Number ) e.custom( e.cur(), prop[p] ); else e[ prop[p] ]( prop ); } + }); }, @@ -321,7 +384,7 @@ jQuery.extend({ } }, - speed: function(s,o,i) { + speed: function(s,o) { o = o || {}; if ( o.constructor == Function ) @@ -337,9 +400,6 @@ jQuery.extend({ if ( o.oldComplete && o.oldComplete.constructor == Function ) o.oldComplete.apply( this ); }; - - if ( i > 0 ) - o.complete = null; return o; }, @@ -387,17 +447,12 @@ jQuery.extend({ z.a = function(){ if ( options.step ) options.step.apply( elem, [ z.now ] ); - - if ( prop == "opacity" ) { - if (z.now == 1) z.now = 0.9999; - if (window.ActiveXObject) - y.filter = "alpha(opacity=" + z.now*100 + ")"; - else - y.opacity = z.now; - - // My hate for IE will never die - } else if ( parseInt(z.now) ) + + if ( prop == "opacity" ) + jQuery.attr(y, "opacity", z.now); // Let attr handle opacity + else if ( parseInt(z.now) ) // My hate for IE will never die y[prop] = parseInt(z.now) + "px"; + y.display = "block"; }; @@ -408,7 +463,8 @@ jQuery.extend({ // Get the current size z.cur = function(){ - return parseFloat( jQuery.curCSS(z.el, prop) ) || z.max(); + var r = parseFloat( jQuery.curCSS(z.el, prop) ); + return r && r > -10000 ? r : z.max(); }; // Start an animation from one number to another @@ -428,8 +484,12 @@ jQuery.extend({ // Remember where we started, so that we can go back to it later z.el.orig[prop] = this.cur(); - - z.custom( 0, z.el.orig[prop] ); + + // Begin the animation + if (prop == "opacity") + z.custom(z.el.orig[prop], 1); + else + z.custom(0, z.el.orig[prop]); // Stupid IE, look what you made me do if ( prop != "opacity" ) @@ -446,19 +506,14 @@ jQuery.extend({ z.o.hide = true; // Begin the animation - z.custom(z.cur(),0); + z.custom(z.el.orig[prop], 0); }; - // IE has trouble with opacity if it does not have layout - if ( jQuery.browser.msie && !z.el.currentStyle.hasLayout ) - y.zoom = "1"; - // Remember the overflow of the element if ( !z.el.oldOverlay ) z.el.oldOverflow = jQuery.css( z.el, "overflow" ); // Make sure that nothing sneaks out - //if ( z.el.oldOverlay == "visible" ) y.overflow = "hidden"; // Each step of an animation @@ -473,22 +528,38 @@ jQuery.extend({ z.now = lastNum; z.a(); - // Hide the element if the "hide" operation was done - if ( z.o.hide ) y.display = 'none'; - - // Reset the overflow - y.overflow = z.el.oldOverflow; - - // Reset the property, if the item has been hidden - if ( z.o.hide ) - y[ prop ] = z.el.orig[ prop ].constructor == Number && prop != "opacity" ? - z.el.orig[prop] + "px" : z.el.orig[prop]; - - // set its height and/or width to auto - jQuery.setAuto( z.el, prop ); + z.el.curAnim[ prop ] = true; + + var done = true; + for ( var i in z.el.curAnim ) + if ( z.el.curAnim[i] !== true ) + done = false; + + if ( done ) { + // Reset the overflow + y.overflow = z.el.oldOverflow; + + // Hide the element if the "hide" operation was done + if ( z.o.hide ) + y.display = 'none'; + + // Reset the property, if the item has been hidden + if ( z.o.hide ) { + for ( var p in z.el.curAnim ) { + if (p == "opacity" && jQuery.browser.msie) + jQuery.attr(y, p, z.el.orig[p]); + else + y[ p ] = z.el.orig[p] + "px"; + + // set its height and/or width to auto + if ( p == 'height' || p == 'width' ) + jQuery.setAuto( z.el, p ); + } + } + } // If a callback was provided, execute it - if( z.o.complete && z.o.complete.constructor == Function ) + if( done && z.o.complete && z.o.complete.constructor == Function ) // Execute the complete function z.o.complete.apply( z.el ); } else {