---
title: 過渡
type: guide
order: 11
---
通過 Vue.js 的過渡系統，可以在元素從 DOM 中插入或移除時自動應用過渡效果。Vue.js 會在適當的時機為你觸發 CSS 過渡或動畫，你也可以提供相應的 JavaScript 鉤子函數在過渡過程中執行自定義的 DOM 操作。
為了應用過渡效果，需要在目標元素上使用 `transition` 特性：
``` html
<div v-if="show" transition="my-transition"></div>
```
`transition` 特性可以與下面資源一起用：
- `v-if`
- `v-show`
- `v-for` （只為插入和刪除觸發）
- 動態組件 （介紹見[組件](components.html#動態組件)）
- 在組件的根節點上，并且被 Vue 實例 DOM 方法（如 `vm.$appendTo(el)`）觸發。
當插入或刪除帶有過渡的元素時，Vue 將：
1. 嘗試以 ID `"my-transition"` 查找 JavaScript 過渡鉤子對象——通過 `Vue.transition(id, hooks)` 或 `transitions` 選項注冊。如果找到了，將在過渡的不同階段調用相應的鉤子。
2. 自動嗅探目標元素是否有 CSS 過渡或動畫，并在合適時添加/刪除 CSS 類名。
3. 如果沒有找到 JavaScript 鉤子并且也沒有檢測到 CSS 過渡/動畫，DOM 操作（插入/刪除）在下一幀中立即執行。
## CSS 過渡
### 示例
典型的 CSS 過渡像這樣：
``` html
<div v-if="show" transition="expand">hello</div>
```
然后為 `.expand-transition`, `.expand-enter` 和 `.expand-leave` 添加 CSS 規則:
``` 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;
}
```
另外，可以提供 JavaScript 鉤子:
``` js
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
}
})
```
{% raw %}
<div id="demo">
<div v-if="show" transition="expand">hello</div>
<button @click="show = !show">Toggle</button>
</div>
<style>
.expand-transition {
transition: all .3s ease;
height: 30px;
padding: 10px;
background-color: #eee;
overflow: hidden;
}
.expand-enter, .expand-leave {
height: 0;
padding: 0 10px;
opacity: 0;
}
</style>
<script>
new Vue({
el: '#demo',
data: {
show: true,
transitionState: 'Idle'
},
transitions: {
expand: {
beforeEnter: function (el) {
el.textContent = 'beforeEnter'
},
enter: function (el) {
el.textContent = 'enter'
},
afterEnter: function (el) {
el.textContent = 'afterEnter'
},
beforeLeave: function (el) {
el.textContent = 'beforeLeave'
},
leave: function (el) {
el.textContent = 'leave'
},
afterLeave: function (el) {
el.textContent = 'afterLeave'
}
}
}
})
</script>
{% endraw %}
### 過渡的 CSS 類名
類名的添加和切換取決于 `transition` 特性的值。比如 `transition="fade"`，會有三個 CSS 類名：
1. `.fade-transition` 始終保留在元素上。
2. `.fade-enter` 定義進入過渡的開始狀態。只應用一幀然后立即刪除。
3. `.fade-leave` 定義離開過渡的結束狀態。在離開過渡開始時生效，在它結束后刪除。
如果 `transition` 特性沒有值，類名默認是 `.v-transition`, `.v-enter` 和 `.v-leave`。
### 自定義過渡類名
> 1.0.14 新增
我們可以在過渡的 JavaScript 定義中聲明自定義的 CSS 過渡類名。這些自定義類名會覆蓋默認的類名。當需要和第三方的 CSS 動畫庫，比如 [Animate.css](https://daneden.github.io/animate.css/) 配合時會非常有用：
``` html
<div v-show="ok" class="animated" transition="bounce">Watch me bounce</div>
```
``` js
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`)：
``` js
Vue.transition('bounce', {
// 該過渡效果將只偵聽 `animationend` 事件
type: 'animation'
})
```
### 過渡流程詳解
當 `show` 屬性改變時，Vue.js 將相應地插入或刪除 `<div>` 元素，按照如下規則改變過渡的 CSS 類名：
- 如果 `show` 變為 false，Vue.js 將：
1. 調用 `beforeLeave` 鉤子；
2. 添加 `v-leave` 類名到元素上以觸發過渡；
3. 調用 `leave` 鉤子；
4. 等待過渡結束（監聽 `transitionend` 事件）；
5. 從 DOM 中刪除元素并刪除 `v-leave` 類名；
6. 調用 `afterLeave` 鉤子。
- 如果 `show` 變為 true，Vue.js 將：
1. 調用 `beforeEnter` 鉤子；
2. 添加 `v-enter` 類名到元素上；
3. 把它插入 DOM；
4. 調用 `enter` 鉤子；
5. 強制一次 CSS 布局，讓 `v-enter` 確實生效。然后刪除 `v-enter` 類名，以觸發過渡，回到元素的原始狀態；
6. 等待過渡結束；
7. 調用 `afterEnter` 鉤子。
另外，如果在它的進入過渡還在進行中時刪除元素，將調用 `enterCancelled` 鉤子，以清理變動或 `enter` 創建的計時器。反過來對于離開過渡亦如是。
上面所有的鉤子函數在調用時，它們的 `this` 均指向所屬的 Vue 實例。如果元素是 Vue 實例的根節點，則這個實例是上下文。否則，上下文是過渡指令所屬的實例。
最后，`enter` 和 `leave` 可以有第二個可選的回調參數，用于顯式控制過渡如何結束。因此不必等待 CSS `transitionend` 事件， Vue.js 將等待你手工調用這個回調，以結束過渡。例如：
``` js
enter: function (el) {
// 沒有第二個參數
// 由 CSS transitionend 事件決定過渡何時結束
}
```
vs.
``` js
enter: function (el, done) {
// 有第二個參數
// 過渡只有在調用 `done` 時結束
}
```
<p class="tip">當多個元素一起過渡時，Vue.js 會批量處理，只強制一次布局。</p>
### CSS 動畫
CSS 動畫用法同 CSS 過渡，區別是在動畫中 `v-enter` 類名在節點插入 DOM 后不會立即刪除，而是在 `animationend` 事件觸發時刪除。
示例： (省略了兼容性前綴)
``` html
<span v-show="show" transition="bounce">Look at me!</span>
```
``` css
.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);
}
}
```
{% raw %}
<div id="anim" class="demo">
<span v-show="show" transition="bounce">Look at me!</span>
<br>
<button @click="show = !show">Toggle</button>
</div>
<style>
.bounce-enter {
-webkit-animation: bounce-in .5s;
animation: bounce-in .5s;
}
.bounce-leave {
-webkit-animation: bounce-out .5s;
animation: bounce-out .5s;
}
@keyframes bounce-in {
0% {
transform: scale(0);
-webkit-transform: scale(0);
}
50% {
transform: scale(1.5);
-webkit-transform: scale(1.5);
}
100% {
transform: scale(1);
-webkit-transform: scale(1);
}
}
@keyframes bounce-out {
0% {
transform: scale(1);
-webkit-transform: scale(1);
}
50% {
transform: scale(1.5);
-webkit-transform: scale(1.5);
}
100% {
transform: scale(0);
-webkit-transform: scale(0);
}
}
@-webkit-keyframes bounce-in {
0% {
-webkit-transform: scale(0);
}
50% {
-webkit-transform: scale(1.5);
}
100% {
-webkit-transform: scale(1);
}
}
@-webkit-keyframes bounce-out {
0% {
-webkit-transform: scale(1);
}
50% {
-webkit-transform: scale(1.5);
}
100% {
-webkit-transform: scale(0);
}
}
</style>
<script>
new Vue({
el: '#anim',
data: { show: true }
})
</script>
{% endraw %}
## JavaScript 過渡
也可以只使用 JavaScript 鉤子，不用定義任何 CSS 規則。當只使用 JavaScript 過渡時，**`enter` 和 `leave` 鉤子需要調用 `done` 回調**，否則它們將被同步調用，過渡將立即結束。
為 JavaScript 過渡顯式聲明 `css: false` 是個好主意，Vue.js 將跳過 CSS 檢測。這樣也會阻止無意間讓 CSS 規則干擾過渡。
在下例中我們使用 jQuery 注冊一個自定義的 JavaScript 過渡：
``` js
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` 特性中：
``` html
<p transition="fade"></p>
```
## 漸近過渡
`transition` 與 `v-for` 一起用時可以創建漸近過渡。給過渡元素添加一個特性 `stagger`, `enter-stagger` 或 `leave-stagger`：
``` html
<div v-for="list" transition stagger="100"></div>
```
或者，提供一個鉤子 `stagger`, `enter-stagger` 或 `leave-stagger`，以更好的控制：
``` js
Vue.transition('stagger', {
stagger: function (index) {
// 每個過渡項目增加 50ms 延時
// 但是最大延時限制為 300ms
return Math.min(300, index * 50)
}
})
```
示例：
<iframe width="100%" height="200" style="margin-left:10px" src="http://jsfiddle.net/yyx990803/mvo99bse/embedded/result,html,js,css" allowfullscreen="allowfullscreen" frameborder="0"></iframe>
- vue
- 官方教程
- 起步
- 安裝
- 概述
- Vue 實例
- Class 與 Style 綁定
- 數據綁定語法
- 條件渲染
- 列表渲染
- 表單控件綁定
- 組件
- 計算屬性
- 自定義指令
- 自定義過濾器
- 方法與事件處理器
- 混合
- 插件
- 過渡
- 深入響應式原理
- 對比其它框架
- 構建大型應用
- API
- vue-router
- 安裝
- 基本用法
- 嵌套路由
- 路由對象和路由匹配
- 具名路徑
- 路由配置項
- router-view
- v-link
- 切換控制流水線
- 切換鉤子函數
- data
- activate
- deactivate
- canActivate
- canDeactivate
- canReuse
- API
- 路由實例屬性
- router.start
- router.stop
- router.map
- router.on
- router.go
- router.replace
- router.redirect
- router.alias
- router.beforeEach
- router.afterEach
- 文章
- VUE.JS: A (RE)INTRODUCTION
- 源碼
- 表單控件綁定