经过Vue.js
的过渡系统,能够在元素从DOM
中插入或移除时自动应用过渡效果。Vue.js
会在适当的时机为你触发CSS
过渡或动画,你也能够提供相应的JavaScript
钩子函数在过渡过程当中执行自定义的DOM
操做。
为了应用过渡效果,须要在目标元素上使用 transition
特性:css
<div v-if="show" transition="my-transition"></div>
vue
transition
特性能够与下面资源一块儿用:segmentfault
当插入或删除带有过渡的元素时,Vue 将:app
示例函数
典型的 CSS 过渡像这样:布局
<div v-if="show" transition="expand">hello</div>
动画
而后为 .expand-transition
, .expand-enter
和 .expand-leave
添加 CSS 规则:this
/* 必需 */ .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; }
你能够在同一元素上经过动态绑定实现不一样的过渡: spa
<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 } })
类名的添加和切换取决于 transition
特性的值。好比 transition="fade",会有三个 CSS 类名:
若是 transition 特性没有值,类名默认是 .v-transition, .v-enter 和 .v-leave。
自定义过渡类名
1.0.14 新增
咱们能够在过渡的 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 过渡类型
1.0.14 新增
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 类名:
另外,若是在它的进入过渡还在进行中时删除元素,将调用 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 过渡,区别是在动画中 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 钩子,不用定义任何 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) } })