Vue過渡與動畫

whjin發表於2018-01-21
Vue動畫

通過 Vue.js 的過渡系統，可以在元素從 DOM 中插入或移除時自動應用過渡效果。Vue.js 會在適當的時機為你觸發 CSS 過渡或動畫，你也可以提供相應的 JavaScript 鉤子函式在過渡過程中執行自定義的 DOM 操作。

為了應用過渡效果，需要在目標元素上使用 transition 特性：

<div v-if="show" transition="my-transition"></div>

transition 特性可以與下面資源一起用：

  • v-if
  • v-show
  • v-for （只在插入和刪除時觸發，使用 vue-animated-list 外掛）
  • 動態元件
  • 在元件的根節點上，並且被 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 過渡像這樣：

<div v-if="show" transition="expand">hello</div>

然後為 .expand-transition, .expand-enter 和 .expand-leave 新增 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;
}

你可以在同一元素上通過動態繫結實現不同的過渡：

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

過渡的 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 配合時會非常有用：

<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 類名：

  • 如果 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 例項。編譯規則：過渡在哪個上下文中編譯，它的 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 動畫用法同 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 過渡

也可以只使用 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)
 }
})

相關文章