dojo-rails 0.9.9 → 0.9.10

data/vendor/assets/javascripts/dojo/_base/fx.js.uncompressed.js

@@ -1,42 +1,48 @@
-define("dojo/_base/fx", ["./kernel", "./lang", "../Evented", "./Color", "./connect", "./sniff", "../dom", "../dom-style"], function(dojo, lang, Evented, Color, connect, has, dom, style){
+define("dojo/_base/fx", ["./kernel", "./config", /*===== "./declare", =====*/ "./lang", "../Evented", "./Color", "./connect", "./sniff", "../dom", "../dom-style"],
+	function(dojo, config, /*===== declare, =====*/ lang, Evented, Color, connect, has, dom, style){
 	// module:
 	//		dojo/_base/fx
-	// summary:
-	//		This module defines the base dojo.fx implementation.
 	// notes:
 	//		Animation loosely package based on Dan Pupius' work, contributed under CLA; see
 	//		http://pupius.co.uk/js/Toolkit.Drawing.js
 
 	var _mixin = lang.mixin;
 
-	dojo._Line = function(/*int*/ start, /*int*/ end){
-		//	summary:
-		//		dojo._Line is the object used to generate values from a start value
-		//		to an end value
-		//	start: int
+	// Module export
+	var basefx = {
+		// summary:
+		//		This module defines the base dojo/_base/fx implementation.
+	};
+
+	var _Line = basefx._Line = function(/*int*/ start, /*int*/ end){
+		// summary:
+		//		Object used to generate values from a start value to an end value
+		// start: int
 		//		Beginning value for range
-		//	end: int
+		// end: int
 		//		Ending value for range
 		this.start = start;
 		this.end = end;
 	};
 
-	dojo._Line.prototype.getValue = function(/*float*/ n){
-		//	summary: Returns the point on the line
-		//	n: a floating point number greater than 0 and less than 1
+	_Line.prototype.getValue = function(/*float*/ n){
+		// summary:
+		//		Returns the point on the line
+		// n:
+		//		a floating point number greater than 0 and less than 1
 		return ((this.end - this.start) * n) + this.start; // Decimal
 	};
 
-	dojo.Animation = function(args){
-		//	summary:
+	var Animation = basefx.Animation = function(args){
+		// summary:
 		//		A generic animation class that fires callbacks into its handlers
 		//		object at various states.
-		//	description:
+		// description:
 		//		A generic animation class that fires callbacks into its handlers
 		//		object at various states. Nearly all dojo animation functions
 		//		return an instance of this method, usually without calling the
 		//		.play() method beforehand. Therefore, you will likely need to
-		//		call .play() on instances of `dojo.Animation` when one is
+		//		call .play() on instances of `Animation` when one is
 		//		returned.
 		// args: Object
 		//		The 'magic argument', mixing all the properties into this
@@ -44,28 +50,26 @@ define("dojo/_base/fx", ["./kernel", "./lang", "../Evented", "./Color", "./conne
 
 		_mixin(this, args);
 		if(lang.isArray(this.curve)){
-			this.curve = new dojo._Line(this.curve[0], this.curve[1]);
+			this.curve = new _Line(this.curve[0], this.curve[1]);
 		}
 
 	};
-	dojo.Animation.prototype = new Evented();
-	// Alias to drop come 2.0:
-	dojo._Animation = dojo.Animation;
+	Animation.prototype = new Evented();
 
-	lang.extend(dojo.Animation, {
+	lang.extend(Animation, {
 		// duration: Integer
-		//		The time in milliseonds the animation will take to run
+		//		The time in milliseconds the animation will take to run
 		duration: 350,
 
 	/*=====
-		// curve: dojo._Line|Array
-		//		A two element array of start and end values, or a `dojo._Line` instance to be
+		// curve: _Line|Array
+		//		A two element array of start and end values, or a `_Line` instance to be
 		//		used in the Animation.
 		curve: null,
 
 		// easing: Function?
 		//		A Function to adjust the acceleration (or deceleration) of the progress
-		//		across a dojo._Line
+		//		across a _Line
 		easing: null,
 	=====*/
 
@@ -85,31 +89,31 @@ define("dojo/_base/fx", ["./kernel", "./lang", "../Evented", "./Color", "./conne
 		delay: null,
 
 		// beforeBegin: Event?
-		//		Synthetic event fired before a dojo.Animation begins playing (synchronous)
+		//		Synthetic event fired before a Animation begins playing (synchronous)
 		beforeBegin: null,
 
 		// onBegin: Event?
-		//		Synthetic event fired as a dojo.Animation begins playing (useful?)
+		//		Synthetic event fired as a Animation begins playing (useful?)
 		onBegin: null,
 
 		// onAnimate: Event?
-		//		Synthetic event fired at each interval of a `dojo.Animation`
+		//		Synthetic event fired at each interval of the Animation
 		onAnimate: null,
 
 		// onEnd: Event?
-		//		Synthetic event fired after the final frame of a `dojo.Animation`
+		//		Synthetic event fired after the final frame of the Animation
 		onEnd: null,
 
 		// onPlay: Event?
-		//		Synthetic event fired any time a `dojo.Animation` is play()'ed
+		//		Synthetic event fired any time the Animation is play()'ed
 		onPlay: null,
 
 		// onPause: Event?
-		//		Synthetic event fired when a `dojo.Animation` is paused
+		//		Synthetic event fired when the Animation is paused
 		onPause: null,
 
 		// onStop: Event
-		//		Synthetic event fires when a `dojo.Animation` is stopped
+		//		Synthetic event fires when the Animation is stopped
 		onStop: null,
 
 	=====*/
@@ -124,21 +128,21 @@ define("dojo/_base/fx", ["./kernel", "./lang", "../Evented", "./Color", "./conne
 			return _e ? _e(_p) : _p;
 		},
 		_fire: function(/*Event*/ evt, /*Array?*/ args){
-			//	summary:
+			// summary:
 			//		Convenience function.  Fire event "evt" and pass it the
 			//		arguments specified in "args".
-			//	description:
+			// description:
 			//		Convenience function.  Fire event "evt" and pass it the
 			//		arguments specified in "args".
-			//		Fires the callback in the scope of the `dojo.Animation`
+			//		Fires the callback in the scope of this Animation
 			//		instance.
-			//	evt:
+			// evt:
 			//		The event to fire.
-			//	args:
+			// args:
 			//		The arguments to pass to the event.
 			var a = args||[];
 			if(this[evt]){
-				if(dojo.config.debugAtAllCosts){
+				if(config.debugAtAllCosts){
 					this[evt].apply(this, a);
 				}else{
 					try{
@@ -154,7 +158,7 @@ define("dojo/_base/fx", ["./kernel", "./lang", "../Evented", "./Color", "./conne
 					}
 				}
 			}
-			return this; // dojo.Animation
+			return this; // Animation
 		},
 
 		play: function(/*int?*/ delay, /*Boolean?*/ gotoStart){
@@ -165,7 +169,7 @@ define("dojo/_base/fx", ["./kernel", "./lang", "../Evented", "./Color", "./conne
 			// gotoStart:
 			//		If true, starts the animation from the beginning; otherwise,
 			//		starts it from its current position.
-			// returns: dojo.Animation
+			// returns: Animation
 			//		The instance to allow chaining.
 
 			var _t = this;
@@ -188,7 +192,7 @@ define("dojo/_base/fx", ["./kernel", "./lang", "../Evented", "./Color", "./conne
 				return _t;
 			}
 			_p();
-			return _t;	// dojo.Animation
+			return _t;	// Animation
 		},
 
 		_play: function(gotoStart){
@@ -212,48 +216,51 @@ define("dojo/_base/fx", ["./kernel", "./lang", "../Evented", "./Color", "./conne
 			_t._fire("onPlay", [value]);
 
 			_t._cycle();
-			return _t; // dojo.Animation
+			return _t; // Animation
 		},
 
 		pause: function(){
-			// summary: Pauses a running animation.
+			// summary:
+			//		Pauses a running animation.
 			var _t = this;
 			if(_t._delayTimer){ _t._clearTimer(); }
 			_t._stopTimer();
-			if(!_t._active){ return _t; /*dojo.Animation*/ }
+			if(!_t._active){ return _t; /*Animation*/ }
 			_t._paused = true;
 			_t._fire("onPause", [_t.curve.getValue(_t._getStep())]);
-			return _t; // dojo.Animation
+			return _t; // Animation
 		},
 
 		gotoPercent: function(/*Decimal*/ percent, /*Boolean?*/ andPlay){
-			//	summary:
+			// summary:
 			//		Sets the progress of the animation.
-			//	percent:
+			// percent:
 			//		A percentage in decimal notation (between and including 0.0 and 1.0).
-			//	andPlay:
+			// andPlay:
 			//		If true, play the animation after setting the progress.
 			var _t = this;
 			_t._stopTimer();
 			_t._active = _t._paused = true;
 			_t._percent = percent;
 			if(andPlay){ _t.play(); }
-			return _t; // dojo.Animation
+			return _t; // Animation
 		},
 
 		stop: function(/*boolean?*/ gotoEnd){
-			// summary: Stops a running animation.
-			// gotoEnd: If true, the animation will end.
+			// summary:
+			//		Stops a running animation.
+			// gotoEnd:
+			//		If true, the animation will end.
 			var _t = this;
 			if(_t._delayTimer){ _t._clearTimer(); }
-			if(!_t._timer){ return _t; /* dojo.Animation */ }
+			if(!_t._timer){ return _t; /* Animation */ }
 			_t._stopTimer();
 			if(gotoEnd){
 				_t._percent = 1;
 			}
 			_t._fire("onStop", [_t.curve.getValue(_t._getStep())]);
 			_t._active = _t._paused = false;
-			return _t; // dojo.Animation
+			return _t; // Animation
 		},
 
 		status: function(){
@@ -270,7 +277,8 @@ define("dojo/_base/fx", ["./kernel", "./lang", "../Evented", "./Color", "./conne
 			var _t = this;
 			if(_t._active){
 				var curr = new Date().valueOf();
-				var step = (curr - _t._startTime) / (_t.duration);
+				// Allow durations of 0 (instant) by setting step to 1 - see #13798
+				var step = _t.duration === 0 ? 1 : (curr - _t._startTime) / (_t.duration);
 
 				if(step >= 1){
 					step = 1;
@@ -305,11 +313,12 @@ define("dojo/_base/fx", ["./kernel", "./lang", "../Evented", "./Color", "./conne
 					!_t.repeat && _t._stopTimer();
 				}
 			}
-			return _t; // dojo.Animation
+			return _t; // Animation
 		},
 
 		_clearTimer: function(){
-			// summary: Clear the play delay timer
+			// summary:
+			//		Clear the play delay timer
 			clearTimeout(this._delayTimer);
 			delete this._delayTimer;
 		}
@@ -323,7 +332,7 @@ define("dojo/_base/fx", ["./kernel", "./lang", "../Evented", "./Color", "./conne
 			run: function(){}
 		};
 
-	lang.extend(dojo.Animation, {
+	lang.extend(Animation, {
 
 		_startTimer: function(){
 			if(!this._timer){
@@ -351,7 +360,7 @@ define("dojo/_base/fx", ["./kernel", "./lang", "../Evented", "./Color", "./conne
 	});
 
 	var _makeFadeable =
-				has("ie") ? function(node){
+		has("ie") ? function(node){
 			// only set the zoom if the "tickle" value would be the same as the
 			// default
 			var ns = node.style;
@@ -361,10 +370,10 @@ define("dojo/_base/fx", ["./kernel", "./lang", "../Evented", "./Color", "./conne
 				ns.width = "auto";
 			}
 		} :
-				function(){};
+		function(){};
 
-	dojo._fade = function(/*Object*/ args){
-		//	summary:
+	basefx._fade = function(/*Object*/ args){
+		// summary:
 		//		Returns an animation that will fade the node defined by
 		//		args.node from the start to end values passed (args.start
 		//		args.end) (end is mandatory, start is optional)
@@ -379,42 +388,40 @@ define("dojo/_base/fx", ["./kernel", "./lang", "../Evented", "./Color", "./conne
 			} : fArgs.start;
 		props.end = fArgs.end;
 
-		var anim = dojo.animateProperty(fArgs);
+		var anim = basefx.animateProperty(fArgs);
 		connect.connect(anim, "beforeBegin", lang.partial(_makeFadeable, fArgs.node));
 
-		return anim; // dojo.Animation
+		return anim; // Animation
 	};
 
 	/*=====
-	dojo.__FadeArgs = function(node, duration, easing){
-		//	node: DOMNode|String
+	var __FadeArgs = declare(null, {
+		// node: DOMNode|String
 		//		The node referenced in the animation
-		//	duration: Integer?
+		// duration: Integer?
 		//		Duration of the animation in milliseconds.
-		//	easing: Function?
+		// easing: Function?
 		//		An easing function.
-		this.node = node;
-		this.duration = duration;
-		this.easing = easing;
-	}
+	});
 	=====*/
 
-	dojo.fadeIn = function(/*dojo.__FadeArgs*/ args){
+	basefx.fadeIn = function(/*__FadeArgs*/ args){
 		// summary:
 		//		Returns an animation that will fade node defined in 'args' from
 		//		its current opacity to fully opaque.
-		return dojo._fade(_mixin({ end: 1 }, args)); // dojo.Animation
+		return basefx._fade(_mixin({ end: 1 }, args)); // Animation
 	};
 
-	dojo.fadeOut = function(/*dojo.__FadeArgs*/ args){
+	basefx.fadeOut = function(/*__FadeArgs*/ args){
 		// summary:
 		//		Returns an animation that will fade node defined in 'args'
 		//		from its current opacity to fully transparent.
-		return dojo._fade(_mixin({ end: 0 }, args)); // dojo.Animation
+		return basefx._fade(_mixin({ end: 0 }, args)); // Animation
 	};
 
-	dojo._defaultEasing = function(/*Decimal?*/ n){
-		// summary: The default easing function for dojo.Animation(s)
+	basefx._defaultEasing = function(/*Decimal?*/ n){
+		// summary:
+		//		The default easing function for Animation(s)
 		return 0.5 + ((Math.sin((n + 1.5) * Math.PI)) / 2);	// Decimal
 	};
 
@@ -448,43 +455,43 @@ define("dojo/_base/fx", ["./kernel", "./lang", "../Evented", "./Color", "./conne
 	};
 
 	/*=====
-	dojo.declare("dojo.__AnimArgs", [dojo.__FadeArgs], {
-		// Properties: Object?
-		//	A hash map of style properties to Objects describing the transition,
-		//	such as the properties of dojo._Line with an additional 'units' property
+	var __AnimArgs = declare(__FadeArgs, {
+		// properties: Object?
+		//		A hash map of style properties to Objects describing the transition,
+		//		such as the properties of _Line with an additional 'units' property
 		properties: {}
 
 		//TODOC: add event callbacks
 	});
 	=====*/
 
-	dojo.animateProperty = function(/*dojo.__AnimArgs*/ args){
+	basefx.animateProperty = function(/*__AnimArgs*/ args){
 		// summary:
 		//		Returns an animation that will transition the properties of
 		//		node defined in `args` depending how they are defined in
 		//		`args.properties`
 		//
 		// description:
-		//		`dojo.animateProperty` is the foundation of most `dojo.fx`
+		//		Foundation of most `dojo/_base/fx`
 		//		animations. It takes an object of "properties" corresponding to
 		//		style properties, and animates them in parallel over a set
 		//		duration.
 		//
 		// example:
 		//		A simple animation that changes the width of the specified node.
-		//	|	dojo.animateProperty({
+		//	|	basefx.animateProperty({
 		//	|		node: "nodeId",
 		//	|		properties: { width: 400 },
 		//	|	}).play();
 		//		Dojo figures out the start value for the width and converts the
 		//		integer specified for the width to the more expressive but
 		//		verbose form `{ width: { end: '400', units: 'px' } }` which you
-		//		can also specify directly. Defaults to 'px' if ommitted.
+		//		can also specify directly. Defaults to 'px' if omitted.
 		//
 		// example:
 		//		Animate width, height, and padding over 2 seconds... the
 		//		pedantic way:
-		//	|	dojo.animateProperty({ node: node, duration:2000,
+		//	|	basefx.animateProperty({ node: node, duration:2000,
 		//	|		properties: {
 		//	|			width: { start: '200', end: '400', units:"px" },
 		//	|			height: { start:'200', end: '400', units:"px" },
@@ -499,7 +506,7 @@ define("dojo/_base/fx", ["./kernel", "./lang", "../Evented", "./Color", "./conne
 		//		when the animation ends. Easing functions accept values between
 		//		zero and one and return a value on that basis. In this case, an
 		//		exponential-in curve.
-		//	|	dojo.animateProperty({
+		//	|	basefx.animateProperty({
 		//	|		node: "nodeId",
 		//	|		// dojo figures out the start value
 		//	|		properties: { width: { end: 400 } },
@@ -513,31 +520,31 @@ define("dojo/_base/fx", ["./kernel", "./lang", "../Evented", "./Color", "./conne
 		//	|	}).play(500); // delay playing half a second
 		//
 		// example:
-		//		Like all `dojo.Animation`s, animateProperty returns a handle to the
-		//		Animation instance, which fires the events common to Dojo FX. Use `dojo.connect`
-		//		to access these events outside of the Animation definiton:
-		//	|	var anim = dojo.animateProperty({
+		//		Like all `Animation`s, animateProperty returns a handle to the
+		//		Animation instance, which fires the events common to Dojo FX. Use `aspect.after`
+		//		to access these events outside of the Animation definition:
+		//	|	var anim = basefx.animateProperty({
 		//	|		node:"someId",
 		//	|		properties:{
 		//	|			width:400, height:500
 		//	|		}
 		//	|	});
-		//	|	dojo.connect(anim,"onEnd", function(){
+		//	|	aspect.after(anim, "onEnd", function(){
 		//	|		console.log("animation ended");
-		//	|	});
+		//	|	}, true);
 		//	|	// play the animation now:
 		//	|	anim.play();
 		//
 		// example:
 		//		Each property can be a function whose return value is substituted along.
 		//		Additionally, each measurement (eg: start, end) can be a function. The node
-		//		reference is passed direcly to callbacks.
-		//	|	dojo.animateProperty({
+		//		reference is passed directly to callbacks.
+		//	|	basefx.animateProperty({
 		//	|		node:"mine",
 		//	|		properties:{
 		//	|			height:function(node){
 		//	|				// shrink this node by 50%
-		//	|				return dojo.position(node).h / 2
+		//	|				return domGeom.position(node).h / 2
 		//	|			},
 		//	|			width:{
 		//	|				start:function(node){ return 100; },
@@ -550,7 +557,7 @@ define("dojo/_base/fx", ["./kernel", "./lang", "../Evented", "./Color", "./conne
 		var n = args.node = dom.byId(args.node);
 		if(!args.easing){ args.easing = dojo._defaultEasing; }
 
-		var anim = new dojo.Animation(args);
+		var anim = new Animation(args);
 		connect.connect(anim, "beforeBegin", anim, function(){
 			var pm = {};
 			for(var p in this.properties){
@@ -575,7 +582,7 @@ define("dojo/_base/fx", ["./kernel", "./lang", "../Evented", "./Color", "./conne
 				}
 				var isColor = (p.toLowerCase().indexOf("color") >= 0);
 				function getStyle(node, p){
-					// dojo.style(node, "height") can return "auto" or "" on IE; this is more reliable:
+					// domStyle.get(node, "height") can return "auto" or "" on IE; this is more reliable:
 					var v = { height: node.offsetHeight, width: node.offsetWidth }[p];
 					if(v !== undefined){ return v; }
 					v = style.get(node, p);
@@ -597,70 +604,67 @@ define("dojo/_base/fx", ["./kernel", "./lang", "../Evented", "./Color", "./conne
 			this.curve = new PropLine(pm);
 		});
 		connect.connect(anim, "onAnimate", lang.hitch(style, "set", anim.node));
-		return anim; // dojo.Animation
+		return anim; // Animation
 	};
 
-	dojo.anim = function(	/*DOMNode|String*/	node,
+	basefx.anim = function(	/*DOMNode|String*/	node,
 							/*Object*/			properties,
 							/*Integer?*/		duration,
 							/*Function?*/		easing,
 							/*Function?*/		onEnd,
 							/*Integer?*/		delay){
-		//	summary:
-		//		A simpler interface to `dojo.animateProperty()`, also returns
-		//		an instance of `dojo.Animation` but begins the animation
+		// summary:
+		//		A simpler interface to `animateProperty()`, also returns
+		//		an instance of `Animation` but begins the animation
 		//		immediately, unlike nearly every other Dojo animation API.
-		//	description:
-		//		`dojo.anim` is a simpler (but somewhat less powerful) version
-		//		of `dojo.animateProperty`.  It uses defaults for many basic properties
+		// description:
+		//		Simpler (but somewhat less powerful) version
+		//		of `animateProperty`.  It uses defaults for many basic properties
 		//		and allows for positional parameters to be used in place of the
 		//		packed "property bag" which is used for other Dojo animation
 		//		methods.
 		//
-		//		The `dojo.Animation` object returned from `dojo.anim` will be
-		//		already playing when it is returned from this function, so
+		//		The `Animation` object returned will be already playing, so
 		//		calling play() on it again is (usually) a no-op.
-		//	node:
+		// node:
 		//		a DOM node or the id of a node to animate CSS properties on
-		//	duration:
+		// duration:
 		//		The number of milliseconds over which the animation
 		//		should run. Defaults to the global animation default duration
 		//		(350ms).
-		//	easing:
+		// easing:
 		//		An easing function over which to calculate acceleration
 		//		and deceleration of the animation through its duration.
 		//		A default easing algorithm is provided, but you may
 		//		plug in any you wish. A large selection of easing algorithms
-		//		are available in `dojo.fx.easing`.
-		//	onEnd:
+		//		are available in `dojo/fx/easing`.
+		// onEnd:
 		//		A function to be called when the animation finishes
 		//		running.
-		//	delay:
+		// delay:
 		//		The number of milliseconds to delay beginning the
 		//		animation by. The default is 0.
-		//	example:
+		// example:
 		//		Fade out a node
-		//	|	dojo.anim("id", { opacity: 0 });
-		//	example:
+		//	|	basefx.anim("id", { opacity: 0 });
+		// example:
 		//		Fade out a node over a full second
-		//	|	dojo.anim("id", { opacity: 0 }, 1000);
-		return dojo.animateProperty({ // dojo.Animation
+		//	|	basefx.anim("id", { opacity: 0 }, 1000);
+		return basefx.animateProperty({ // Animation
 			node: node,
-			duration: duration || dojo.Animation.prototype.duration,
+			duration: duration || Animation.prototype.duration,
 			properties: properties,
 			easing: easing,
 			onEnd: onEnd
 		}).play(delay || 0);
 	};
 
-	return {
-		_Line: dojo._Line,
-		Animation: dojo.Animation,
-		_fade: dojo._fade,
-		fadeIn: dojo.fadeIn,
-		fadeOut: dojo.fadeOut,
-		_defaultEasing: dojo._defaultEasing,
-		animateProperty: dojo.animateProperty,
-		anim: dojo.anim
-	};
+
+	if( 1 ){
+		_mixin(dojo, basefx);
+		// Alias to drop come 2.0:
+		dojo._Animation = Animation;
+	}
+
+	return basefx;
 });