通過 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) } })
本文已被整理到了《Vue.js前端組件學習教程》,歡迎大家學習閱讀。
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持。