Vue.js进入/离开&列表过度动画。
概述
Vue在插入、更新或则移除DOM时,提供多种不同方式的应用过渡效果。
包括以下工具:
*在CSS过渡和动画中自动应用class *可以配合第三方CSS动画库,如Animate.css *在过渡钩子函数中使用Javascript直接操作DOM *可以配合使用第三方Javascript动画库,如Velocity.js
在这里,我们只会讲到进入、离开和列表的过渡。
单元素/组件的过渡
Vue提供了transition的封装组件,在下列情形中,可以给任何元素和组件添加进入/离开过渡。
*条件渲染(使用v-if) *条件展示(使用v-show) *动态组件 *组件根节点
这里是一个典型的例子:
<div id="demo"> <button v-on:click="show=!show"> Toggle </button> <transition name="fade"> <p v-if="show">hello</p> </transition> </div> new Vue({ el:'#demo', data:{ show:true } }) //css .fade-enter-active,.fade-leave-active{ transition:opacity .5s; } .fade-enter,.fade-leave-to{ opacity:0; }
当插入或删除包含在transition组件中的元素时,Vue将会做以下处理:
1.自动嗅探目标元素是否应用了CSS过渡或动画,如果是,在恰当的时机添加/删除CSS类名。 2.如果过渡组件提供了Javascript钩子函数,这些钩子函数将在恰当的时机被调用。 3.如果没有找到JavaScript钩子并且也没有检测到CSS过渡/动画,DOM操作(插入/删除)在下一帧中立即执行。(注意:此指浏览器逐帧动画机制,和Vue的nextTick概念不同)
过渡的类名
在进入/离开的过渡中,会有6个class切换。
1.v-enter:定义进入过渡的开始状态。在元素被插入之前生效,在元素被插入之后下一帧移除。 2.v-enter-active:定义进入过渡生效时的状态。在整个进入过渡的阶段中应用,在元素被插入之前生效,在过渡/动画完成之后移除。这个类可以被用来定义进入过渡的过程时间,延迟和曲线函数。 3.v-enter-to:2.1.8版及以上定义进入过渡的结束状态。在元素被插入之后下一帧生效(与此同时v-enter被移除),在过渡/动画完成之后移除。 4.v-leave:定义离开过渡的开始状态。在离开过渡被触发时立刻生效,下一帧移除。 5.v-leave-active:定义离开过渡生效时的状态。在整个离开过渡的阶段中应用,在离开过渡被触发时立刻生效,在过渡/动画完成之后移除。这个类可以被用来定义离开过渡的过程时间,延迟和曲线函数。 6.v-leave-to:2.1.8版本及以上定义离开过渡的结束状态。在离开过渡被触发之后下一帧生效(与此同时v-leave被删除),在过渡/动画完成之后移除。
对于这些在过渡中切换的类名来说,如果你使用一个没有名字的<transition>,则v-是这些类名的默认前缀。如果你使用了<transition name="my-transition">,那么v-enter会替换为my-transition-enter。
v-enter-active和v-leave-active可以控制进入/离开过渡的不同的缓和曲线。
CSS过渡
常用的过渡都是使用CSS过渡。
下面是一个简单的例子:
<div id="example-1"> <button @click="show=!show"> Toggle render <button> <transition name="slide-fade"> <p v-if="show">hello</p> </transition> </div> new Vue({ el:'#example-1', data:{ show:true } }) /*可以设置不同的进入和离开动画*/ /*设置持续时间和动画函数*/ .slide-fade-enter-active{ transition:all .3s ease; } .slide-fade-leave-active{ transition:all .8s cubic-bezier(1.0,0.5,0.8,1.0); } .slide-fade-enter,.slide-fade-leave-to{ transform:translateX(10px); opacity:0; }
CSS动画
CSS动画用法同CSS过渡,区别是在动画中v-enter类名在节点插入DOM后不会立即删除,而是在animationend事件触发时删除。
<div id="example-2"> <button @click="show=!show">Toggle show</button> <transition name="bounce"> <p v-if="show">Lorem ipsum dolor sit amet,consectetur adipiscing elit.Mauris facilisis enim libero, at lacinia diam fermentum id. Pellentesque habitant morbi tristique senectus et netus.</p> </transition> </div> new Vue({ el:'#example-2', data:{ show:true } }) .bounce-enter-active{ animation:bounce-in .5s; } .bounce-leave-active{ animation:bounce-in .5s reverse; } @keyframes bounce-in{ 0%{ transform:scale(0); } 50%{ transition:scale(1.5); } 100%{ transition:scale(1); } }
自定义过渡的类名
我们可以通过以下特性来自定义过渡类名:
*enter-calss *enter-active-class *enter-to-class *leave-class *leave-active-class *leave-to-class
它们的优先级高于普通的类名,这对于Vue的过渡系统和其他第三方CSS动画库,如Animate.css结合使用十分有用。
示例:
<link href="https://cdn.jsdelivr.net/npm/[email protected]" rel="stylesheet" type="text/css"> <div id="example-3"> <button @click="show = !show"> Toggle render </button> <transition name="custom-classes-transition" enter-active-class="animated tada" leave-active-class="animated bounceOutRight" > <p v-if="show">hello</p> </transition> </div> new Vue({ el: '#example-3', data: { show: true } })
同时使用过渡和动画
Vue为了知道过渡的完成,必须设置相应的事件监听器。它可以是transitionend或animationend,这取决于给元素应用的CSS规则。如果你使用其中任何一种,Vue能自动识别类型并设置监听。
但是,在一些场景中,你需要给同一个元素同时设置两种过渡动效,比如animation很快的被触发并完成了,而transition效果还没结束。在这种情况中,你就需要使用type特性并设置animation或transition来明确声明你需要Vue监听的类型。
显性的过渡持续时间
在很多情况下,Vue可以自动得出过渡效果的完成时机。默认情况下,Vue会等待其在过渡效果的根元素的第一个transitionend或animationend事件。然而也可以不这样设定,比如,我们可以拥有一个精心编排的一系列过渡效果,其中一些嵌套的内部元素相比于过渡效果的根元素有延迟的或更长的过渡效果。
在这种情况下你可以用<transition>组件上的duration属性定制一个显性的过度持续时间(以毫秒计):
<transition :duration="1000">...</transition> 你也可以定制进入和移除的持续时间: <transition :aduration="{enter:500,leave:800}">...</transition>
JavaScript钩子
可以在属性中声明JavaScript钩子。
<transition v-on:before-enter="beforeEnter" v-on:enter="enter" v-on:after-enter="afterEnter" v-on:enter-cancelled="enterCancelled" v-on:before-leave="beforeLeave" v-on:leave="leave" v-on:after="afterLeave" v-on:leave-cancelled="leaveCancelled" > </transition> // ... methods: { // -------- // 进入中 // -------- beforeEnter: function (el) { // ... }, // 当与 CSS 结合使用时 // 回调函数 done 是可选的 enter: function (el, done) { // ... done() }, afterEnter: function (el) { // ... }, enterCancelled: function (el) { // ... }, // -------- // 离开时 // -------- beforeLeave: function (el) { // ... }, // 当与 CSS 结合使用时 // 回调函数 done 是可选的 leave: function (el, done) { // ... done() }, afterLeave: function (el) { // ... }, // leaveCancelled 只用于 v-show 中 leaveCancelled: function (el) { // ... } }
这些钩子函数可以结合 CSS transitions/animations 使用,也可以单独使用。
当只用 JavaScript 过渡的时候,在 enter 和 leave 中必须使用 done 进行回调。否则,它们将被同步调用,过渡会立即完成。
推荐对于仅使用 JavaScript 过渡的元素添加 v-bind:css="false",Vue 会跳过 CSS 的检测。这也可以避免过渡过程中 CSS 的影响。
一个使用 Velocity.js 的简单例子:
<script src="https://cdnjs.cloudflare.com/ajax/libs/velocity/1.2.3/velocity.min.js"></script> <div id="example-4"> <button @click="show = !show"> Toggle </button> <transition v-on:before-enter="beforeEnter" v-on:enter="enter" v-on:leave="leave" v-bind:css="false" > <p v-if="show"> Demo </p> </transition> </div> new Vue({ el: '#example-4', data: { show: false }, methods: { beforeEnter: function (el) { el.style.opacity = 0 el.style.transformOrigin = 'left' }, enter: function (el, done) { Velocity(el, { opacity: 1, fontSize: '1.4em' }, { duration: 300 }) Velocity(el, { fontSize: '1em' }, { complete: done }) }, leave: function (el, done) { Velocity(el, { translateX: '15px', rotateZ: '50deg' }, { duration: 600 }) Velocity(el, { rotateZ: '100deg' }, { loop: 2 }) Velocity(el, { rotateZ: '45deg', translateY: '30px', translateX: '30px', opacity: 0 }, { complete: done }) } } })
初始渲染的过渡
可以通过apper特性设置节点在初始渲染的过渡
<transition apper></transition>
这里默认和进入/离开过渡一样,同样也可以自定义CSS类名。
<transition appear appear-class="custom-appear-class" appear-to-class="custom-appear-to-class" (2.1.8+) appear-active-class="custom-appear-active-class" > <!-- ... --> </transition>
自定义JavaScript钩子:
<transition appear v-on:before-appear="customBeforeAppearHook" v-on:appear="customAppearHook" v-on:after-appear="customAfterAppearHook" v-on:appear-cancelled="customAppearCancelledHook" > <!-- ... --> </transition>
多个元素的过渡
我们之后讨论多个组件的过渡,对于原生标签可以使用v-if/v-else。最常见的多标签过渡是一个列表和描述这个列表为空消息的元素:
<transition> <table v-if="items.length > 0"> <!-- ... --> </table> <p v-else>Sorry, no items found.</p> </transition>
当有相同标签名的元素切换时,需要通过key特性设置唯一的值来标记以上Vue区分它们,否则Vue为了效率只会替换相同标签内部的内容。即使在技术上没有必要,给在<transition>组件中的多个元素设置key是一个更好的实践。
实例:
<transition> <button v-if="isEditing" key="save"> Save </button> <button v-else key="edit"> Edit </button> </transition>
在一些场景中,也可以通过给同一个元素key特性设置不同的状态来代替v-if和v-else,上面的例子可以重写为:
<transition> <button v-bind:key="isEditing"> {{ isEditing ? 'Save' : 'Edit' }} </button> </transition>
使用多个v-if的多个元素的过渡可以重写为绑定了动态属性的单个元素过渡。例如:
<transition> <button v-if="docState === 'saved'" key="saved"> Edit </button> <button v-if="docState === 'edited'" key="edited"> Save </button> <button v-if="docState === 'editing'" key="editing"> Cancel </button> </transition>
可以重写为:
<transition> <button v-bind:key="docState"> {{ buttonMessage }} </button> </transition> computed: { buttonMessage: function () { switch (this.docState) { case 'saved': return 'Edit' case 'edited': return 'Save' case 'editing': return 'Cancel' } } }
过度模式
<transition>的默认行为-进入和离开同时发生。在元素绝对定位在彼此之上时运行正常。
同时生效的进入和离开的过渡不能满足所有要求,所以Vue提供了过渡模式。
*in-out:新元素先进入过渡,完成之后当前元素过渡离开。 *out-in:当前元素先进行过渡,完成之后新元素过渡进入。
多个组件的过渡
多个组件的过渡简单很多-我们不需要使用key特性。相反,我们只需要使用动态组件:
<transition name="component-fade" mode="out-in"> <component v-bind:is="view"></component> <transition> new Vue({ el:'#transition-components-demo', data:{ view:'v-a' }, components:{ 'v-a':{ template:'<div>Component A<div>' }, 'v-b':{ template:'<div>Component B<div>' } } }) .component-fade-enter-active, .component-fade-leave-active { transition: opacity .3s ease; } .component-fade-enter, .component-fade-leave-to /* .component-fade-leave-active for below version 2.1.8 */ { opacity: 0; }
## 列表过渡 ##
怎么同时渲染整个列表,比如使用v-for,在这种场景中,使用<teansition-group>组件。在我们深入例子之前,先了解关于这个组件的几个特点:
*不同于<transition>,它会以一个真实元素呈现:默认为一个<span>。你也可以通过tag特性更换为其他元素。 *过渡模式不可用,因为我们不再相互切换特有的元素。 *内部元素总是需要提供唯一key属性值。
列表的进入/离开过渡
现在让我们由一个简单的例子深入,进入和离开的过渡使用之前一样CSS类名。
<div id="list-demo" class="demo"> <button v-on:click="add">Add</button> <button v-on:click="remove">Remove</button> <transition-group name="list" tag="p"> <span v-for="item in items" v-bind:key="item" class="list-item"> {{item}} </span> </transition-group> </div> new Vue({ el:'#list-demo', data:{ items:[1,2,3,4,5,6,7,8,9], nextNum:10 }, methods:{ randomIndex:function(){ return Math.floor(Math.random()*this.items.length) }, add:function(){ this.items.splice(this.randomIndex(),0,this.nextNum++) }, remove:function(){ this.items.splice(this.randomIndex(),1) } } }) .list-item{ display:inline-block; margin-right:10px; } .list-enter-active,.list-leave-active{ transition:all 1s; } .list-enter,.list-leave-to{ opacity:0; transform:translateY(30px); }
这个例子有个问题,当添加移除元素的时候,周围的元素会瞬间移动到他们的新布局位置,而不是平滑的过渡,我们下面会解决这个问题。
《列表的排序过渡》
<transition-group>组件还有一个特殊之处。不仅可以进入和离开动画,还可以改变定位。要使用这个新功能只需要了解新增的v-mode特性,它会在元素的改变定位的过程中应用。像之前的类名一样,可以通过name属性来自定义前缀,也可以通过move-class属性手动设置。
v-move对于设置过渡的切换时机和过渡曲线非常有用,你会看到如下的例子:
<div id="filp-list-demo" class="demo"> <button v-on:click="shuffle">Shuffle</button> <transition-group name="filp-list" tag="ul"> <li v-for="item in items" v-bind:key="item"> {{item}} </li> </transition-group> </div> new Vue({ el:'#filp-list-demo', data:{ items:[1,2,3,4,5,6,7,8,9] }, methods:{ shuffle:function(){ this.items=_.shuffle(this.items) } } }) .flip-list-move{ transition:transform 1s; }