vue總結 04過渡--進入/離開 列表過渡

進入/離開 & 列表過渡

概述

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

• 在 CSS 過渡和動畫中自動應用 class
• 能夠配合使用第三方 CSS 動畫庫，如 Animate.css
• 在過渡鉤子函數中使用 JavaScript 直接操做 DOM
• 能夠配合使用第三方 JavaScript 動畫庫，如 Velocity.js

在這裏，咱們只會講到進入、離開和列表的過渡，你也能夠看下一節的 管理過渡狀態。

單元素/組件的過渡

Vue 提供了 transition 的封裝組件，在下列情形中，能夠給任何元素和組件添加進入/離開過渡

• 條件渲染 (使用 v-if)
• 條件展現 (使用 v-show)
• 動態組件
• 組件根節點

這裏是一個典型的例子：

<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-to /* .fade-leave-active below version 2.1.8 */ { opacity: 0; }

Toggle

hello

當插入或刪除包含在 transition 組件中的元素時，Vue 將會作如下處理：

1. 自動嗅探目標元素是否應用了 CSS 過渡或動畫，若是是，在恰當的時機添加/刪除 CSS 類名。

2. 若是過渡組件提供了 JavaScript 鉤子函數，這些鉤子函數將在恰當的時機被調用。

3. 若是沒有找到 JavaScript 鉤子而且也沒有檢測到 CSS 過渡/動畫，DOM 操做 (插入/刪除) 在下一幀中當即執行。(注意：此指瀏覽器逐幀動畫機制，和 Vue 的 nextTick 概念不一樣)

過渡的類名

在進入/離開的過渡中，會有 6 個 class 切換。

1. v-enter：定義進入過渡的開始狀態。在元素被插入以前生效，在元素被插入以後的下一幀移除。

2. v-enter-active：定義進入過渡生效時的狀態。在整個進入過渡的階段中應用，在元素被插入以前生效，在過渡/動畫完成以後移除。這個類能夠被用來定義進入過渡的過程時間，延遲和曲線函數。

3. v-enter-to: 2.1.8版及以上 定義進入過渡的結束狀態。在元素被插入以後下一幀生效 (與此同時 v-enter 被移除)，在過渡/動畫完成以後移除。

4. v-leave: 定義離開過渡的開始狀態。在離開過渡被觸發時馬上生效，下一幀被移除。

5. v-leave-active：定義離開過渡生效時的狀態。在整個離開過渡的階段中應用，在離開過渡被觸發時馬上生效，在過渡/動畫完成以後移除。這個類能夠被用來定義離開過渡的過程時間，延遲和曲線函數。

6. v-leave-to: 2.1.8版及以上 定義離開過渡的結束狀態。在離開過渡被觸發以後下一幀生效 (與此同時 v-leave 被刪除)，在過渡/動畫完成以後移除。

對於這些在過渡中切換的類名來講，若是你使用一個沒有名字的 <transition>，則 v-是這些類名的默認前綴。若是你使用了 <transition 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 } })

/* 能夠設置不一樣的進入和離開動畫 */ /* 設置持續時間和動畫函數 */ .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-to /* .slide-fade-leave-active for below version 2.1.8 */ { transform: translateX(10px); opacity: 0; }

Toggle render

hello

CSS 動畫

CSS 動畫用法同 CSS 過渡，區別是在動畫中 v-enter 類名在節點插入 DOM 後不會當即刪除，而是在 animationend 事件觸發時刪除。

示例：(省略了兼容性前綴)

<div id="example-2"> <button @click="show = !show">Toggle show</button> <transition name="bounce"> <p v-if="show">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Mauris facilisis enim libero, at lacinia diam fermentum id. Pellentesque habitant morbi tristique senectus et netus.</p> </transition> </div>

new Vue({ el: '#example-2', data: { show: true } })

.bounce-enter-active { animation: bounce-in .5s; } .bounce-leave-active { animation: bounce-in .5s reverse; } @keyframes bounce-in { 0% { transform: scale(0); } 50% { transform: scale(1.5); } 100% { transform: scale(1); } }

Toggle show

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Mauris facilisis enim libero, at lacinia diam fermentum id. Pellentesque habitant morbi tristique senectus et netus.

自定義過渡的類名

咱們能夠經過如下特性來自定義過渡類名：

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

他們的優先級高於普通的類名，這對於 Vue 的過渡系統和其餘第三方 CSS 動畫庫，如 Animate.css 結合使用十分有用。

示例：

<link href="https://cdn.jsdelivr.net/npm/animate.css@3.5.1" 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 } })

Toggle render

hello

同時使用過渡和動畫

Vue 爲了知道過渡的完成，必須設置相應的事件監聽器。它能夠是 transitionend 或 animationend ，這取決於給元素應用的 CSS 規則。若是你使用其中任何一種，Vue 能自動識別類型並設置監聽。

可是，在一些場景中，你須要給同一個元素同時設置兩種過渡動效，好比 animation 很快的被觸發並完成了，而 transition 效果還沒結束。在這種狀況中，你就須要使用 type特性並設置 animation 或 transition 來明確聲明你須要 Vue 監聽的類型。

顯性的過渡持續時間

2.2.0 新增

在不少狀況下，Vue 能夠自動得出過渡效果的完成時機。默認狀況下，Vue 會等待其在過渡效果的根元素的第一個 transitionend 或 animationend 事件。然而也能夠不這樣設定——好比，咱們能夠擁有一個精心編排的一序列過渡效果，其中一些嵌套的內部元素相比於過渡效果的根元素有延遲的或更長的過渡效果。

在這種狀況下你能夠用 <transition> 組件上的 duration 屬性定製一個顯性的過渡持續時間 (以毫秒計)：

<transition :duration="1000">...</transition>

你也能夠定製進入和移出的持續時間：

<transition :duration="{ enter: 500, leave: 800 }">...</transition>

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) { // ... }, // 此回調函數是可選項的設置 // 與 CSS 結合時使用 enter: function (el, done) { // ... done() }, afterEnter: function (el) { // ... }, enterCancelled: function (el) { // ... }, // -------- // 離開時 // -------- beforeLeave: function (el) { // ... }, // 此回調函數是可選項的設置 // 與 CSS 結合時使用 leave: function (el, done) { // ... done() }, afterLeave: function (el) { // ... }, // leaveCancelled 只用於 v-show 中 leaveCancelled: function (el) { // ... } }

這些鉤子函數能夠結合 CSS transitions/animations 使用，也能夠單獨使用。

當只用 JavaScript 過渡的時候， 在 enter 和 leave 中，回調函數 done 是必須的 。不然，它們會被同步調用，過渡會當即完成。

推薦對於僅使用 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 el.style.transformOrigin = 'left' }, 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 }) } } })

Toggle

初始渲染的過渡

能夠經過 appear 特性設置節點在初始渲染的過渡

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

這裏默認和進入/離開過渡同樣，一樣也能夠自定義 CSS 類名。

<transition appear appear-class="custom-appear-class" appear-to-class="custom-appear-to-class" (2.1.8+) 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" v-on:appear-cancelled="customAppearCancelledHook" > <!-- ... --> </transition>

多個元素的過渡

咱們以後討論多個組件的過渡，對於原生標籤可使用 v-if/v-else 。最多見的多標籤過渡是一個列表和描述這個列表爲空消息的元素：

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

能夠這樣使用，可是有一點須要注意：

當有相同標籤名的元素切換時，須要經過 key 特性設置惟一的值來標記以讓 Vue 區分它們，不然 Vue 爲了效率只會替換相同標籤內部的內容。即便在技術上沒有必要，給在 <transition> 組件中的多個元素設置 key 是一個更好的實踐。

示例：

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

在一些場景中，也能夠經過給同一個元素的 key 特性設置不一樣的狀態來代替 v-if 和 v-else，上面的例子能夠重寫爲：

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

使用多個 v-if 的多個元素的過渡能夠重寫爲綁定了動態屬性的單個元素過渡。例如：

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

過渡模式

這裏還有一個問題，試着點擊下面的按鈕：

off

在 「on」 按鈕和 「off」 按鈕的過渡中，兩個按鈕都被重繪了，一個離開過渡的時候另外一個開始進入過渡。這是 <transition> 的默認行爲 - 進入和離開同時發生。

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

off

而後，咱們加上 translate 讓它們運動像滑動過渡：

off

同時生效的進入和離開的過渡不能知足全部要求，因此 Vue 提供了 過渡模式

• in-out：新元素先進行過渡，完成以後當前元素過渡離開。

• out-in：當前元素先進行過渡，完成以後新元素過渡進入。

用 out-in 重寫以前的開關按鈕過渡：

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

off

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

in-out 模式不是常常用到，但對於一些稍微不一樣的過渡效果仍是有用的。
將以前滑動淡出的例子結合：

off

很酷吧？

多個組件的過渡

多個組件的過渡簡單不少 - 咱們不須要使用 key 特性。相反，咱們只須要使用動態組件：

<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-to /* .component-fade-leave-active for below version 2.1.8 */ { opacity: 0; }

A B

Component A

列表過渡

目前爲止，關於過渡咱們已經講到：

• 單個節點
• 同一時間渲染多個節點中的一個

那麼怎麼同時渲染整個列表，好比使用 v-for ？在這種場景中，使用 <transition-group> 組件。在咱們深刻例子以前，先了解關於這個組件的幾個特色：

• 不一樣於 <transition>，它會以一個真實元素呈現：默認爲一個 <span>。你也能夠經過 tag 特性更換爲其餘元素。
• 內部元素 老是須要 提供惟一的 key 屬性值

列表的進入/離開過渡

如今讓咱們由一個簡單的例子深刻，進入和離開的過渡使用以前同樣的 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-to /* .list-leave-active for below version 2.1.8 */ { opacity: 0; transform: translateY(30px); }

Add Remove

123456789

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

列表的排序過渡

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

Shuffle

 

這個看起來很神奇，內部的實現，Vue 使用了一個叫 FLIP 簡單的動畫隊列
使用 transforms 將元素從以前的位置平滑過渡新的位置。

咱們將以前實現的例子和這個技術結合，使咱們列表的一切變更都會有動畫過渡。

<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-to /* .list-complete-leave-active for below version 2.1.8 */ { opacity: 0; transform: translateY(30px); } .list-complete-leave-active { position: absolute; }

Shuffle Add Remove

123456789

須要注意的是使用 FLIP 過渡的元素不能設置爲 display: inline 。做爲替代方案，能夠設置爲 display: inline-block 或者放置於 flex 中

FLIP 動畫不只能夠實現單列過渡，多維網格也一樣能夠過渡：

Lazy Sudoku

Keep hitting the shuffle button until you win.

Shuffle

 

列表的交錯過渡

經過 data 屬性與 JavaScript 通訊 ，就能夠實現列表的交錯過渡：

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

• Bruce Lee
• Jackie Chan
• Chuck Norris
• Jet Li
• Kung Fury

可複用的過渡

過渡能夠經過 Vue 的組件系統實現複用。要建立一個可複用過渡組件，你須要作的就是將 <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) { // ... } } })

函數組件更適合完成這個任務：

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

動態過渡

在 Vue 中即便是過渡也是數據驅動的！動態過渡最基本的例子是經過 name 特性來綁定動態值。

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

當你想用 Vue 的過渡系統來定義的 CSS 過渡/動畫 在不一樣過渡間切換會很是有用。

全部的過渡特性都是動態綁定。它不只是簡單的特性，經過事件的鉤子函數方法，能夠在獲取到相應上下文數據。這意味着，能夠根據組件的狀態經過 JavaScript 過渡設置不一樣的過渡效果。

<script src="https://cdnjs.cloudflare.com/ajax/libs/velocity/1.2.3/velocity.min.js"></script> <div id="dynamic-fade-demo" class="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-if="stop" v-on:click="stop = false; show = false" >Start animating</button> <button v-else 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: true }, 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 } } ) } } })

Fade In:  Fade Out: 

hello

Start animating

最後，建立動態過渡的最終方案是組件經過接受 props 來動態修改以前的過渡。一句老話，惟一的限制是你的想象力。