Vue动画事件详解及过渡动画实例
为了应用过渡效果,需要在目标元素上使用transition特性:
transition特性可以与下面资源一起用:
v-if
v-show
v-for(只在插入和删除时触发,使用vue-animated-list插件)
动态组件
在组件的根节点上,并且被Vue实例DOM方法(如vm.$appendTo(el))触发。
当插入或删除带有过渡的元素时,Vue将:
尝试以ID"my-transition"查找JavaScript过渡钩子对象——通过Vue.transition(id,hooks)或transitions选项注册。如果找到了,将在过渡的不同阶段调用相应的钩子。
自动嗅探目标元素是否有CSS过渡或动画,并在合适时添加/删除CSS类名。
如果没有找到JavaScript钩子并且也没有检测到CSS过渡/动画,DOM操作(插入/删除)在下一帧中立即执行。
CSS过渡
示例
典型的CSS过渡像这样:
hello
然后为.expand-transition,.expand-enter和.expand-leave添加CSS规则:
/*必需*/
.expand-transition{
transition:all.3sease;
height:30px;
padding:10px;
background-color:#eee;
overflow:hidden;
}
/*.expand-enter定义进入的开始状态*/
/*.expand-leave定义离开的结束状态*/
.expand-enter,.expand-leave{
height:0;
padding:010px;
opacity:0;
}
你可以在同一元素上通过动态绑定实现不同的过渡:
hello
newVue({
el:'...',
data:{
show:false,
transitionName:'fade'
}
})
另外,可以提供JavaScript钩子:
Vue.transition('expand',{
beforeEnter:function(el){
el.textContent='beforeEnter'
},
enter:function(el){
el.textContent='enter'
},
afterEnter:function(el){
el.textContent='afterEnter'
},
enterCancelled:function(el){
//handlecancellation
},
beforeLeave:function(el){
el.textContent='beforeLeave'
},
leave:function(el){
el.textContent='leave'
},
afterLeave:function(el){
el.textContent='afterLeave'
},
leaveCancelled:function(el){
//handlecancellation
}
})
过渡的CSS类名
类名的添加和切换取决于transition特性的值。比如transition="fade",会有三个CSS类名:
.fade-transition始终保留在元素上。
.fade-enter定义进入过渡的开始状态。只应用一帧然后立即删除。
.fade-leave定义离开过渡的结束状态。在离开过渡开始时生效,在它结束后删除。
如果transition特性没有值,类名默认是.v-transition,.v-enter和.v-leave。
自定义过渡类名
我们可以在过渡的JavaScript定义中声明自定义的CSS过渡类名。这些自定义类名会覆盖默认的类名。当需要和第三方的CSS动画库,比如Animate.css配合时会非常有用:
Watchmebounce
Vue.transition('bounce',{
enterClass:'bounceInLeft',
leaveClass:'bounceOutRight'
})
显式声明CSS过渡类型
Vue.js需要给过渡元素添加事件侦听器来侦听过渡何时结束。基于所使用的CSS,该事件要么是transitionend,要么是animationend。
如果你只使用了两者中的一种,那么Vue.js将能够根据生效的CSS规则自动推测出对应的事件类型。但是,有些情况下一个元素可能需要同时带有两种类型的动画。比如你可能希望让Vue来触发一个CSSanimation,同时该元素在鼠标悬浮时又有CSStransition效果。这样的情况下,你需要显式地声明你希望Vue处理的动画类型(animation或是transition):
Vue.transition('bounce',{
//该过渡效果将只侦听`animationend`事件
type:'animation'
})
过渡流程详解
当show属性改变时,Vue.js将相应地插入或删除
元素,按照如下规则改变过渡的CSS类名:
如果show变为false,Vue.js将:
调用beforeLeave钩子;
添加v-leave类名到元素上以触发过渡;
调用leave钩子;
等待过渡结束(监听transitionend事件);
从DOM中删除元素并删除v-leave类名;
调用afterLeave钩子。
如果show变为true,Vue.js将:
调用beforeEnter钩子;
添加v-enter类名到元素上;
把它插入DOM;
调用enter钩子;
强制一次CSS布局,让v-enter确实生效。然后删除v-enter类名,以触发过渡,回到元素的原始状态;
等待过渡结束;
调用afterEnter钩子。
另外,如果在它的进入过渡还在进行中时删除元素,将调用enterCancelled钩子,以清理变动或enter创建的计时器。反过来对于离开过渡亦如是。
上面所有的钩子函数在调用时,它们的this均指向其所属的Vue实例。编译规则:过渡在哪个上下文中编译,它的this就指向哪个上下文。
最后,enter和leave可以有第二个可选的回调参数,用于显式控制过渡如何结束。因此不必等待CSStransitionend事件,Vue.js将等待你手工调用这个回调,以结束过渡。例如:
enter:function(el){
//没有第二个参数
//由CSStransitionend事件决定过渡何时结束
}
vs.
enter:function(el,done){
//有第二个参数
//过渡只有在调用`done`时结束
}
当多个元素一起过渡时,Vue.js会批量处理,只强制一次布局。
CSS动画
CSS动画用法同CSS过渡,区别是在动画中v-enter类名在节点插入DOM后不会立即删除,而是在animationend事件触发时删除。
示例:(省略了兼容性前缀)
Lookatme!
.bounce-transition{
display:inline-block;/*否则scale动画不起作用*/
}
.bounce-enter{
animation:bounce-in.5s;
}
.bounce-leave{
animation:bounce-out.5s;
}
@keyframesbounce-in{
0%{
transform:scale(0);
}
50%{
transform:scale(1.5);
}
100%{
transform:scale(1);
}
}
@keyframesbounce-out{
0%{
transform:scale(1);
}
50%{
transform:scale(1.5);
}
100%{
transform:scale(0);
}
}
JavaScript过渡
也可以只使用JavaScript钩子,不用定义任何CSS规则。当只使用JavaScript过渡时,enter和leave钩子需要调用done回调,否则它们将被同步调用,过渡将立即结束。
为JavaScript过渡显式声明css:false是个好主意,Vue.js将跳过CSS检测。这样也会阻止无意间让CSS规则干扰过渡。
在下例中我们使用jQuery注册一个自定义的JavaScript过渡:
Vue.transition('fade',{
css:false,
enter:function(el,done){
//元素已被插入DOM
//在动画结束后调用done
$(el)
.css('opacity',0)
.animate({opacity:1},1000,done)
},
enterCancelled:function(el){
$(el).stop()
},
leave:function(el,done){
//与enter相同
$(el).animate({opacity:0},1000,done)
},
leaveCancelled:function(el){
$(el).stop()
}
})
然后用transition特性中:
渐近过渡
transition与v-for一起用时可以创建渐近过渡。给过渡元素添加一个特性stagger,enter-stagger或leave-stagger:
或者,提供一个钩子stagger,enter-stagger或leave-stagger,以更好的控制:
Vue.transition('stagger',{
stagger:function(index){
//每个过渡项目增加50ms延时
//但是最大延时限制为300ms
returnMath.min(300,index*50)
}
})