transition 與 v-for 一起使用時,可以做出「漸進過渡」的效果,讓列表項目不是同時出現,而是依序錯開進場。
在過渡元素上加一個 stagger、enter-stagger 或 leave-stagger 特性:
<div v-for="item in list" transition="stagger" stagger="100"></div>
若想更精細地控制每個項目的延遲,可以改用鉤子:
Vue.transition('stagger', {
stagger: function (index) {
// 每個過渡項目增加 50ms 延時,但最大延時限制為 300ms
return Math.min(300, index * 50)
}
})
加上 Math.min 這道限制是個實務上的好習慣:如果列表有幾十項,單純線性遞增會讓最後一項等上數秒,加上上限後整段動畫的總長就可控了。
HTML:
<div id="demo">
<input v-model="query">
<ul>
<li v-for="item in list | filterBy query" transition="staggered" stagger="100">
{{item.msg}}
</li>
</ul>
</div>
JS:
new Vue({
el: '#demo',
data: {
query: '',
list: [
{ msg: 'Bruce Lee' },
{ msg: 'Jackie Chan' },
{ msg: 'Chuck Norris' },
{ msg: 'Jet Li' },
{ msg: 'Kung Fury' }
]
}
})
CSS:
ul {
padding-left: 0;
font-family: Helvetica, Arial, sans-serif;
}
.staggered-transition {
transition: all .5s ease;
overflow: hidden;
margin: 0;
height: 20px;
}
.staggered-enter, .staggered-leave {
opacity: 0;
height: 0;
}
效果如下圖:

在輸入框打字時,filterBy 過濾器會過濾出符合的項目,Vue 對新增與移除的項目分別套用進入與離開的類別(.staggered-enter 與 .staggered-leave),再依 stagger 指定的毫秒數逐項錯開觸發。所以你在 CSS 裡宣告的 opacity: 0 與 height: 0,就是項目進場前的初始狀態,過渡到正常值時就產生了淡入展開的效果。
另外要留意,transition 屬性與過渡類別的命名規則都是 Vue 1.x 的寫法;在 Vue 2 之後改為 <transition-group> 元件搭配 CSS 類別 v-enter/v-leave,延遲則改用 transition-delay 或 JS 鉤子控制。概念一致,但語法請依你的版本調整。