3 // overwrite the old show method
4 //_show: jQuery.fn.show,
7 * Show all matched elements using a graceful animation.
8 * The height, width, and opacity of each of the matched elements
9 * are changed dynamically according to the specified speed.
11 * @example $("p").show("slow");
15 * @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).
16 * @cat Effects/Animations
20 * Show all matched elements using a graceful animation and firing a callback
21 * function after completion.
22 * The height, width, and opacity of each of the matched elements
23 * are changed dynamically according to the specified speed.
25 * @example $("p").show("slow",function(){
26 * alert("Animation Done.");
31 * @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).
32 * @param Function callback A function to be executed whenever the animation completes.
33 * @cat Effects/Animations
35 show: function(speed,callback){
36 return speed ? this.animate({
37 height: "show", width: "show", opacity: "show"
38 }, speed, callback) : this._show();
41 // Overwrite the old hide method
42 //_hide: jQuery.fn.hide,
45 * Hide all matched elements using a graceful animation.
46 * The height, width, and opacity of each of the matched elements
47 * are changed dynamically according to the specified speed.
49 * @example $("p").hide("slow");
53 * @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).
54 * @cat Effects/Animations
58 * Hide all matched elements using a graceful animation and firing a callback
59 * function after completion.
60 * The height, width, and opacity of each of the matched elements
61 * are changed dynamically according to the specified speed.
63 * @example $("p").hide("slow",function(){
64 * alert("Animation Done.");
69 * @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).
70 * @param Function callback A function to be executed whenever the animation completes.
71 * @cat Effects/Animations
73 hide: function(speed,callback){
74 return speed ? this.animate({
75 height: "hide", width: "hide", opacity: "hide"
76 }, speed, callback) : this._hide();
80 * Reveal all matched elements by adjusting their height.
81 * Only the height is adjusted for this animation, causing all matched
82 * elements to be revealed in a "sliding" manner.
84 * @example $("p").slideDown("slow");
88 * @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).
89 * @cat Effects/Animations
93 * Reveal all matched elements by adjusting their height and firing a callback
94 * function after completion.
95 * Only the height is adjusted for this animation, causing all matched
96 * elements to be revealed in a "sliding" manner.
98 * @example $("p").slideDown("slow",function(){
99 * alert("Animation Done.");
104 * @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).
105 * @param Function callback A function to be executed whenever the animation completes.
106 * @cat Effects/Animations
108 slideDown: function(speed,callback){
109 return this.animate({height: "show"}, speed, callback);
113 * Hide all matched elements by adjusting their height.
114 * Only the height is adjusted for this animation, causing all matched
115 * elements to be hidden in a "sliding" manner.
117 * @example $("p").slideUp("slow");
121 * @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).
122 * @cat Effects/Animations
126 * Hide all matched elements by adjusting their height and firing a callback
127 * function after completion.
128 * Only the height is adjusted for this animation, causing all matched
129 * elements to be hidden in a "sliding" manner.
131 * @example $("p").slideUp("slow",function(){
132 * alert("Animation Done.");
137 * @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).
138 * @param Function callback A function to be executed whenever the animation completes.
139 * @cat Effects/Animations
141 slideUp: function(speed,callback){
142 return this.animate({height: "hide"}, speed, callback);
145 slideToggle: function(speed,callback){
146 return this.each(function(){
147 var state = $(this).is(":hidden") ? "show" : "hide";
148 $(this).animate({height: state}, speed, callback);
153 * Fade in all matched elements by adjusting their opacity.
154 * Only the opacity is adjusted for this animation, meaning that
155 * all of the matched elements should already have some form of height
156 * and width associated with them.
158 * @example $("p").fadeIn("slow");
162 * @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).
163 * @cat Effects/Animations
167 * Fade in all matched elements by adjusting their opacity and firing a
168 * callback function after completion.
169 * Only the opacity is adjusted for this animation, meaning that
170 * all of the matched elements should already have some form of height
171 * and width associated with them.
173 * @example $("p").fadeIn("slow",function(){
174 * alert("Animation Done.");
179 * @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).
180 * @param Function callback A function to be executed whenever the animation completes.
181 * @cat Effects/Animations
183 fadeIn: function(speed,callback){
184 return this.animate({opacity: "show"}, speed, callback);
188 * Fade out all matched elements by adjusting their opacity.
189 * Only the opacity is adjusted for this animation, meaning that
190 * all of the matched elements should already have some form of height
191 * and width associated with them.
193 * @example $("p").fadeOut("slow");
197 * @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).
198 * @cat Effects/Animations
202 * Fade out all matched elements by adjusting their opacity and firing a
203 * callback function after completion.
204 * Only the opacity is adjusted for this animation, meaning that
205 * all of the matched elements should already have some form of height
206 * and width associated with them.
208 * @example $("p").fadeOut("slow",function(){
209 * alert("Animation Done.");
214 * @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).
215 * @param Function callback A function to be executed whenever the animation completes.
216 * @cat Effects/Animations
218 fadeOut: function(speed,callback){
219 return this.animate({opacity: "hide"}, speed, callback);
223 * Fade the opacity of all matched elements to a specified opacity.
224 * Only the opacity is adjusted for this animation, meaning that
225 * all of the matched elements should already have some form of height
226 * and width associated with them.
228 * @example $("p").fadeTo("slow", 0.5);
232 * @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).
233 * @param Number opacity The opacity to fade to (a number from 0 to 1).
234 * @cat Effects/Animations
238 * Fade the opacity of all matched elements to a specified opacity and
239 * firing a callback function after completion.
240 * Only the opacity is adjusted for this animation, meaning that
241 * all of the matched elements should already have some form of height
242 * and width associated with them.
244 * @example $("p").fadeTo("slow", 0.5, function(){
245 * alert("Animation Done.");
250 * @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).
251 * @param Number opacity The opacity to fade to (a number from 0 to 1).
252 * @param Function callback A function to be executed whenever the animation completes.
253 * @cat Effects/Animations
255 fadeTo: function(speed,to,callback){
256 return this.animate({opacity: to}, speed, callback);
262 animate: function(prop,speed,callback) {
263 return this.queue(function(){
265 for ( var p in prop ) {
266 var e = new jQuery.fx( this, jQuery.speed(speed,callback,i++), p );
267 if ( prop[p].constructor == Number )
268 e.custom( e.cur(), prop[p] );
270 e[ prop[p] ]( prop );
279 queue: function(type,fn){
285 return this.each(function(){
289 if ( !this.queue[type] )
290 this.queue[type] = [];
292 this.queue[type].push( fn );
294 if ( this.queue[type].length == 1 )
303 setAuto: function(e,p) {
304 if ( e.notAuto ) return;
306 if ( p == "height" && e.scrollHeight != parseInt(jQuery.curCSS(e,p)) ) return;
307 if ( p == "width" && e.scrollWidth != parseInt(jQuery.curCSS(e,p)) ) return;
309 // Remember the original height
312 // Figure out the size of the height right now
313 var o = jQuery.curCSS(e,p,1);
315 if ( p == "height" && e.scrollHeight != o ||
316 p == "width" && e.scrollWidth != o ) return;
318 // Set the height to auto
319 e.style[p] = e.currentStyle ? "" : "auto";
321 // See what the size of "auto" is
322 var n = jQuery.curCSS(e,p,1);
324 // Revert back to the original size
325 if ( o != n && n != "auto" ) {
331 speed: function(s,o,i) {
334 if ( o.constructor == Function )
337 var ss = { slow: 600, fast: 200 };
338 o.duration = (s && s.constructor == Number ? s : ss[s]) || 400;
341 o.oldComplete = o.complete;
342 o.complete = function(){
343 jQuery.dequeue(this, "fx");
344 if ( o.oldComplete && o.oldComplete.constructor == Function )
345 o.oldComplete.apply( this );
356 dequeue: function(elem,type){
359 if ( elem.queue && elem.queue[type] ) {
361 elem.queue[type].shift();
364 var f = elem.queue[type][0];
366 if ( f ) f.apply( elem );
371 * I originally wrote fx() as a clone of moo.fx and in the process
372 * of making it small in size the code became illegible to sane
373 * people. You've been warned.
376 fx: function( elem, options, prop ){
382 duration: options.duration || 400,
383 complete: options.complete,
393 // Simple function for setting a style value
396 options.step.apply( elem, [ z.now ] );
398 if ( prop == "opacity" ) {
399 if (z.now == 1) z.now = 0.9999;
400 if (window.ActiveXObject)
401 y.filter = "alpha(opacity=" + z.now*100 + ")";
405 // My hate for IE will never die
406 } else if ( parseInt(z.now) )
407 y[prop] = parseInt(z.now) + "px";
411 // Figure out the maximum number to run to
413 return parseFloat( jQuery.css(z.el,prop) );
416 // Get the current size
418 var r = parseFloat( jQuery.curCSS(z.el, prop) );
419 return r && r > -10000 ? r : z.max();
422 // Start an animation from one number to another
423 z.custom = function(from,to){
424 z.startTime = (new Date()).getTime();
428 z.timer = setInterval(function(){
433 // Simple 'show' function
434 z.show = function( p ){
435 if ( !z.el.orig ) z.el.orig = {};
437 // Remember where we started, so that we can go back to it later
438 z.el.orig[prop] = this.cur();
440 z.custom( 0, z.el.orig[prop] );
442 // Stupid IE, look what you made me do
443 if ( prop != "opacity" )
447 // Simple 'hide' function
449 if ( !z.el.orig ) z.el.orig = {};
451 // Remember where we started, so that we can go back to it later
452 z.el.orig[prop] = this.cur();
456 // Begin the animation
460 // IE has trouble with opacity if it does not have layout
461 if ( jQuery.browser.msie && !z.el.currentStyle.hasLayout )
464 // Remember the overflow of the element
465 if ( !z.el.oldOverlay )
466 z.el.oldOverflow = jQuery.css( z.el, "overflow" );
468 // Make sure that nothing sneaks out
469 //if ( z.el.oldOverlay == "visible" )
470 y.overflow = "hidden";
472 // Each step of an animation
473 z.step = function(firstNum, lastNum){
474 var t = (new Date()).getTime();
476 if (t > z.o.duration + z.startTime) {
478 clearInterval(z.timer);
484 // Hide the element if the "hide" operation was done
485 if ( z.o.hide ) y.display = 'none';
487 // Reset the overflow
488 y.overflow = z.el.oldOverflow;
490 // Reset the property, if the item has been hidden
492 y[ prop ] = z.el.orig[ prop ].constructor == Number && prop != "opacity" ?
493 z.el.orig[prop] + "px" : z.el.orig[prop];
495 // set its height and/or width to auto
496 if ( prop == 'height' || prop == 'width' )
497 jQuery.setAuto( z.el, prop );
499 // If a callback was provided, execute it
500 if( z.o.complete && z.o.complete.constructor == Function )
501 // Execute the complete function
502 z.o.complete.apply( z.el );
504 // Figure out where in the animation we are and set the number
505 var p = (t - this.startTime) / z.o.duration;
506 z.now = ((-Math.cos(p*Math.PI)/2) + 0.5) * (lastNum-firstNum) + firstNum;
508 // Perform the next step of the animation