概述

Vue 在插入、更新或者移除 DOM 時，提供多種不同方式的應用過渡效果濒憋。
包括以下工具：

• 在 CSS 過渡和動畫中自動應用 class
• 可以配合使用第三方 CSS 動畫庫壶熏，如 Animate.css
• 在過渡鉤子函數(shù)中使用 JavaScript 直接操作 DOM
• 可以配合使用第三方 JavaScript 動畫庫，如 Velocity.js

單元素/組件的過渡

Vue 提供了 transition 的封裝組件咸包，在下列情形中桃序，可以給任何元素和組件添加 entering/leaving 過渡

• 條件渲染 （使用 v-if）
• 條件展示 （使用 v-show）
• 動態(tài)組件
• 組件根節(jié)點

<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
  }
})
.fade-enter-active, .fade-leave-active {
  transition: opacity .5s
}
.fade-enter, .fade-leave-active {
  opacity: 0
}

元素封裝成過渡組件之后，在遇到插入或刪除時烂瘫，Vue 將

1.自動嗅探目標元素是否有 CSS 過渡或動畫媒熊，并在合適時添加/刪除 CSS 類名。
2.如果過渡組件設置了過渡的 JavaScript 鉤子函數(shù)坟比，會在相應的階段調(diào)用鉤子函數(shù)芦鳍。
3.如果沒有找到 JavaScript 鉤子并且也沒有檢測到 CSS 過渡/動畫，DOM 操作（插入/刪除）在下一幀中立即執(zhí)行葛账。(注意：此指瀏覽器逐幀動畫機制柠衅，與 Vue，和Vue的nextTick
概念不同)

過渡的-CSS-類名

會有 4 個(CSS)類名在 enter/leave 的過渡中切換

1.v-enter: 定義進入過渡的開始狀態(tài)籍琳。在元素被插入時生效菲宴，在下一個幀移除。
2.v-enter-active: 定義進入過渡的結(jié)束狀態(tài)趋急。在元素被插入時生效喝峦，在transition/animation 完成之后移除。
3.v-leave: 定義離開過渡的開始狀態(tài)宣谈。在離開過渡被觸發(fā)時生效愈犹，在下一個幀移除。
4.v-leave-active: 定義離開過渡的結(jié)束狀態(tài)闻丑。在離開過渡被觸發(fā)時生效漩怎，在transition/animation 完成之后移除。

對于這些在 enter/leave 過渡中切換的類名嗦嗡，v- 是這些類名的前綴勋锤。使用<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
  }
})
/* 可以設置不同的進入和離開動畫 */
/* 設置持續(xù)時間和動畫函數(shù) */
.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-active {
  padding-left: 10px;
  opacity: 0;
}

CSS 動畫

CSS 動畫用法同 CSS 過渡茄厘，區(qū)別是在動畫中 v-enter 類名在節(jié)點插入 DOM 后不會立即刪除，而是在 animationend 事件觸發(fā)時刪除谈宛。

<div id="example-2">
  <button @click="show = !show">Toggle show</button>
  <transition name="bounce">
    <p v-if="show">Look at me!</p>
  </transition>
</div>
new Vue({
  el: '#example-2',
  data: {
    show: true
  }
})
.bounce-enter-active {
  animation: bounce-in .5s;
}
.bounce-leave-active {
  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);
  }
}

自定義過渡類名

我們可以通過以下特性來自定義過渡類名：

• enter-class
• enter-active-class
• leave-class
• leave-active-class
  他們的優(yōu)先級高于普通的類名次哈，這對于 Vue 的過渡系統(tǒng)和其他第三方 CSS 動畫庫，如Animate.css 結(jié)合使用十分有用吆录。
  示例：

<link  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
  }
})

同時使用 Transitions 和 Animations

Vue 為了知道過渡的完成窑滞，必須設置相應的事件監(jiān)聽器。它可以是 transitionend 或animationend 恢筝，這取決于給元素應用的 CSS 規(guī)則哀卫。如果你使用其中任何一種，Vue 能自動識別類型并設置監(jiān)聽撬槽。

但是此改，在一些場景中，你需要給同一個元素同時設置兩種過渡動效侄柔，比如 animation 很快的被觸發(fā)并完成了共啃，而 transition 效果還沒結(jié)束。在這種情況中勋拟，你就需要使用type 特性并設置 animation 或 transition 來明確聲明你需要 Vue 監(jiān)聽的類型勋磕。

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-leave="afterLeave"
  v-on:leave-cancelled="leaveCancelled"
>
  <!-- ... -->
</transition>
// ...
methods: {
  // --------
  // 進入中
  // --------
  beforeEnter: function (el) {
    // ...
  },
  // 此回調(diào)函數(shù)是可選項的設置
  // 與 CSS 結(jié)合時使用
  enter: function (el, done) {
    // ...
    done()
  },
  afterEnter: function (el) {
    // ...
  },
  enterCancelled: function (el) {
    // ...
  },
  // --------
  // 離開時
  // --------
  beforeLeave: function (el) {
    // ...
  },
  // 此回調(diào)函數(shù)是可選項的設置
  // 與 CSS 結(jié)合時使用
  leave: function (el, done) {
    // ...
    done()
  },
  afterLeave: function (el) {
    // ...
  },
  // leaveCancelled 只用于 v-show 中
  leaveCancelled: function (el) {
    // ...
  }
}

這些鉤子函數(shù)可以結(jié)合 CSS transitions/animations 使用，也可以單獨使用敢靡。

當只用 JavaScript 過渡的時候挂滓， 在 enter 和 leave 中，回調(diào)函數(shù) done 是必須的 啸胧。 否則赶站，它們會被同步調(diào)用，過渡會立即完成纺念。

推薦對于僅使用 JavaScript 過渡的元素添加 v-bind:css="false"贝椿，Vue 會跳過 CSS 的檢測。這也可以避免過渡過程中 CSS 的影響陷谱。

一個使用 Velocity.js 的簡單例子：

<!--
Velocity works very much like jQuery.animate and is
a great option for JavaScript animations
-->
<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
    },
    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 })
    }
  }
})

初始渲染的過渡

可以通過 appear 特性設置節(jié)點的在初始渲染的過渡

<transition appear>
  <!-- ... -->
</transition>

這里默認和進入和離開過渡一樣烙博，同樣也可以自定義 CSS 類名。

<transition
  appear
  appear-class="custom-appear-class"
  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"
>
  <!-- ... -->
</transition>

多個元素的過渡

我們之后討論 多個組件的過渡,對于原生標簽可以使用 v-if
/v-else 烟逊。最常見的多標簽過渡是一個列表和描述這個列表為空消息的元素：

<transition>
  <table v-if="items.length > 0">
    <!-- ... -->
  </table>
  <p v-else>Sorry, no items found.</p>
</transition>

可以這樣使用渣窜，但是有一點需要注意：

當有相同標簽名的元素切換時，需要通過 key 特性設置唯一的值來標記以讓 Vue 區(qū)分它們宪躯，否則 Vue 為了效率只會替換相同標簽內(nèi)部的內(nèi)容乔宿。即使在技術(shù)上沒有必要，給在 <transition> 組件中的多個元素設置 key 是一個更好的實踐访雪。

示例:

<transition>
  <button v-if="isEditing" key="save">
    Save
  </button>
  <button v-else key="edit">
    Edit
  </button>
</transition>

在一些場景中详瑞，也可以給通過給同一個元素的 key 特性設置不同的狀態(tài)來代替 v-if 和v-else掂林，上面的例子可以重寫為：

<transition>
  <button v-bind:key="isEditing">
    {{ isEditing ? 'Save' : 'Edit' }}
  </button>
</transition>

使用多個 v-if 的多個元素的過渡可以重寫為綁定了動態(tài)屬性的單個元素過渡。 例如：

<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 (docState) {
      case 'saved': return 'Edit'
      case 'edited': return 'Save'
      case 'editing': return 'Cancel'
    }
  }
}

過渡模式

這里還有一個問題坝橡，試著點擊下面的按鈕：

off
在 “on” 按鈕和 “off” 按鈕的過渡中泻帮，兩個按鈕都被重繪了，一個離開過渡的時候另一個開始進入過渡驳庭。這是 <transition> 的默認行為 - 進入和離開同時發(fā)生刑顺。

在元素絕對定位在彼此之上的時候運行正常：

off
然后，我們加上 translate 讓它們運動像滑動過渡：

off
同時生效的進入和離開的過渡不能滿足所有要求饲常，所以 Vue 提供了 過渡模式

• in-out: 新元素先進行過渡，完成之后當前元素過渡離開狼讨。

• out-in: 當前元素先進行過渡贝淤，完成之后新元素過渡進入。

用 out-in 重寫之前的開關(guān)按鈕過渡：

<transition name="fade" mode="out-in">
  <!-- ... the buttons ... -->
</transition>

只用添加一個簡單的特性政供，就解決了之前的過渡問題而無需任何額外的代碼播聪。

in-out 模式不是經(jīng)常用到，但對于一些稍微不同的過渡效果還是有用的布隔。
將之前滑動淡出的例子結(jié)合：

多個組件的過渡

多個組件的過渡很簡單很多 - 我們不需要使用 key
特性离陶。相反，我們只需要使用動態(tài)組件

<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-active {
  opacity: 0;
}

列表過渡

目前為止衅檀，關(guān)于過渡我們已經(jīng)講到：

• 單個節(jié)點
• 一次渲染多個節(jié)點
  那么怎么同時渲染整個列表招刨，比如使用 v-for ？在這種場景中哀军，使用<transition-group> 組件沉眶。在我們深入例子之前，先了解關(guān)于這個組件的幾個特點：
• 不同于 <transition>杉适， 它會以一個真實元素呈現(xiàn)：默認為一個 <span>谎倔。你也可以通過 tag 特性更換為其他元素。
• 元素 一定需要 指定唯一的 key 特性值

列表的進入和離開過渡

現(xiàn)在讓我們由一個簡單的例子深入猿推，進入和離開的過渡使用之前一樣的 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-active {
  opacity: 0;
  transform: translateY(30px);
}

這個例子有個問題，當添加和移除元素的時候蹬叭，周圍的元素會瞬間移動到他們的新布局的位置藕咏，而不是平滑的過渡，我們下面會解決這個問題具垫。

列表的位移過渡

<transition-group> 組件還有一個特殊之處侈离。不僅可以進入和離開動畫，還可以改變定位筝蚕。要使用這個新功能只需了解新增的 v-move 特性卦碾，它會在元素的改變定位的過程中應用铺坞。像之前的類名一樣，可以通過 name 屬性來自定義前綴洲胖，也可以通過 move-class屬性手動設置济榨。

v-move 對于設置過渡的切換時機和過渡曲線非常有用，你會看到如下的例子：

<script src="https://cdnjs.cloudflare.com/ajax/libs/lodash.js/4.14.1/lodash.min.js"></script>
<div id="flip-list-demo" class="demo">
  <button v-on:click="shuffle">Shuffle</button>
  <transition-group name="flip-list" tag="ul">
    <li v-for="item in items" v-bind:key="item">
      {{ item }}
    </li>
  </transition-group>
</div>
new Vue({
  el: '#flip-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;
}

這個看起來很神奇绿映，內(nèi)部的實現(xiàn)擒滑，Vue 使用了一個叫 FLIP 簡單的動畫隊列使用 transforms 將元素從之前的位置平滑過渡新的位置。
我們將之前實現(xiàn)的例子和這個技術(shù)結(jié)合叉弦，使我們列表的一切變動都會有動畫過渡丐一。

<script src="https://cdnjs.cloudflare.com/ajax/libs/lodash.js/4.14.1/lodash.min.js"></script>
<div id="list-complete-demo" class="demo">
  <button v-on:click="shuffle">Shuffle</button>
  <button v-on:click="add">Add</button>
  <button v-on:click="remove">Remove</button>
  <transition-group name="list-complete" tag="p">
    <span
      v-for="item in items"
      v-bind:key="item"
      class="list-complete-item"
    >
      {{ item }}
    </span>
  </transition-group>
</div>
new Vue({
  el: '#list-complete-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)
    },
    shuffle: function () {
      this.items = _.shuffle(this.items)
    }
  }
})
.list-complete-item {
  transition: all 1s;
  display: inline-block;
  margin-right: 10px;
}
.list-complete-enter, .list-complete-leave-active {
  opacity: 0;
  transform: translateY(30px);
}
.list-complete-leave-active {
  position: absolute;
}

需要注意的是使用 FLIP 過渡的元素不能設置為 display: inline
。作為替代方案淹冰，可以設置為 display: inline-block
或者放置于 flex 中
FLIP 動畫不僅可以實現(xiàn)單列過渡库车，多維網(wǎng)格的過渡也同樣簡單

列表的漸進過渡

通過 data 屬性與 JavaScript 通信 ，就可以實現(xiàn)列表的漸進過渡：

<script src="https://cdnjs.cloudflare.com/ajax/libs/velocity/1.2.3/velocity.min.js"></script>
<div id="staggered-list-demo">
  <input v-model="query">
  <transition-group
    name="staggered-fade"
    tag="ul"
    v-bind:css="false"
    v-on:before-enter="beforeEnter"
    v-on:enter="enter"
    v-on:leave="leave"
  >
    <li
      v-for="(item, index) in computedList"
      v-bind:key="item.msg"
      v-bind:data-index="index"
    >{{ item.msg }}</li>
  </transition-group>
</div>
new Vue({
  el: '#staggered-list-demo',
  data: {
    query: '',
    list: [
      { msg: 'Bruce Lee' },
      { msg: 'Jackie Chan' },
      { msg: 'Chuck Norris' },
      { msg: 'Jet Li' },
      { msg: 'Kung Fury' }
    ]
  },
  computed: {
    computedList: function () {
      var vm = this
      return this.list.filter(function (item) {
        return item.msg.toLowerCase().indexOf(vm.query.toLowerCase()) !== -1
      })
    }
  },
  methods: {
    beforeEnter: function (el) {
      el.style.opacity = 0
      el.style.height = 0
    },
    enter: function (el, done) {
      var delay = el.dataset.index * 150
      setTimeout(function () {
        Velocity(
          el,
          { opacity: 1, height: '1.6em' },
          { complete: done }
        )
      }, delay)
    },
    leave: function (el, done) {
      var delay = el.dataset.index * 150
      setTimeout(function () {
        Velocity(
          el,
          { opacity: 0, height: 0 },
          { complete: done }
        )
      }, delay)
    }
  }
})

可復用的過渡

過渡可以通過 Vue 的組件系統(tǒng)實現(xiàn)復用樱拴。要創(chuàng)建一個可復用過渡組件柠衍，你需要做的就是將<transition> 或者 <transition-group> 作為根組件，然后將任何子組件放置在其中就可以了晶乔。

使用 template 的簡單例子：

Vue.component('my-special-transition', {
  template: '\
    <transition\
      name="very-special-transition"\
      mode="out-in"\
      v-on:before-enter="beforeEnter"\
      v-on:after-enter="afterEnter"\
    >\
      <slot></slot>\
    </transition>\
  ',
  methods: {
    beforeEnter: function (el) {
      // ...
    },
    afterEnter: function (el) {
      // ...
    }
  }
})

函數(shù)組件更適合完成這個任務：

Vue.component('my-special-transition', {
  functional: true,
  render: function (createElement, context) {
    var data = {
      props: {
        name: 'very-special-transition'
        mode: 'out-in'
      },
      on: {
        beforeEnter: function (el) {
          // ...
        },
        afterEnter: function (el) {
          // ...
        }
      }
    }
    return createElement('transition', data, context.children)
  }
})

動態(tài)過渡

在 Vue 中即使是過渡也是數(shù)據(jù)驅(qū)動的珍坊！動態(tài)過渡最基本的例子是通過 name 特性來綁定動態(tài)值。

<transition v-bind:name="transitionName">
  <!-- ... -->
</transition>

當你想用 Vue 的過渡系統(tǒng)來定義的 CSS 過渡/動畫 在不同過渡間切換會非常有用正罢。

所有的過渡特性都是動態(tài)綁定阵漏。它不僅是簡單的特性，通過事件的鉤子函數(shù)方法腺怯，可以在獲取到相應上下文數(shù)據(jù)袱饭。這意味著，可以根據(jù)組件的狀態(tài)通過 JavaScript 過渡設置不同的過渡效果呛占。

<script src="https://cdnjs.cloudflare.com/ajax/libs/velocity/1.2.3/velocity.min.js"></script>
<div id="dynamic-fade-demo">
  Fade In: <input type="range" v-model="fadeInDuration" min="0" v-bind:max="maxFadeDuration">
  Fade Out: <input type="range" v-model="fadeOutDuration" min="0" v-bind:max="maxFadeDuration">
  <transition
    v-bind:css="false"
    v-on:before-enter="beforeEnter"
    v-on:enter="enter"
    v-on:leave="leave"
  >
    <p v-if="show">hello</p>
  </transition>
  <button v-on:click="stop = true">Stop it!</button>
</div>
new Vue({
  el: '#dynamic-fade-demo',
  data: {
    show: true,
    fadeInDuration: 1000,
    fadeOutDuration: 1000,
    maxFadeDuration: 1500,
    stop: false
  },
  mounted: function () {
    this.show = false
  },
  methods: {
    beforeEnter: function (el) {
      el.style.opacity = 0
    },
    enter: function (el, done) {
      var vm = this
      Velocity(el,
        { opacity: 1 },
        {
          duration: this.fadeInDuration,
          complete: function () {
            done()
            if (!vm.stop) vm.show = false
          }
        }
      )
    },
    leave: function (el, done) {
      var vm = this
      Velocity(el,
        { opacity: 0 },
        {
          duration: this.fadeOutDuration,
          complete: function () {
            done()
            vm.show = true
          }
        }
      )
    }
  }
})

最后虑乖，創(chuàng)建動態(tài)過渡的最終方案是組件通過接受 props 來動態(tài)修改之前的過渡。一句老話晾虑，唯一的限制是你的想象力疹味。

原文：[http://vuejs.org/guide/transitions.html]