在本教程中我们将会探索Dojo1.7工具包提供的JavaScript特效,这些特效将给你的页面和网站创造酷炫的效果!
本文由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对象来实现。 我们会在未来的教程中详细介绍。
当然如果你还想更进一步的控制动画的效果,例如,像wipeOut一样调整某个DOM节点的高度,但是又不把它完全缩减到0(完全擦除),或者通过动画来调整背景色的渐变? Dojo提供了一个更加通用和强大的dojo.animateProperty对象来实现。 我们会在未来的教程中详细介绍。