regularjs的动画系统完全指南

发布于 2015-09-06 14:48:38 | 252 次阅读 | 评论: 0 | 来源: 网络整理

regularjs 提供了纯声明式的动画支持，看完本章指南你会发现regularjs的动画系统的灵活和强大，它甚至可以完美的控制动画队列。

你可以通过r-animation指令来实现动画.

Syntax


<div r-animation="Sequence"></div>

Sequence:
  Command (";"" Command)*

Command:
  CommandName ":"" Param;

CommandName: [-w]+

Param: [^;]+

Exmaple


<div r=animation="on: click; class: animated fadeIn; wait: 1000; class: animated fadeOut; style: display none; "></div>

上例的意思是:

当 click 触发时
为元素添加类名 animated fadeIn, 当 transitionend (or animationend)或, r移除它们.
等待 1000ms.
与第二部类似
添加样式 display:none to element,( if trigger transition, this command will waitting for transitionend)
动画结束 done.

内建Command

1. on: event

当特定的event 触发时, 开始动画.

注意: regularjs会先去检查event是否是个DOM事件，如果不是，则会转而监听组件事件

2. when: Expression

当表达式为真触发动画

on 和 when 是目前仅有的触发动画序列的Command

3. class: classes, mode

参数

classes: 空格分割的className
mode (Number): 添加class的模式

Command: class的形为取决于 mode参数,一共有三种mode.
- 1: 默认mode, 首先加指定类名到节点，当动画结束移除它
- 2: 首先添加class到节点，然后在nextTick添加class-active到节点用以触发动画，当动画结束移除所有类名, 这个模式与angular类似.
- 3: 与mode1类似, 但是动画结束后，我们不移除类名

example

<div id="box1" r-animation="on:click;class: animated fadeIn, 1">box1</div>
<div id="box2" r-animation="on:click;class: animated fadeIn, 2">box2</div>
<div id="box3" r-animation="on:click;class: animated fadeIn, 3">box3</div>

每当点击box1, box2 或box3. 它们分别会产生不同的效果

box1:

add animated fadeIn
when animationend remove them

box2:

add animated fadeIn
add animated-active fadeIn-active at next-tick(to trigger the animation)
when animationend then remove all of animated fadeIn animated-active fadeIn-active

box3:

add animated fadeIn
when animationend , do nothing

4. emit: event

抛出某个事件，注意这可能会触发一个组件内部. 由on开头的动画序列


<div class='box animated' r-animation=
     "on: click; 
        class: swing ;
        emit: swing-over ;
        class: shake;
        emit: shake-over"
        >
  box1: trigger by click
</div>

<div class='box animated' r-animation=
     "on: swing-over; 
        class:  swing; 
      on:  shake-over; 
        class: shake;
      ">box2: after box1 swing</div>

box1 通过抛出swing-over等事件触发了box2得动画.

DEMO on codepen

5. call: expression

运行一个表达式并进入digest phase, 注意这里由于可能会when条件，所以可以用来控制动画序列.


<div class='box animated' r-animation=
     "when:test; 
        class: swing ;
        call: otherSwing=true ;
        class: shake">
  box1: trigger by checkbox
</div>

<div class='box animated' r-animation=
     "when: otherSwing; 
        class:  swing; 
      ">box2: after box1 swing</div>

流程如下:

when test is computed to true, start box1's animation
swing then call otherSwing = true;
box2's otherSwing is evaluted to true.
box2 shakes, meanwhile box1 shakes;
done.

Result on Codepen

6. style: propertyName1 value1, propertyName1 value1 ...

设置样式并且等待 transitionend(如果可以触发的话)

example

<div class='box animated' r-animation=
     "on: click; 
        class:  swing; 
        style: color #333;
        class: bounceOut;
        style: display none;
      ">style: click me </div>

你需要添加transition样式来触发style的动画

.box.animated{
   transition:  color 1s linear;
}

这个例子的意思是:

once clicking, swing it.
then set style.color=#333(trigger transition)...
动画结束

7. wait: duration

等待数秒再进入下一个步骤

param

duration: an integer indicating the number of milliseconds to delay execution of the next animation in the queue.

<div class='box animated' r-animation=
     "on:click; 
        class: swing ;
        wait: 2000 ;
        class: shake">
  wait: click me
</div>

Result on Codepen

扩展 Animation

你可以通过Component.animation(name, handle)扩展你的动画Command(内部Command也是通过此接口扩展)

参数

name (String): 命令名
handle(step): 序列命令定义, 你需要在handle中返回一个函数
- step: step携带着你用来定义动画的信息

例如，我们要实现一个渐入渐出的效果

Regular.animation("fade", function(step){
  var param = step.param, // 传入fade的参数
    element = step.element, //触发节点
    fadein = param === "in",
    step = fadein?  1.05: 0.9;

  // 这个函数会在每次本步骤被触发时被调用，
  // 它只接受一个done函数作为参数，标志着本步骤的结束
  return function(done){ 
    var start = fadein?  0.01: 1;
    var tid = setInterval(function(){
      start *= step 
      if(fadein && 1- start < 1e-3){
        start = 1; 
        clearInterval(tid);
        done()
      }else if(!fadein && start < 1e-3){
        start = 0;
        clearInterval(tid);
        done()
      }
      element.style.opacity = start;
    }, 1000 / 60) 
  }
})

使用

<div class='box animated' r-animation=
       "on:click; 
        class: swing ;
        fade: out ;
        fade: in;
         ">
    fade: click me
</div>

所有你需要做的是，当动画结束时，调用这个done函数.

Result on Codepen

你也可以查看所以本文内建命令的实现github. 真的很简单.

小节

可能相对于其他声明式的框架， regularjs的动画声明的写法上会繁琐一些，但是带来了无限的可能性，结合数据监听体系和事件系统，事实上你可以在regularjs中实现任意复杂度，跨越任意节点的动画序列!

【DEMO: 实现一个无限循环的animation】

不过由于声明式动画的天然限制，永远不要奢求其对动画的控制力可以达到手动js编码的自由度(比如使用velocity.js).

你可以通过在组件init后，手动通过$refs获取节点并结合velocity.js等更专业的动画框架来实现你需要的动画效果.

注意动画使用不当是可能与组件本身的数据-UI状态产生冲突, 所以一般来讲，应该尽量使用on/emit的组合，而少使用when/call的组合来实现动画序列

regularjs的动画系统完全指南