From ef68436ac04da078ffdcacd7e1f785473a303d45 Mon Sep 17 00:00:00 2001 From: Giulio Cesare Solaroli Date: Sun, 02 Oct 2011 23:56:18 +0000 Subject: First version of the newly restructured repository --- (limited to 'frontend/beta/js/YUI-extensions/anim/Animator.js') diff --git a/frontend/beta/js/YUI-extensions/anim/Animator.js b/frontend/beta/js/YUI-extensions/anim/Animator.js new file mode 100644 index 0000000..ed250fb --- a/dev/null +++ b/frontend/beta/js/YUI-extensions/anim/Animator.js @@ -0,0 +1,482 @@ +/** + * @class YAHOO.ext.Animator + * Provides support for syncing animations for multiple {@link YAHOO.ext.Actor}s.

+*

This example can be seen in action here +* by clicking on "Click here and I will point it out" at the end of the first paragraph.
+ * 

+var animator = new YAHOO.ext.Animator();
+var cursor = new YAHOO.ext.Actor('cursor-img', animator);
+var click = new YAHOO.ext.Actor('click-img', animator);
+var resize = new YAHOO.ext.Actor('resize-img', animator);
+
+// start capturing
+animator.startCapture();
+
+// these animations will be run in sequence
+cursor.show();
+cursor.moveTo(500,400);
+cursor.moveTo(20, getEl('navbar').getY()+10, true, .75);
+click.show();
+click.alignTo(cursor, 'tl', [-4, -4]);
+
+// Add an async function call, pass callback to argument 1
+animator.addAsyncCall(Blog.navbar.undockDelegate, 1);
+
+// pause .5 seconds
+animator.pause(.5);
+
+// again, these animations will be run in sequence
+click.hide(true, .7);
+cursor.alignTo('splitter', 'tr', [0, +100], true, 1);
+resize.alignTo('splitter', 'tr', [-12, +100]);
+
+// start sync block: these animations will run at the same time
+animator.beginSync();
+cursor.hide();
+resize.show();
+animator.endSync();
+
+// play the captured animation sequences, call myCallback when done
+animator.play(myCallback);
+ *
+ * @requires YAHOO.ext.Element + * @requires YAHOO.util.Dom + * @requires YAHOO.util.Event + * @requires YAHOO.util.CustomEvent + * @requires YAHOO.util.Anim + * @requires YAHOO.util.ColorAnim + * @requires YAHOO.util.Motion + * @constructor + * @param {String/HTMLElement} el The dom element or element id + * @param {YAHOO.ext.Animator} animator (optional) The Animator that will capture this Actor's actions + * @param {Boolean} selfCapture (optional) Whether this actor should capture it's own actions to support self playback without an animator (defaults to false) + */ + YAHOO.ext.Animator = function(/*Actors...*/){ + this.actors = []; + this.playlist = new YAHOO.ext.Animator.AnimSequence(); + this.captureDelegate = this.capture.createDelegate(this); + this.playDelegate = this.play.createDelegate(this); + this.syncing = false; + this.stopping = false; + this.playing = false; + for(var i = 0; i < arguments.length; i++){ + this.addActor(arguments[i]); + } + }; + + YAHOO.ext.Animator.prototype = { + + capture : function(actor, action){ + if(this.syncing){ + if(!this.syncMap[actor.id]){ + this.syncMap[actor.id] = new YAHOO.ext.Animator.AnimSequence(); + } + this.syncMap[actor.id].add(action); + }else{ + this.playlist.add(action); + } + }, + + /** + * Add an actor. The actor is also set to capturing = true. + * @param {YAHOO.ext.Actor} actor + */ + addActor : function(actor){ + actor.onCapture.subscribe(this.captureDelegate); + this.actors.push(actor); + }, + + + /** + * Start capturing actions on the added actors. + * @param {Boolean} clearPlaylist Whether to also create a new playlist + */ + startCapture : function(clearPlaylist){ + for(var i = 0; i < this.actors.length; i++){ + var a = this.actors[i]; + if(!this.isCapturing(a)){ + a.onCapture.subscribe(this.captureDelegate); + } + a.capturing = true; + } + if(clearPlaylist){ + this.playlist = new YAHOO.ext.Animator.AnimSequence(); + } + }, + + /** + * Checks whether this animator is listening to a specific actor. + * @param {YAHOO.ext.Actor} actor + */ + isCapturing : function(actor){ + var subscribers = actor.onCapture.subscribers; + if(subscribers){ + for(var i = 0; i < subscribers.length; i++){ + if(subscribers[i] && subscribers[i].contains(this.captureDelegate)){ + return true; + } + } + } + return false; + }, + + /** + * Stop capturing on all added actors. + */ + stopCapture : function(){ + for(var i = 0; i < this.actors.length; i++){ + var a = this.actors[i]; + a.onCapture.unsubscribe(this.captureDelegate); + a.capturing = false; + } + }, + + /** + * Start a multi-actor sync block. By default all animations are run in sequence. While in the sync block + * each actor's own animations will still be sequenced, but all actors will animate at the same time. + */ + beginSync : function(){ + this.syncing = true; + this.syncMap = {}; + }, + + /** + * End the multi-actor sync block + */ + endSync : function(){ + this.syncing = false; + var composite = new YAHOO.ext.Animator.CompositeSequence(); + for(key in this.syncMap){ + if(typeof this.syncMap[key] != 'function'){ + composite.add(this.syncMap[key]); + } + } + this.playlist.add(composite); + this.syncMap = null; + }, + + /** + * Starts playback of the playlist, also stops any capturing. To start capturing again call {@link #startCapture}. + * @param {Function} oncomplete (optional) Callback to execute when playback has completed + */ + play : function(oncomplete){ + if(this.playing) return; // can't play the same animation twice at once + this.stopCapture(); + this.playlist.play(oncomplete); + }, + + /** + * Stop at the next available stopping point + */ + stop : function(){ + this.playlist.stop(); + }, + + /** + * Check if this animator is currently playing + */ + isPlaying : function(){ + return this.playlist.isPlaying(); + }, + /** + * Clear the playlist + */ + clear : function(){ + this.playlist = new YAHOO.ext.Animator.AnimSequence(); + }, + + /** + * Add a function call to the playlist. + * @param {Function} fcn The function to call + * @param {Array} args The arguments to call the function with + * @param {Object} scope (optional) The scope of the function + */ + addCall : function(fcn, args, scope){ + this.playlist.add(new YAHOO.ext.Actor.Action(scope, fcn, args || [])); + }, + + /** + * Add an async function call to the playlist. + * @param {Function} fcn The function to call + * @param {Number} callbackIndex The index of the callback parameter on the passed function. A CALLBACK IS REQUIRED. + * @param {Array} args The arguments to call the function with + * @param {Object} scope (optional) The scope of the function + */ + addAsyncCall : function(fcn, callbackIndex, args, scope){ + this.playlist.add(new YAHOO.ext.Actor.AsyncAction(scope, fcn, args || [], callbackIndex)); + }, + + /** + * Add a pause to the playlist (in seconds) + * @param {Number} seconds The number of seconds to pause. + */ + pause : function(seconds){ + this.playlist.add(new YAHOO.ext.Actor.PauseAction(seconds)); + } + + }; +/** + * Static function to build a AnimatorComposite from a css selector (requires YAHOO.ext.Element.selectorFunction be defined) + * @param {String/Array} selector The css selector or an array of nodes to animate + * @method @static + */ +YAHOO.ext.Animator.select = function(selector){ + var els; + if(typeof selector == 'string'){ + els = YAHOO.ext.Element.selectorFunction(selector); + }else if(selector instanceof Array){ + els = selector; + }else{ + throw 'Invalid selector'; + } + return new YAHOO.ext.AnimatorComposite(els); +}; +var getActors = YAHOO.ext.Animator.select; + +/** + * @class YAHOO.ext.AnimatorComposite + * Composite class with synchronized animations. This is the class returned by getActors(selector) or YAHOO.ext.Animator.select(). + */ +YAHOO.ext.AnimatorComposite = function(els){ + this.animator = new YAHOO.ext.Animator(); + this.addElements(els); + this.syncAnims = true; +}; +YAHOO.ext.AnimatorComposite.prototype = { + isComposite: true, + /** + * Adds elements to this composite. + * @param {Array} els An array of elements to add + * @return {AnimatorComposite} this + */ + addElements : function(els){ + if(!els) return this; + var anim = this.animator; + for(var i = 0, len = els.length; i < len; i++) { + anim.addActor(new YAHOO.ext.Actor(els[i])); + } + anim.startCapture(); + return this; + }, + /** + * Operations called after sequence() will be performed one by one on each element in this composite. + * @return {AnimatorComposite} this + */ + sequence : function(){ + this.syncAnims = false; + return this; + }, + /** + * Operations called after sync() will be performed at the same time on each element in this composite. + * @return {AnimatorComposite} this + */ + sync : function(){ + this.syncAnims = true; + return this; + }, + invoke : function(fn, args){ + var els = this.animator.actors; + if(this.syncAnims) this.animator.beginSync(); + for(var i = 0, len = els.length; i < len; i++) { + YAHOO.ext.Actor.prototype[fn].apply(els[i], args); + } + if(this.syncAnims) this.animator.endSync(); + return this; + }, + /** + * Play the actions queued in this composite. + * @param {Function} callback (optional) callback is called when all animations have compelted + * @return {AnimatorComposite} this + */ + play : function(callback){ + this.animator.play(callback); + return this; + }, + /** + * Clear all actions in the queue. + * @param {Function} callback (optional) callback is called when all animations have compelted + * @return {AnimatorComposite} this + */ + reset : function(callback){ + this.animator.startCapture(true); + return this; + }, + /** + * Add a pause + * @param {Number} seconds + * @return {AnimatorComposite} this + */ + pause : function(seconds){ + this.animator.pause(seconds); + return this; + }, + /** + * Get the YAHOO.ext.Animator that controls the animations for this composite. + * @return {YAHOO.ext.Animator} + */ + getAnimator : function(){ + return this.animator; + }, + /** + * Calls the passed function passing (el, this, index) for each element in this composite. + * @param {Function} fn The function to call + * @param {Object} scope (optional) The this object (defaults to the element) + * @return {AnimatorComposite} this + */ + each : function(fn, scope){ + var els = this.animator.actors; + if(this.syncAnims) this.animator.beginSync(); + for(var i = 0, len = els.length; i < len; i++){ + fn.call(scope || els[i], els[i], this, i); + } + if(this.syncAnims) this.animator.endSync(); + return this; + }, + /** + * Add a function call to the playlist. + * @param {Function} fcn The function to call + * @param {Array} args (optional) The arguments to call the function with + * @param {Object} scope (optional) The scope of the function + * @return {AnimatorComposite} this + */ + addCall : function(fcn, args, scope){ + this.animator.addCall(fcn, args, scope); + return this; + }, + /** + * Add an async function call to the playlist. + * @param {Function} fcn The function to call + * @param {Number} callbackIndex The index of the callback parameter on the passed function. A CALLBACK IS REQUIRED. + * @param {Array} args (optional) The arguments to call the function with + * @param {Object} scope (optional) The scope of the function + * @return {AnimatorComposite} this + */ + addAsyncCall : function(fcn, callbackIndex, args, scope){ + this.animator.addAsyncCall(fcn, callbackIndex, args, scope); + return this; + } +}; +for(var fnName in YAHOO.ext.Actor.prototype){ + if(typeof YAHOO.ext.Actor.prototype[fnName] == 'function'){ + YAHOO.ext.CompositeElement.createCall(YAHOO.ext.AnimatorComposite.prototype, fnName); + } +} + + +YAHOO.ext.Animator.AnimSequence = function(){ + this.actions = []; + this.nextDelegate = this.next.createDelegate(this); + this.playDelegate = this.play.createDelegate(this); + this.oncomplete = null; + this.playing = false; + this.stopping = false; + this.actionIndex = -1; + }; + + YAHOO.ext.Animator.AnimSequence.prototype = { + + add : function(action){ + this.actions.push(action); + }, + + next : function(){ + if(this.stopping){ + this.playing = false; + if(this.oncomplete){ + this.oncomplete(this, false); + } + return; + } + var nextAction = this.actions[++this.actionIndex]; + if(nextAction){ + nextAction.play(this.nextDelegate); + }else{ + this.playing = false; + if(this.oncomplete){ + this.oncomplete(this, true); + } + } + }, + + play : function(oncomplete){ + if(this.playing) return; // can't play the same sequence twice at once + this.oncomplete = oncomplete; + this.stopping = false; + this.playing = true; + this.actionIndex = -1; + this.next(); + }, + + stop : function(){ + this.stopping = true; + }, + + isPlaying : function(){ + return this.playing; + }, + + clear : function(){ + this.actions = []; + }, + + addCall : function(fcn, args, scope){ + this.actions.push(new YAHOO.ext.Actor.Action(scope, fcn, args || [])); + }, + + addAsyncCall : function(fcn, callbackIndex, args, scope){ + this.actions.push(new YAHOO.ext.Actor.AsyncAction(scope, fcn, args || [], callbackIndex)); + }, + + pause : function(seconds){ + this.actions.push(new YAHOO.ext.Actor.PauseAction(seconds)); + } + + }; + +YAHOO.ext.Animator.CompositeSequence = function(){ + this.sequences = []; + this.completed = 0; + this.trackDelegate = this.trackCompletion.createDelegate(this); +} + +YAHOO.ext.Animator.CompositeSequence.prototype = { + add : function(sequence){ + this.sequences.push(sequence); + }, + + play : function(onComplete){ + this.completed = 0; + if(this.sequences.length < 1){ + if(onComplete)onComplete(); + return; + } + this.onComplete = onComplete; + for(var i = 0; i < this.sequences.length; i++){ + this.sequences[i].play(this.trackDelegate); + } + }, + + trackCompletion : function(){ + ++this.completed; + if(this.completed >= this.sequences.length && this.onComplete){ + this.onComplete(); + } + }, + + stop : function(){ + for(var i = 0; i < this.sequences.length; i++){ + this.sequences[i].stop(); + } + }, + + isPlaying : function(){ + for(var i = 0; i < this.sequences.length; i++){ + if(this.sequences[i].isPlaying()){ + return true; + } + } + return false; + } +}; + + -- cgit v0.9.0.2