Vue动画事件详解及过渡动画实例
为了应用过渡效果,需要在目标元素上使用 transition 特性:
<div v-if="show" transition="my-transition"></div>
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 过渡像这样:
<div v-if="show" transition="expand">hello</div>
然后为 .expand-transition, .expand-enter 和 .expand-leave 添加 css 规则:
/* 必需 */ .expand-transition { transition: all .3s ease; height: 30px; padding: 10px; background-color: #eee; overflow: hidden; } /* .expand-enter 定义进入的开始状态 */ /* .expand-leave 定义离开的结束状态 */ .expand-enter, .expand-leave { height: 0; padding: 0 10px; opacity: 0; }
你可以在同一元素上通过动态绑定实现不同的过渡:
<div v-if="show" :transition="transitionname">hello</div>
new vue({ 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) { // handle cancellation }, beforeleave: function (el) { el.textcontent = 'beforeleave' }, leave: function (el) { el.textcontent = 'leave' }, afterleave: function (el) { el.textcontent = 'afterleave' }, leavecancelled: function (el) { // handle cancellation } })
过渡的 css 类名
类名的添加和切换取决于 transition 特性的值。比如 transition="fade",会有三个 css 类名:
.fade-transition 始终保留在元素上。
.fade-enter 定义进入过渡的开始状态。只应用一帧然后立即删除。
.fade-leave 定义离开过渡的结束状态。在离开过渡开始时生效,在它结束后删除。
如果 transition 特性没有值,类名默认是 .v-transition, .v-enter 和 .v-leave。
自定义过渡类名
我们可以在过渡的 javascript 定义中声明自定义的 css 过渡类名。这些自定义类名会覆盖默认的类名。当需要和第三方的 css 动画库,比如 animate.css 配合时会非常有用:
<div v-show="ok" class="animated" transition="bounce">watch me bounce</div>
vue.transition('bounce', { enterclass: 'bounceinleft', leaveclass: 'bounceoutright' })
显式声明 css 过渡类型
vue.js 需要给过渡元素添加事件侦听器来侦听过渡何时结束。基于所使用的 css,该事件要么是 transitionend,要么是 animationend。
如果你只使用了两者中的一种,那么 vue.js 将能够根据生效的 css 规则自动推测出对应的事件类型。但是,有些情况下一个元素可能需要同时带有两种类型的动画。比如你可能希望让 vue 来触发一个 css animation,同时该元素在鼠标悬浮时又有 css transition 效果。这样的情况下,你需要显式地声明你希望 vue 处理的动画类型 (animation 或是 transition):
vue.transition('bounce', { // 该过渡效果将只侦听 `animationend` 事件 type: 'animation' })
过渡流程详解
当 show 属性改变时,vue.js 将相应地插入或删除 <div> 元素,按照如下规则改变过渡的 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 可以有第二个可选的回调参数,用于显式控制过渡如何结束。因此不必等待 css transitionend 事件, vue.js 将等待你手工调用这个回调,以结束过渡。例如:
enter: function (el) { // 没有第二个参数 // 由 css transitionend 事件决定过渡何时结束 }
vs.
enter: function (el, done) { // 有第二个参数 // 过渡只有在调用 `done` 时结束 }
<p class="tip">当多个元素一起过渡时,vue.js 会批量处理,只强制一次布局。
css 动画
css 动画用法同 css 过渡,区别是在动画中 v-enter 类名在节点插入 dom 后不会立即删除,而是在 animationend 事件触发时删除。
示例: (省略了兼容性前缀)
<span v-show="show" transition="bounce">look at me!</span>
.bounce-transition { display: inline-block; /* 否则 scale 动画不起作用 */ } .bounce-enter { animation: bounce-in .5s; } .bounce-leave { animation: bounce-out .5s; } @keyframes bounce-in { 0% { transform: scale(0); } 50% { transform: scale(1.5); } 100% { transform: scale(1); } } @keyframes bounce-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 特性中:
<p transition="fade"></p>
渐近过渡
transition 与 v-for 一起用时可以创建渐近过渡。给过渡元素添加一个特性 stagger, enter-stagger 或 leave-stagger:
<div v-for="item in list" transition="stagger" stagger="100"></div>
或者,提供一个钩子 stagger, enter-stagger 或 leave-stagger,以更好的控制:
vue.transition('stagger', { stagger: function (index) { // 每个过渡项目增加 50ms 延时 // 但是最大延时限制为 300ms return math.min(300, index * 50) } })