在本教程中我们将会探索Dojo1.7工具包提供的JavaScript特效，这些特效将给你的页面和网站创造酷炫的效果！ 本文由Oliver翻译自： Dojo Effects 本文是对dojo1.6同名教程的更新，并使用了1.7版
本文由Oliver翻译自： Dojo Effects 本文是对dojo1.6同名教程的更新，并使用了1.7版中最新的写法。 在翻译过程中参考了1.6版的译文：dojo 1.6 官方教程： 手把手教你创建HTML5 JavaScript 动画特效
引言
在前面的一系列教程中，我们已经学习了如何使用并操作DOM节点，处理DOM事件。但是当我们在对DOM节点进行操作时，有些转换会显得突兀：例如删除一个节点，在用户看来它就会在页面上突然消失，有时这种突然变化可能会误导用户。使用Dojo提供的标准特效工具，我们可以构建出更加连贯的用户体验，并且让我们的应用程序显得更加精致和完美。如果进一步使用dojo/_base/fx和dojo/fx包里的更多功能，我们就能够把一系列特效串联起来，创造出非常酷的动态用户体验。 注：Dojo1.7包含了两个fx模块：dojo/_base/fx 和 dojo/fx- dojo/_base/fx 提供了一些最基本的特效方法，包括：animateProperty, anim, fadeIn,和fadeOut。
- dojo/fx 提供了更多高级特效，包括：chain, combine, wipeIn, wipeOut和slideTo
淡入淡出特效 Fading
最常见的一种特效就是DOM节点的淡入与淡出。这个效果在网页上会经常用到，因此dojo把它包含在Dojo的基础包中。我们可以使用这个效果让节点在页面的出现和消失显得连续和平滑。 下面是使用dojo创建淡入淡出效果的示例代码：<button id="fadeOutButton">Fade block out</button>
<button id="fadeInButton">Fade block in</button>
<div id="fadeTarget" class="red-block">
A red block
</div>
<script>
require(["dojo/_base/fx", "dojo/on", "dojo/dom", "dojo/domReady!"], function(fx, on, dom) {
var fadeOutButton = dom.byId("fadeOutButton"),
fadeInButton = dom.byId("fadeInButton"),
fadeTarget = dom.byId("fadeTarget");
on(fadeOutButton, "click", function(evt){
fx.fadeOut({ node: fadeTarget }).play();
});
on(fadeInButton, "click", function(evt){
fx.fadeIn({ node: fadeTarget }).play();
});
});
</script>
Dojo里所有的动画特效函数都只接受一个参数对象，该参数对象包含了一系列属性来设定所需动画效果。其中 最重要的属性之一就是 node。 node属性值是一个DOM节点或者是一个DOM 节点的ID （字符串）。 另一个参数 duration，则指定了这个效果的播放要持续的时间，单位是毫秒。如果不指定duration，则默认的播放时间是350毫秒。当然不同的动画效果有不同的参数，不过对于淡入淡出特效而言，这两个参数就足够了。
Dojo的动画特效函数返回值是一个dojo.Animation 对象。这个对象有几个方法: play, pause, stop, status 和gotoPercent 从名字可以看出这几个方法是用来控制动画效果的播放的。 动画对象刚创建时并不会立即播放，需要调用play方法才开始播放。
查看示例
擦除特效 Wiping
另一种常见特效是擦除效果: 它实际上是指改变一个节点的高度，而让其内容逐渐显示或者消失。效果有点类似与雨刷在挡风玻璃上划过留下的痕迹。擦除特效可以用于创建页面的下拉效果，尤其是当页面上有一些不常用的内容时。当然你也可能仅仅是觉得擦除比淡出好看。
请看下面的示例代码：
<button id="wipeOutButton">Wipe block out</button>
<button id="wipeInButton">Wipe block in</button>
<div id="wipeTarget" class="red-block wipe">
A red block
</div>
<script>
require(["dojo/fx", "dojo/on", "dojo/dom", "dojo/domReady!"], function(fx, on, dom) {
var wipeOutButton = dom.byId("wipeOutButton"),
wipeInButton = dom.byId("wipeInButton"),
wipeTarget = dom.byId("wipeTarget");
on(wipeOutButton, "click", function(evt){
fx.wipeOut({ node: wipeTarget }).play();
});
on(wipeInButton, "click", function(evt){
fx.wipeIn({ node: wipeTarget }).play();
});
});
</script>
和fadeIn/fadeOut不同，使用擦除函数需要引用的是dojo/fx包。另一个需要注意的是我们在这个例子里给目标节点“wipeTarget" 增加了一个css类wipe, 这个类设定了节点的height:auto， 这是因为wipeIn函数的效果是从节点的现有高度变化到其自然高度(即height:auto)。
查看示例
滑动特效 Sliding
前面我们看到了淡入淡出和擦除效果，这两个特效都不能改变节点在页面上的位置。如果想要节点滑动起来，那么就要使用fx.slideTo 。滑动效果可以创造一种动态感，有时也用来表示某种加载进度。dojo.fx.slideTo函数可以在参数指定节点的目标位置（页面上的left和top位置，以像素px为单位） 并把这个节点滑动到目标位置。<button id="slideAwayButton">Slide block away</button>
<button id="slideBackButton">Slide block back</button>
<div id="slideTarget" class="red-block slide">
A red block
</div>
<script>
require(["dojo/fx", "dojo/on", "dojo/dom", "dojo/domReady!"], function(fx, on, dom) {
var slideAwayButton = dom.byId("slideAwayButton"),
slideBackButton = dom.byId("slideBackButton"),
slideTarget = dom.byId("slideTarget");
on(slideAwayButton, "click", function(evt){
fx.slideTo({ node: slideTarget, left: "200", top: "200" }).play();
});
on(slideBackButton, "click", function(evt){
fx.slideTo({ node: slideTarget, left: "0", top: "100" }).play();
});
});
</script>
查看示例
动画事件 Animation Events
前面我们提到过，Dojo里的所有的动画特效函数都会返回一个dojo.Animation对象。这个对象不仅提供了方法控制动画的播放暂停，同时还提供了一系列的事件供我们监听，从而使我们可以在动画播放前，播放中，播放后做出不同的响应动作。最重要也是最常用的两个事件是：beforeBegin 和 onEnd。下面我们看一段使用动画事件的示例代码：
<button id="slideAwayButton">Slide block away</button>
<button id="slideBackButton">Slide block back</button>
<div id="slideTarget" class="red-block slide">
A red block
</div>
<script>
require(["dojo/fx", "dojo/on", "dojo/dom-style", "dojo/dom", "dojo/domReady!"], function(fx, on, style, dom) {
var slideAwayButton = dom.byId("slideAwayButton"),
slideBackButton = dom.byId("slideBackButton"),
slideTarget = dom.byId("slideTarget");
on(slideAwayButton, "click", function(evt){
// 注意beforeBegin是作为Animation对象的参数直接传给slideTo函数的，
// 而不是使用connect连接。这保证了我们的逻辑在其他beforeBegin逻辑之前执行。
var anim = fx.slideTo({
node: slideTarget,
left: "200",
top: "200",
beforeBegin: function(){
console.warn("slide target is: ", slideTarget);
style.set(slideTarget, {
left: "0px",
top: "100px"
});
}
});
// 当然我们也可以像beforeBegin一样把这个处理逻辑以onEnd的名字传给slideTo函数，
// 但既然一个简单的connect连接就能解决问题，所以……
//（译者注：这种做法更符合事件的特点，即当事件触发之后才执行用户逻辑）
on(anim, "End", function(){
style.set(slideTarget, {
backgroundColor: "blue"
});
}, true);
// 千万别忘了启动这个动画特效！
anim.play();
});
on(slideBackButton, "click", function(evt){
var anim = fx.slideTo({
node: slideTarget,
left: "0",
top: "100",
beforeBegin: function(){
style.set(slideTarget, {
left: "200px",
top: "200px"
});
}
});
on(anim, "End", function(){
style.set(slideTarget, {
backgroundColor: "red"
});
}, true);
anim.play();
});
});
</script>
这段示例代码里我们注意到添加beforeBegin 和onEnd （译者注：在使用1.7的新函数on时需要省略事件名前缀的"on"，这和addEventListener的用法保持了一致）这两个事件的回调方法的方式不太一样。beforeBegin 的处理方法直接作为参数传递给了slideTo函数。这是因为对某些动画特效beforeBegin处理函数是在对象创建时连接的，如果我们通过on来连接我们的beforeBegin处理函数，则我们的处理函数会在该动画自己的beforeBegin处理函数之后被调用。因此作为参数传入的方法保证了我们的处理函数可以被最先执行。
查看示例
串联动画 Chaining
如果我们想要连续播放多个动画效果该怎么做呢？我们可以利用刚才提到的End事件，在一个特效结束时来启动另一个新效果，但是这样显然不太方便。好在dojo/fx模块为这一类常见的需求提供了一组非常方便的函数，使多个特效能连续播放或者同时播放。这些方法中的每一个都返回一个新的dojo.Animation对象，其中包含一组能描述整个动画序列的事件和方法。我们先来看一下fx.chain是如何让动画特效一个接一个（串联）播放的：<button id="slideAwayButton">Slide block away</button>
<button id="slideBackButton">Slide block back</button>
<div id="slideTarget" class="red-block slide chain">
A red block
</div>
<script>
require(["dojo/_base/fx", "dojo/fx", "dojo/on", "dojo/dom", "dojo/domReady!"], function(baseFx, fx, on, dom) {
var slideAwayButton = dom.byId("slideAwayButton"),
slideBackButton = dom.byId("slideBackButton"),
slideTarget = dom.byId("slideTarget");
// 设置一些click事件处理函数来播放我们的串联动画
on(slideAwayButton, "click", function(evt){
fx.chain([
baseFx.fadeIn({ node: slideTarget }),
fx.slideTo({ node: slideTarget, left: "200", top: "200" }),
baseFx.fadeOut({ node: slideTarget })
]).play();
});
on(slideBackButton, "click", function(evt){
fx.chain([
baseFx.fadeIn({ node: slideTarget }),
fx.slideTo({ node: slideTarget, left: "0", top: "100" }),
baseFx.fadeOut({ node: slideTarget })
]).play();
});
});
</script>
如您所见，我们在调用fx.chain的时候直接传入了一个特效数组，并对该方法所返回的dojo.Animation对象调用了play方法来启动整个特效链。现在我们不需要逐个启动特效了，fx.chain已经为我们解决了问题。
查看示例
组合动画 Combining
dojo/fx提供的另一个方便的方法combine能够同时启动多个动画特效。其返回的dojo.Animation对象将在耗时最长的动画特效结束后触发onEnd事件。让我们来看另一个例子：<button id="slideAwayButton">Slide block away</button>
<button id="slideBackButton">Slide block back</button>
<div id="slideTarget" class="red-block slide chain">
A red block
</div>
<script>
require(["dojo/_base/fx", "dojo/fx", "dojo/on", "dojo/dom", "dojo/domReady!"], function(baseFx, fx, on, dom) {
var slideAwayButton = dom.byId("slideAwayButton"),
slideBackButton = dom.byId("slideBackButton"),
slideTarget = dom.byId("slideTarget");
// 设置一些click事件处理函数来播放我们的组合动画
on(slideAwayButton, "click", function(evt){
fx.combine([
baseFx.fadeIn({ node: slideTarget }),
fx.slideTo({ node: slideTarget, left: "200", top: "200" })
]).play();
});
on(slideBackButton, "click", function(evt){
fx.combine([
fx.slideTo({ node: slideTarget, left: "0", top: "100" }),
baseFx.fadeOut({ node: slideTarget })
]).play();
});
});
</script>
在这个例子中，淡入和滑动特效并不是依次播放，而是同时发生的。
通过使用chain和combine，我们可以用几种简单效果组合出很不错的动画特效。同时chain和combine的返回值仍然是一个animation对象，也就是说它们还可以被进一步地串联、组合，从而可以创造出非常精巧复杂的效果。
查看示例
结语
使用Dojo的特效方法，你可以快速的给页面加上有趣的动画效果。dojo/_base/fx模块中包含了淡入淡出方法fadeIn和fadeOut，而通过dojo/fx模块你还可以使用擦除和滑动等许多功能强大的特效。另外，有了chain和combine 这两个方法，就能方便快捷地构建出更复杂、更高级的动画效果。当然如果你还想更进一步的控制动画的效果，例如，像wipeOut一样调整某个DOM节点的高度，但是又不把它完全缩减到0（完全擦除），或者通过动画来调整背景色的渐变？ Dojo提供了一个更加通用和强大的dojo.animateProperty对象来实现。 我们会在未来的教程中详细介绍。