First version of the newly restructured repository
This commit is contained in:
Giulio Cesare Solaroli
482
frontend/beta/js/YUI-extensions/anim/Animator.js
Normal file
482
frontend/beta/js/YUI-extensions/anim/Animator.js
Normal file
@@ -0,0 +1,482 @@
|
||||
/**
|
||||
* @class YAHOO.ext.Animator
|
||||
* Provides support for syncing animations for multiple {@link YAHOO.ext.Actor}s.<br><br>
|
||||
* <br><br>This example can be seen in action <a href="http://www.jackslocum.com/yui/2006/08/19/a-splitbar-component-for-yahoo-ui/" target="_new">here</a>
|
||||
* by clicking on "Click here and I will point it out" at the end of the first paragraph.<br>
|
||||
* <pre><code>
|
||||
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);
|
||||
* </code></pre>
|
||||
* @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 {<i>YAHOO.ext.Animator</i>} animator (optional) The Animator that will capture this Actor's actions
|
||||
* @param {<i>Boolean</i>} 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 {<i>Boolean</i>} 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 {<i>Function</i>} 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 {<i>Array</i>} args The arguments to call the function with
|
||||
* @param {<i>Object</i>} 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 {<i>Array</i>} args The arguments to call the function with
|
||||
* @param {<i>Object</i>} 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 <i>this</i> 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 {<i>Array</i>} args (optional) The arguments to call the function with
|
||||
* @param {<i>Object</i>} 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. <b>A CALLBACK IS REQUIRED</b>.
|
||||
* @param {<i>Array</i>} args (optional) The arguments to call the function with
|
||||
* @param {<i>Object</i>} 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;
|
||||
}
|
||||
};
|
||||
|
||||
|
||||
Reference in New Issue
Block a user