223 lines
7.4 KiB
JavaScript
223 lines
7.4 KiB
JavaScript
define("dojo/NodeList-fx", ["dojo/_base/NodeList", "./_base/lang", "./_base/connect", "./_base/fx", "./fx"],
|
|
function(NodeList, lang, connectLib, baseFx, coreFx) {
|
|
// module:
|
|
// dojo/NodeList-fx
|
|
// summary:
|
|
// TODOC
|
|
|
|
/*=====
|
|
dojo["NodeList-fx"] = {
|
|
// summary: Adds dojo.fx animation support to dojo.query() by extending the NodeList class
|
|
// with additional FX functions. NodeList is the array-like object used to hold query results.
|
|
};
|
|
|
|
// doc alias helpers:
|
|
NodeList = dojo.NodeList;
|
|
=====*/
|
|
|
|
lang.extend(NodeList, {
|
|
_anim: function(obj, method, args){
|
|
args = args||{};
|
|
var a = coreFx.combine(
|
|
this.map(function(item){
|
|
var tmpArgs = { node: item };
|
|
lang.mixin(tmpArgs, args);
|
|
return obj[method](tmpArgs);
|
|
})
|
|
);
|
|
return args.auto ? a.play() && this : a; // dojo.Animation|dojo.NodeList
|
|
},
|
|
|
|
wipeIn: function(args){
|
|
// summary:
|
|
// wipe in all elements of this NodeList via `dojo.fx.wipeIn`
|
|
//
|
|
// args: Object?
|
|
// Additional dojo.Animation arguments to mix into this set with the addition of
|
|
// an `auto` parameter.
|
|
//
|
|
// returns: dojo.Animation|dojo.NodeList
|
|
// A special args member `auto` can be passed to automatically play the animation.
|
|
// If args.auto is present, the original dojo.NodeList will be returned for further
|
|
// chaining. Otherwise the dojo.Animation instance is returned and must be .play()'ed
|
|
//
|
|
// example:
|
|
// Fade in all tables with class "blah":
|
|
// | dojo.query("table.blah").wipeIn().play();
|
|
//
|
|
// example:
|
|
// Utilizing `auto` to get the NodeList back:
|
|
// | dojo.query(".titles").wipeIn({ auto:true }).onclick(someFunction);
|
|
//
|
|
return this._anim(coreFx, "wipeIn", args); // dojo.Animation|dojo.NodeList
|
|
},
|
|
|
|
wipeOut: function(args){
|
|
// summary:
|
|
// wipe out all elements of this NodeList via `dojo.fx.wipeOut`
|
|
//
|
|
// args: Object?
|
|
// Additional dojo.Animation arguments to mix into this set with the addition of
|
|
// an `auto` parameter.
|
|
//
|
|
// returns: dojo.Animation|dojo.NodeList
|
|
// A special args member `auto` can be passed to automatically play the animation.
|
|
// If args.auto is present, the original dojo.NodeList will be returned for further
|
|
// chaining. Otherwise the dojo.Animation instance is returned and must be .play()'ed
|
|
//
|
|
// example:
|
|
// Wipe out all tables with class "blah":
|
|
// | dojo.query("table.blah").wipeOut().play();
|
|
return this._anim(coreFx, "wipeOut", args); // dojo.Animation|dojo.NodeList
|
|
},
|
|
|
|
slideTo: function(args){
|
|
// summary:
|
|
// slide all elements of the node list to the specified place via `dojo.fx.slideTo`
|
|
//
|
|
// args: Object?
|
|
// Additional dojo.Animation arguments to mix into this set with the addition of
|
|
// an `auto` parameter.
|
|
//
|
|
// returns: dojo.Animation|dojo.NodeList
|
|
// A special args member `auto` can be passed to automatically play the animation.
|
|
// If args.auto is present, the original dojo.NodeList will be returned for further
|
|
// chaining. Otherwise the dojo.Animation instance is returned and must be .play()'ed
|
|
//
|
|
// example:
|
|
// | Move all tables with class "blah" to 300/300:
|
|
// | dojo.query("table.blah").slideTo({
|
|
// | left: 40,
|
|
// | top: 50
|
|
// | }).play();
|
|
return this._anim(coreFx, "slideTo", args); // dojo.Animation|dojo.NodeList
|
|
},
|
|
|
|
|
|
fadeIn: function(args){
|
|
// summary:
|
|
// fade in all elements of this NodeList via `dojo.fadeIn`
|
|
//
|
|
// args: Object?
|
|
// Additional dojo.Animation arguments to mix into this set with the addition of
|
|
// an `auto` parameter.
|
|
//
|
|
// returns: dojo.Animation|dojo.NodeList
|
|
// A special args member `auto` can be passed to automatically play the animation.
|
|
// If args.auto is present, the original dojo.NodeList will be returned for further
|
|
// chaining. Otherwise the dojo.Animation instance is returned and must be .play()'ed
|
|
//
|
|
// example:
|
|
// Fade in all tables with class "blah":
|
|
// | dojo.query("table.blah").fadeIn().play();
|
|
return this._anim(baseFx, "fadeIn", args); // dojo.Animation|dojo.NodeList
|
|
},
|
|
|
|
fadeOut: function(args){
|
|
// summary:
|
|
// fade out all elements of this NodeList via `dojo.fadeOut`
|
|
//
|
|
// args: Object?
|
|
// Additional dojo.Animation arguments to mix into this set with the addition of
|
|
// an `auto` parameter.
|
|
//
|
|
// returns: dojo.Animation|dojo.NodeList
|
|
// A special args member `auto` can be passed to automatically play the animation.
|
|
// If args.auto is present, the original dojo.NodeList will be returned for further
|
|
// chaining. Otherwise the dojo.Animation instance is returned and must be .play()'ed
|
|
//
|
|
// example:
|
|
// Fade out all elements with class "zork":
|
|
// | dojo.query(".zork").fadeOut().play();
|
|
// example:
|
|
// Fade them on a delay and do something at the end:
|
|
// | var fo = dojo.query(".zork").fadeOut();
|
|
// | dojo.connect(fo, "onEnd", function(){ /*...*/ });
|
|
// | fo.play();
|
|
// example:
|
|
// Using `auto`:
|
|
// | dojo.query("li").fadeOut({ auto:true }).filter(filterFn).forEach(doit);
|
|
//
|
|
return this._anim(baseFx, "fadeOut", args); // dojo.Animation|dojo.NodeList
|
|
},
|
|
|
|
animateProperty: function(args){
|
|
// summary:
|
|
// Animate all elements of this NodeList across the properties specified.
|
|
// syntax identical to `dojo.animateProperty`
|
|
//
|
|
// args: Object?
|
|
// Additional dojo.Animation arguments to mix into this set with the addition of
|
|
// an `auto` parameter.
|
|
//
|
|
// returns: dojo.Animation|dojo.NodeList
|
|
// A special args member `auto` can be passed to automatically play the animation.
|
|
// If args.auto is present, the original dojo.NodeList will be returned for further
|
|
// chaining. Otherwise the dojo.Animation instance is returned and must be .play()'ed
|
|
//
|
|
// example:
|
|
// | dojo.query(".zork").animateProperty({
|
|
// | duration: 500,
|
|
// | properties: {
|
|
// | color: { start: "black", end: "white" },
|
|
// | left: { end: 300 }
|
|
// | }
|
|
// | }).play();
|
|
//
|
|
// example:
|
|
// | dojo.query(".grue").animateProperty({
|
|
// | auto:true,
|
|
// | properties: {
|
|
// | height:240
|
|
// | }
|
|
// | }).onclick(handler);
|
|
return this._anim(baseFx, "animateProperty", args); // dojo.Animation|dojo.NodeList
|
|
},
|
|
|
|
anim: function( /*Object*/ properties,
|
|
/*Integer?*/ duration,
|
|
/*Function?*/ easing,
|
|
/*Function?*/ onEnd,
|
|
/*Integer?*/ delay){
|
|
// summary:
|
|
// Animate one or more CSS properties for all nodes in this list.
|
|
// The returned animation object will already be playing when it
|
|
// is returned. See the docs for `dojo.anim` for full details.
|
|
// properties: Object
|
|
// the properties to animate. does NOT support the `auto` parameter like other
|
|
// NodeList-fx methods.
|
|
// duration: Integer?
|
|
// Optional. The time to run the animations for
|
|
// easing: Function?
|
|
// Optional. The easing function to use.
|
|
// onEnd: Function?
|
|
// A function to be called when the animation ends
|
|
// delay:
|
|
// how long to delay playing the returned animation
|
|
// example:
|
|
// Another way to fade out:
|
|
// | dojo.query(".thinger").anim({ opacity: 0 });
|
|
// example:
|
|
// animate all elements with the "thigner" class to a width of 500
|
|
// pixels over half a second
|
|
// | dojo.query(".thinger").anim({ width: 500 }, 700);
|
|
var canim = coreFx.combine(
|
|
this.map(function(item){
|
|
return baseFx.animateProperty({
|
|
node: item,
|
|
properties: properties,
|
|
duration: duration||350,
|
|
easing: easing
|
|
});
|
|
})
|
|
);
|
|
if(onEnd){
|
|
connectLib.connect(canim, "onEnd", onEnd);
|
|
}
|
|
return canim.play(delay||0); // dojo.Animation
|
|
}
|
|
});
|
|
|
|
return NodeList;
|
|
});
|