Vue 在插入、更新或者移除 DOM 時(shí),提供多種不同方式的應(yīng)用過(guò)渡效果。包括以下工具:
在這里,我們只會(huì)講到進(jìn)入、離開(kāi)和列表的過(guò)渡, 你也可以看下一節(jié)的“管理過(guò)渡狀態(tài)”。
Vue 提供了 transition 的封裝組件,在下列情形中,可以給任何元素和組件添加 entering/leaving 過(guò)渡
這里是一個(gè)典型的例子:
<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
}
hello
元素封裝成過(guò)渡組件之后,在遇到插入或刪除時(shí),Vue 將
會(huì)有 4 個(gè)(CSS)類(lèi)名在 enter/leave 的過(guò)渡中切換
對(duì)于這些在 enter/leave 過(guò)渡中切換的類(lèi)名,v- 是這些類(lèi)名的前綴。使用 <name="my-transition>" 可以重置前綴,比如 v-enter 替換為 my-transition-enter。
v-enter-active 和 v-leave-active 可以控制 進(jìn)入/離開(kāi) 過(guò)渡的不同階段,在下面章節(jié)會(huì)有個(gè)示例說(shuō)明。
常用的過(guò)渡都是使用 CSS 過(guò)渡。
下面是一個(gè)簡(jiǎn)單例子:
<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
}
})
/* 可以設(shè)置不同的進(jìn)入和離開(kāi)動(dòng)畫(huà) */
/* 設(shè)置持續(xù)時(shí)間和動(dòng)畫(huà)函數(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;
}
hello
CSS 動(dòng)畫(huà)用法同 CSS 過(guò)渡,區(qū)別是在動(dòng)畫(huà)中 v-enter 類(lèi)名在節(jié)點(diǎn)插入 DOM 后不會(huì)立即刪除,而是在 animationend 事件觸發(fā)時(shí)刪除。
示例: (省略了兼容性前綴)
<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);
}
}
Look at me!
我們可以通過(guò)以下特性來(lái)自定義過(guò)渡類(lèi)名:
他們的優(yōu)先級(jí)高于普通的類(lèi)名,這對(duì)于 Vue 的過(guò)渡系統(tǒng)和其他第三方 CSS 動(dòng)畫(huà)庫(kù),如 Animate.css 結(jié)合使用十分有用。
示例:
<link rel="external nofollow" target="_blank" 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
}
})
hello
Vue 為了知道過(guò)渡的完成,必須設(shè)置相應(yīng)的事件監(jiān)聽(tīng)器。它可以是 transitionend 或 animationend ,這取決于給元素應(yīng)用的 CSS 規(guī)則。如果你使用其中任何一種,Vue 能自動(dòng)識(shí)別類(lèi)型并設(shè)置監(jiān)聽(tīng)。
但是,在一些場(chǎng)景中,你需要給同一個(gè)元素同時(shí)設(shè)置兩種過(guò)渡動(dòng)效,比如 animation 很快的被觸發(fā)并完成了,而 transition 效果還沒(méi)結(jié)束。在這種情況中,你就需要使用 type特性并設(shè)置 animation 或 transition 來(lái)明確聲明你需要 Vue 監(jiān)聽(tīng)的類(lèi)型。
可以在屬性中聲明 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>
這些鉤子函數(shù)可以結(jié)合 CSS transitions/animations
使用,也可以單獨(dú)使用。
當(dāng)只用 JavaScript 過(guò)渡的時(shí)候, 在 enter 和 leave 中,回調(diào)函數(shù) done 是必須的。 否則,它們會(huì)被同步調(diào)用,過(guò)渡會(huì)立即完成。
推薦對(duì)于僅使用 JavaScript 過(guò)渡的元素添加 v-bind:css="false",Vue 會(huì)跳過(guò) CSS 的檢測(cè)。這也可以避免過(guò)渡過(guò)程中 CSS 的影響。
一個(gè)使用 Velocity.js 的簡(jiǎn)單例子:
<!--
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" rel="external nofollow" rel="external nofollow" rel="external nofollow" ></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 })
}
}
})
可以通過(guò) appear 特性設(shè)置節(jié)點(diǎn)的在初始渲染的過(guò)渡:
<transition appear>
<!-- ... -->
</transition>
這里默認(rèn)和進(jìn)入和離開(kāi)過(guò)渡一樣,同樣也可以自定義 CSS 類(lèi)名。
<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>
我們?cè)诒菊轮笥懻摗岸鄠€(gè)組件的過(guò)渡”, 對(duì)于原生標(biāo)簽可以使用 v-if/v-else 。最常見(jiàn)的多標(biāo)簽過(guò)渡是一個(gè)列表和描述這個(gè)列表為空消息的元素:
<transition>
<table v-if="items.length > 0">
<!-- ... -->
</table>
<p v-else>Sorry, no items found.</p>
</transition>
可以這樣使用,但是有一點(diǎn)需要注意:
當(dāng)有相同標(biāo)簽名的元素切換時(shí),需要通過(guò) key 特性設(shè)置唯一的值來(lái)標(biāo)記以讓 Vue 區(qū)分它們,否則 Vue 為了效率只會(huì)替換相同標(biāo)簽內(nèi)部的內(nèi)容。即使在技術(shù)上沒(méi)有必要,給在<transition> 組件中的多個(gè)元素設(shè)置 key 是一個(gè)更好的實(shí)踐。
示例:
<transition>
<button v-if="isEditing" key="save">
Save
</button>
<button v-else key="edit">
Edit
</button>
</transition>
在一些場(chǎng)景中,也可以給通過(guò)給同一個(gè)元素的 key 特性設(shè)置不同的狀態(tài)來(lái)代替 v-if 和 v-else,上面的例子可以重寫(xiě)為:
<transition>
<button v-bind:key="isEditing">
{{ isEditing ? 'Save' : 'Edit' }}
</button>
</transition>
使用多個(gè) v-if 的多個(gè)元素的過(guò)渡可以重寫(xiě)為綁定了動(dòng)態(tài)屬性的單個(gè)元素過(guò)渡。 例如:
<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>
可以重寫(xiě)為:
<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'
}
}
}
這里還有一個(gè)問(wèn)題,試著點(diǎn)擊下面的按鈕:
在 “on” 按鈕和 “off” 按鈕的過(guò)渡中,兩個(gè)按鈕都被重繪了,一個(gè)離開(kāi)過(guò)渡的時(shí)候另一個(gè)開(kāi)始進(jìn)入過(guò)渡。這是 <transition> 的默認(rèn)行為 - 進(jìn)入和離開(kāi)同時(shí)發(fā)生。
在元素絕對(duì)定位在彼此之上的時(shí)候運(yùn)行正常:
然后,我們加上 translate 讓它們運(yùn)動(dòng)像滑動(dòng)過(guò)渡:
同時(shí)生效的進(jìn)入和離開(kāi)的過(guò)渡不能滿足所有要求,所以 Vue 提供了過(guò)渡模式
用 out-in 重寫(xiě)之前的開(kāi)關(guān)按鈕過(guò)渡:
<transition name="fade" mode="out-in">
<!-- ... the buttons ... -->
</transition>
只用添加一個(gè)簡(jiǎn)單的特性,就解決了之前的過(guò)渡問(wèn)題而無(wú)需任何額外的代碼。
in-out 模式不是經(jīng)常用到,但對(duì)于一些稍微不同的過(guò)渡效果還是有用的。將之前滑動(dòng)淡出的例子結(jié)合:
很酷吧?
多個(gè)組件的過(guò)渡很簡(jiǎn)單很多 - 我們不需要使用 key 特性。相反,我們只需要使用動(dòng)態(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>'
}
}
})
目前為止,關(guān)于過(guò)渡我們已經(jīng)講到:
那么怎么同時(shí)渲染整個(gè)列表,比如使用 v-for ?在這種場(chǎng)景中,使用<transition-group> 組件。在我們深入例子之前,先了解關(guān)于這個(gè)組件的幾個(gè)特點(diǎn):
現(xiàn)在讓我們由一個(gè)簡(jiǎn)單的例子深入,進(jìn)入和離開(kāi)的過(guò)渡使用之前一樣的 CSS 類(lèi)名。
<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);
}
結(jié)果:
123456789
這個(gè)例子有個(gè)問(wèn)題,當(dāng)添加和移除元素的時(shí)候,周?chē)脑貢?huì)瞬間移動(dòng)到他們的新布局的位置,而不是平滑的過(guò)渡,我們下面會(huì)解決這個(gè)問(wèn)題。
<transition-group> 組件還有一個(gè)特殊之處。不僅可以進(jìn)入和離開(kāi)動(dòng)畫(huà),還可以改變定位。要使用這個(gè)新功能只需了解新增的 v-move 特性,它會(huì)在元素的改變定位的過(guò)程中應(yīng)用。像之前的類(lèi)名一樣,可以通過(guò) name 屬性來(lái)自定義前綴,也可以通過(guò) move-class 屬性手動(dòng)設(shè)置。
v-move 對(duì)于設(shè)置過(guò)渡的切換時(shí)機(jī)和過(guò)渡曲線非常有用,你會(huì)看到如下的例子:
<script src="https://cdnjs.cloudflare.com/ajax/libs/lodash.js/4.14.1/lodash.min.js" rel="external nofollow" rel="external nofollow" ></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;
}
這個(gè)看起來(lái)很神奇,內(nèi)部的實(shí)現(xiàn),Vue 使用了一個(gè)叫 FLIP 簡(jiǎn)單的動(dòng)畫(huà)隊(duì)列使用 transforms 將元素從之前的位置平滑過(guò)渡新的位置。
我們將之前實(shí)現(xiàn)的例子和這個(gè)技術(shù)結(jié)合,使我們列表的一切變動(dòng)都會(huì)有動(dòng)畫(huà)過(guò)渡。
<script src="https://cdnjs.cloudflare.com/ajax/libs/lodash.js/4.14.1/lodash.min.js" rel="external nofollow" rel="external nofollow" ></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;
}
結(jié)果:
123456789
需要注意的是使用 FLIP 過(guò)渡的元素不能設(shè)置為 display: inline 。作為替代方案,可以設(shè)置為 display: inline-block 或者放置于 flex 中。
FLIP 動(dòng)畫(huà)不僅可以實(shí)現(xiàn)單列過(guò)渡,多維網(wǎng)格的過(guò)渡也同樣簡(jiǎn)單
通過(guò) data 屬性與 JavaScript 通信 ,就可以實(shí)現(xiàn)列表的漸進(jìn)過(guò)渡:
<script src="https://cdnjs.cloudflare.com/ajax/libs/velocity/1.2.3/velocity.min.js" rel="external nofollow" rel="external nofollow" rel="external nofollow" ></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)
}
}
})
結(jié)果:
過(guò)渡可以通過(guò) Vue 的組件系統(tǒng)實(shí)現(xiàn)復(fù)用。要?jiǎng)?chuàng)建一個(gè)可復(fù)用過(guò)渡組件,你需要做的就是將 <transition> 或者 <transition-group> 作為根組件,然后將任何子組件放置在其中就可以了。
使用 template 的簡(jiǎn)單例子:
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ù)組件更適合完成這個(gè)任務(wù):
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 中即使是過(guò)渡也是數(shù)據(jù)驅(qū)動(dòng)的!動(dòng)態(tài)過(guò)渡最基本的例子是通過(guò) name 特性來(lái)綁定動(dòng)態(tài)值。
<transition v-bind:name="transitionName">
<!-- ... -->
</transition>
當(dāng)你想用 Vue 的過(guò)渡系統(tǒng)來(lái)定義的 CSS 過(guò)渡/動(dòng)畫(huà) 在不同過(guò)渡間切換會(huì)非常有用。
所有的過(guò)渡特性都是動(dòng)態(tài)綁定。它不僅是簡(jiǎn)單的特性,通過(guò)事件的鉤子函數(shù)方法,可以在獲取到相應(yīng)上下文數(shù)據(jù)。這意味著,可以根據(jù)組件的狀態(tài)通過(guò) JavaScript 過(guò)渡設(shè)置不同的過(guò)渡效果。
<script src="https://cdnjs.cloudflare.com/ajax/libs/velocity/1.2.3/velocity.min.js" rel="external nofollow" rel="external nofollow" rel="external nofollow" ></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
}
}
)
}
}
})
結(jié)果:
hello
更多建議: