过渡

Vue 在插入、更新或者移除 DOM 时，提供多种不同方式的应用过渡效果。
Vue 提供了内置的过渡封装组件，该组件用于包裹要实现过渡效果的组件。

过渡其实就是一个淡入淡出的效果。Vue在元素显示与隐藏的过渡中，提供了 6 个 class 来切换：

  • v-enter：定义进入过渡的开始状态。在元素被插入之前生效，在元素被插入之后的下一帧移除。
  • v-enter-active：定义进入过渡生效时的状态。在整个进入过渡的阶段中应用，在元素被插入之前生效，在过渡/动画完成之后移除。这个类可以被用来定义进入过渡的过程时间，延迟和曲线函数。
  • v-enter-to: 2.1.8版及以上 定义进入过渡的结束状态。在元素被插入之后下一帧生效 (与此同时 v-enter 被移除)，在过渡/动画完成之后移除。
  • v-leave: 定义离开过渡的开始状态。在离开过渡被触发时立刻生效，下一帧被移除。
  • v-leave-active：定义离开过渡生效时的状态。在整个离开过渡的阶段中应用，在离开过渡被触发时立刻生效，在过渡/动画完成之后移除。这个类可以被用来定义离开过渡的过程时间，延迟和曲线函数。
  • v-leave-to: 2.1.8版及以上 定义离开过渡的结束状态。在离开过渡被触发之后下一帧生效 (与此同时 v-leave 被删除)，在过渡/动画完成之后移除。

image.png
对于这些在过渡中切换的类名来说，如果你使用一个没有名字的 <transition>，则 v- 是这些类名的默认前缀。如果你使用了 <transition name="my-transition">，那么 v-enter 会替换为 my-transition-enter。

过渡开始与过渡生效与过渡移除

  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta charset="utf-8">
  5. <title>Vue 测试实例 - 菜鸟教程(runoob.com)</title>
  6. <script src="https://cdn.staticfile.org/vue/2.2.2/vue.min.js"></script>
  7. <style>
  8. /* 可以设置不同的进入和离开动画 */
  9. /* 设置持续时间和动画函数 */
  10. .fade-enter-active, .fade-leave-active {
  11.     transition: opacity 2s
  12. }
  13. .fade-enter, .fade-leave-to /* .fade-leave-active, 2.1.8 版本以下 */ {
  14.     opacity: 0
  15. }
  16. </style>
  17. </head>
  18. <body>
  19. <div id = "databinding">
  20. <button v-on:click = "show = !show">点我</button>
  21. <transition name = "fade">
  22.     <p v-show = "show" v-bind:style = "styleobj">动画实例</p>
  23. </transition>
  24. </div>
  25. <script type = "text/javascript">
  26. var vm = new Vue({
  27. el: '#databinding',
  28.     data: {
  29.         show:true,
  30.         styleobj :{
  31.             fontSize:'30px',
  32.             color:'red'
  33.         }
  34.     },
  35.     methods : {
  36.     }
  37. });
  38. </script>
  39. </body>
  40. </html>

过渡的曲线

v-enter-active 和 v-leave-active 可以控制进入/离开过渡的不同的缓和曲线

  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta charset="utf-8">
  5. <title>Vue 测试实例 - 菜鸟教程(runoob.com)</title>
  6. <script src="https://cdn.staticfile.org/vue/2.2.2/vue.min.js"></script>
  7. <style>
  8. /* 可以设置不同的进入和离开动画 */
  9. /* 设置持续时间和动画函数 */
  10. .slide-fade-enter-active {
  11.   transition: all .3s ease;
  12. }
  13. .slide-fade-leave-active {
  14.   transition: all .8s cubic-bezier(1.0, 0.5, 0.8, 1.0);
  15. }
  16. .slide-fade-enter, .slide-fade-leave-to
  17. /* .slide-fade-leave-active 用于 2.1.8 以下版本 */ {
  18.   transform: translateX(10px);
  19.   opacity: 0;
  20. }
  21. </style>
  22. </head>
  23. <body>
  24. <div id = "databinding">
  25. <button v-on:click = "show = !show">点我</button>
  26. <transition name="slide-fade">
  27.     <p v-if="show">菜鸟教程</p>
  28. </transition>
  29. </div>
  30. <script type = "text/javascript">
  31. new Vue({
  32.     el: '#databinding',
  33.     data: {
  34.         show: true
  35.     }
  36. })
  37. </script>
  38. </body>
  39. </html>

动画的使用

CSS 动画用法类似 CSS 过渡，但是在动画中 v-enter 类名在节点插入 DOM 后不会立即删除，而是在 animationend 事件触发时删除。

  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta charset="utf-8">
  5. <title>Vue 测试实例 - 菜鸟教程(runoob.com)</title>
  6. <script src="https://cdn.staticfile.org/vue/2.2.2/vue.min.js"></script>
  7. <style>
  8. .bounce-enter-active {
  9.   animation: bounce-in .5s;
  10. }
  11. .bounce-leave-active {
  12.   animation: bounce-in .5s reverse;
  13. }
  14. @keyframes bounce-in {
  15.   0% {
  16.     transform: scale(0);
  17.   }
  18.   50% {
  19.     transform: scale(1.5);
  20.   }
  21.   100% {
  22.     transform: scale(1);
  23.   }
  24. }
  25. </style>
  26. </head>
  27. <body>
  28. <div id = "databinding">
  29. <button v-on:click = "show = !show">点我</button>
  30. <transition name="bounce">
  31.     <p v-if="show">菜鸟教程 -- 学的不仅是技术，更是梦想！！！</p>
  32. </transition>
  33. </div>
  34. <script type = "text/javascript">
  35. new Vue({
  36.     el: '#databinding',
  37.     data: {
  38.         show: true
  39.     }
  40. })
  41. </script>
  42. </body>
  43. </html>

自定义过渡的类名

我们可以通过以下特性来自定义过渡类名：

  • enter-class
  • enter-active-class
  • enter-to-class (2.1.8+)
  • leave-class
  • leave-active-class
  • leave-to-class (2.1.8+)

自定义过渡的类名优先级高于普通的类名，这样就能很好的与第三方（如：animate.css）的动画库结合使用。

  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta charset="utf-8">
  5. <title>Vue 测试实例 - 菜鸟教程(runoob.com)</title>
  6. <script src="https://cdn.staticfile.org/vue/2.2.2/vue.min.js"></script>
  7. <link href="https://cdn.jsdelivr.net/npm/animate.css@3.5.1" rel="stylesheet" type="text/css">
  8. </head>
  9. <body>
  10. <div id = "databinding">
  11. <button v-on:click = "show = !show">点我</button>
  12. <transition
  13.     name="custom-classes-transition"
  14.     enter-active-class="animated tada"
  15.     leave-active-class="animated bounceOutRight"
  16. >
  17.     <p v-if="show">菜鸟教程 -- 学的不仅是技术，更是梦想！！！</p>
  18. </transition>
  19. </div>
  20. <script type = "text/javascript">
  21. new Vue({
  22.     el: '#databinding',
  23.     data: {
  24.         show: true
  25.     }
  26. })
  27. </script>
  28. </body>
  29. </html>

同时使用过渡和动画

Vue 为了知道过渡的完成，必须设置相应的事件监听器。它可以是 transitionend 或 animationend ，这取决于给元素应用的 CSS 规则。如果你使用其中任何一种，Vue 能自动识别类型并设置监听。
但是，在一些场景中，你需要给同一个元素同时设置两种过渡动效，比如 animation 很快的被触发并完成了，而 transition 效果还没结束。在这种情况中，你就需要使用 type 特性并设置 animation 或 transition 来明确声明你需要 Vue 监听的类型。

显性的过渡持续时间

在很多情况下，Vue 可以自动得出过渡效果的完成时机。默认情况下，Vue 会等待其在过渡效果的根元素的第一个 transitionend 或 animationend 事件。然而也可以不这样设定——比如，我们可以拥有一个精心编排的一系列过渡效果，其中一些嵌套的内部元素相比于过渡效果的根元素有延迟的或更长的过渡效果。
在这种情况下你可以用 <transition> 组件上的 duration 属性定制一个显性的过渡持续时间 (以毫秒计)：
…
你也可以定制进入和移出的持续时间：
…

JavaScript 钩子

可以在属性中声明 JavaScript 钩子:

  1. <transition
  2.   v-on:before-enter="beforeEnter"
  3.   v-on:enter="enter"
  4.   v-on:after-enter="afterEnter"
  5.   v-on:enter-cancelled="enterCancelled"
  7.   v-on:before-leave="beforeLeave"
  8.   v-on:leave="leave"
  9.   v-on:after-leave="afterLeave"
  10.   v-on:leave-cancelled="leaveCancelled"
  11. >
  12.   <!-- ... -->
  13. </transition>
  1. // ...
  2. methods: {
  3.   // --------
  4.   // 进入中
  5.   // --------
  7.   beforeEnter: function (el) {
  8.     // ...
  9.   },
  10.   // 此回调函数是可选项的设置
  11.   // 与 CSS 结合时使用
  12.   enter: function (el, done) {
  13.     // ...
  14.     done()
  15.   },
  16.   afterEnter: function (el) {
  17.     // ...
  18.   },
  19.   enterCancelled: function (el) {
  20.     // ...
  21.   },
  23.   // --------
  24.   // 离开时
  25.   // --------
  27.   beforeLeave: function (el) {
  28.     // ...
  29.   },
  30.   // 此回调函数是可选项的设置
  31.   // 与 CSS 结合时使用
  32.   leave: function (el, done) {
  33.     // ...
  34.     done()
  35.   },
  36.   afterLeave: function (el) {
  37.     // ...
  38.   },
  39.   // leaveCancelled 只用于 v-show 中
  40.   leaveCancelled: function (el) {
  41.     // ...
  42.   }
  43. }

这些钩子函数可以结合 CSS transitions/animations 使用，也可以单独使用。
当只用 JavaScript 过渡的时候，在 enter 和 leave 中必须使用 done 进行回调。否则，它们将被同步调用，过渡会立即完成。
推荐对于仅使用 JavaScript 过渡的元素添加 v-bind:css="false"，Vue 会跳过 CSS 的检测。这也可以避免过渡过程中 CSS 的影响。

例子

  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <meta charset="utf-8">
  5. <title>Vue 测试实例 - 菜鸟教程(runoob.com)</title>
  6. <script src="https://cdn.staticfile.org/vue/2.2.2/vue.min.js"></script>
  7. <script src="https://cdnjs.cloudflare.com/ajax/libs/velocity/1.2.3/velocity.min.js"></script>
  8. </head>
  9. <body>
  10. <div id = "databinding">
  11. <button v-on:click = "show = !show">点我</button>
  12. <transition
  13.     v-on:before-enter="beforeEnter"
  14.     v-on:enter="enter"
  15.     v-on:leave="leave"
  16.     v-bind:css="false"
  17.   >
  18.     <p v-if="show">菜鸟教程 -- 学的不仅是技术，更是梦想！！！</p>
  19. </transition>
  20. </div>
  21. <script type = "text/javascript">
  22. new Vue({
  23.   el: '#databinding',
  24.   data: {
  25.     show: false
  26.   },
  27.   methods: {
  28.     beforeEnter: function (el) {
  29.       el.style.opacity = 0
  30.       el.style.transformOrigin = 'left'
  31.     },
  32.     enter: function (el, done) {
  33.       Velocity(el, { opacity: 1, fontSize: '1.4em' }, { duration: 300 })
  34.       Velocity(el, { fontSize: '1em' }, { complete: done })
  35.     },
  36.     leave: function (el, done) {
  37.       Velocity(el, { translateX: '15px', rotateZ: '50deg' }, { duration: 600 })
  38.       Velocity(el, { rotateZ: '100deg' }, { loop: 2 })
  39.       Velocity(el, {
  40.         rotateZ: '45deg',
  41.         translateY: '30px',
  42.         translateX: '30px',
  43.         opacity: 0
  44.       }, { complete: done })
  45.     }
  46.   }
  47. })
  48. </script>
  49. </body>
  50. </html>

初始渲染的过渡

可以通过 appear 特性设置节点在初始渲染的过渡

  1. <transition appear>
  2.   <!-- ... -->
  3. </transition>

这里默认和进入/离开过渡一样，同样也可以自定义 CSS 类名。

  1. <transition
  2.   appear
  3.   appear-class="custom-appear-class"
  4.   appear-to-class="custom-appear-to-class" (2.1.8+)
  5.   appear-active-class="custom-appear-active-class"
  6. >
  7.   <!-- ... -->
  8. </transition>

自定义 JavaScript 钩子：

  1. <transition
  2.   appear
  3.   v-on:before-appear="customBeforeAppearHook"
  4.   v-on:appear="customAppearHook"
  5.   v-on:after-appear="customAfterAppearHook"
  6.   v-on:appear-cancelled="customAppearCancelledHook"
  7. >
  8.   <!-- ... -->
  9. </transition>

多个元素的过渡

我们可以设置多个元素的过渡，一般列表与描述：
需要注意的是当有相同标签名的元素切换时，需要通过 key 特性设置唯一的值来标记以让 Vue 区分它们，否则 Vue 为了效率只会替换相同标签内部的内容。

  1. <transition>
  2.   <table v-if="items.length > 0">
  3.     <!-- ... -->
  4.   </table>
  5.   <p v-else>抱歉，没有找到您查找的内容。</p>
  6. </transition>

如下实例：

  1. <transition>
  2.   <button v-if="isEditing" key="save">
  3.     Save
  4.   </button>
  5.   <button v-else key="edit">
  6.     Edit
  7.   </button>
  8. </transition>

在一些场景中，也可以通过给同一个元素的 key 特性设置不同的状态来代替 v-if 和 v-else，上面的例子可以重写为：

  1. <transition>
  2.   <button v-bind:key="isEditing">
  3.     {{ isEditing ? 'Save' : 'Edit' }}
  4.   </button>
  5. </transition>

使用多个 v-if 的多个元素的过渡可以重写为绑定了动态属性的单个元素过渡。例如：

  1. <transition>
  2.   <button v-if="docState === 'saved'" key="saved">
  3.     Edit
  4.   </button>
  5.   <button v-if="docState === 'edited'" key="edited">
  6.     Save
  7.   </button>
  8.   <button v-if="docState === 'editing'" key="editing">
  9.     Cancel
  10.   </button>
  11. </transition>

可以重写为：

  1. <transition>
  2.   <button v-bind:key="docState">
  3.     {{ buttonMessage }}
  4.   </button>
  5. </transition>
  7. // ...
  9. computed: {
  10.   buttonMessage: function () {
  11.     switch (this.docState) {
  12.       case 'saved': return 'Edit'
  13.       case 'edited': return 'Save'
  14.       case 'editing': return 'Cancel'
  15.     }
  16.   }
  17. }