Vue封装了一套可以快速构建基于状态变化的过渡和过度与动画的组件<transition><Transition>)和<transition-group><TransitionGroup>)。

<transition><transition-group>是Vue内置的组件,无需注册即可使用。它们可以将进入和离开的动画应用到通过默认插槽传递给它的元素或组件上。

它们的进入/离开动画的切换可以由v-ifv-show所触发。


Transition 组件

<transition>用于在一个元素或组件进入和离开DOM时应用动画。

最基本的用法如下:

 1<template>
 2<div>
 3  <button @click="isShow = !isShow">显示/隐藏</button>
 4  <!-- 
 5    <transition> 用于给元素自动加上动画效果
 6   -->
 7  <transition>
 8    <h1 v-show="isShow">Hello Vue.js!</h1>
 9  </transition>
10</div>
11</template>
12
13<script>
14export default {
15  name: 'Hello',
16  data() {
17    return {
18      isShow: true,
19    }
20  },
21}
22</script>
23
24<style scoped>
25h1 {
26  background-color: orange;
27}
28
29.v-enter-active {
30  animation: fade 1s linear;
31}
32
33.v-leave-active {
34  animation: fade 1s linear reverse;
35}
36
37@keyframes fade {
38  from {
39    transform: translateX(-100%);
40  }
41  to {
42    transform: translateX(0px);
43  }
44}
45</style>

<transition>中的元素被显示或隐藏时,Vue会在适当的时机自动将一些CSS过渡class往目标元素上添加或移除。

<transition>仅支持单个元素或组件作为其插槽内容。如果内容是一个组件,该组件必须仅有一个根元素。


CSS 过渡 class

Vue中一共有6种应用于进入与离开过度效果的 CSS class

Vue2的CSS过渡class

Vue2 CSS 过渡 class

Vue3的CSS过渡class

Vue3 CSS 过渡 class

  • v-enter(Vue2)/ v-enter-from(Vue3):进入动画的起始状态。在元素插入之前添加,在元素插入完成后的下一帧移除。
  • v-enter-active:进入动画的生效状态。应用于整个进入动画阶段。在元素被插入之前添加,在过渡或动画完成之后移除。这个class可以被用来定义进入动画的持续时间、延迟与速度曲线类型。
  • v-enter-to2.1.8版及以上):进入动画的结束状态。在元素插入完成后的下一帧被添加 (也就是v-enter-from被移除的同时),在过渡或动画完成之后移除。
  • v-leave(Vue2)/ v-leave-from(Vue3):离开动画的起始状态。在离开过渡效果被触发时立即添加,在一帧后被移除。
  • v-leave-active:离开动画的生效状态。应用于整个离开动画阶段。在离开过渡效果被触发时立即添加,在过渡或动画完成之后移除。这个class可以被用来定义离开动画的持续时间、延迟与速度曲线类型。
  • v-leave-to2.1.8版及以上):离开动画的结束状态。在一个离开动画被触发后的下一帧被添加 (也就是v-leave-from被移除的同时),在过渡或动画完成之后移除。

注:Vue3将过渡类名v-enter修改为v-enter-from,将过渡类名v-leave修改为v-leave-from


过度效果命名

<transition><transition-group>有一个名为nameprop,它可以为过渡效果命名,并将该名称作用于其一系列CSS过渡class的名称前缀。

例如:

1<transition name="fade">
2  <!-- ... -->
3</transition>

那么其一系列的CSS过渡class的名称如下:

 1/* 进入的起点 和 离开的终点 */
 2.fade-enter /* 或 .fade-enter-from */,
 3.fade-leave-to {
 4  transform: translateX(-100%);
 5}
 6
 7/* 进入 和 离开的过程 */
 8.fade-enter-active,
 9.fade-leave-active {
10  transition: 0.5s linear;
11}
12
13/* 进入的终点 和 离开的起点 */
14.fade-enter-to,
15.fade-leave /* 或 .fade-leave-from */ {
16  transform: translateX(0);
17}

自定义过渡 class

可以向<transition><transition-group>传递以下的props来指定自定义的过渡class

  • enter-class(Vue2)/ enter-from-class(Vue3):定义目标元素进入动画起点的过渡class
  • enter-active-class:定义目标元素进入动画过程的过渡class
  • enter-to-class2.1.8+):定义目标元素进入动画终点的过渡class
  • leave-class(Vue2)/ leave-from-class(Vue3):定义目标元素离开动画起点的过渡class
  • leave-active-class:定义目标元素离开动画过程的过渡class
  • leave-to-class2.1.8+):定义目标元素离开动画终点的过渡class

传入的这些class会覆盖相应阶段的默认class名。这个功能在Vue的动画机制下集成其他的第三方CSS动画库时非常有用。

例如使用animate.css

 1<template>
 2<div>
 3  <button @click="isShow = !isShow">显示/隐藏</button>
 4  <transition
 5    appear
 6    name="animate__animated animate__bounce"
 7    enter-active-class="animate__swing"
 8    leave-active-class="animate__backOutUp"
 9  >
10    <h1 v-show="!isShow">Hello Vue.js!</h1>
11  </transition>
12</div>
13</template>
14
15<script>
16import 'animate.css'
17
18export default {
19  name: 'Hello',
20  data() {
21    return {
22      isShow: true,
23    }
24  },
25}
26</script>
27
28<style scoped>
29h1 {
30  background-color: orange;
31}
32</style>

TransitionGroup 组件

<transition-group>支持和<transition>基本相同的props、CSS过渡class和JavaScript钩子监听器,但有以下几点区别:

  • 默认情况下,它不会渲染一个容器元素。但可以通过传入tag prop来指定一个元素作为容器元素来渲染。
  • 过渡模式在这里不可用,因为我们不再是在互斥的元素之间进行切换。
  • <transition-group>中渲染的每个元素都必须有一个唯一的key属性值。
  • CSS过渡class会被应用在列表内的元素上,而不是容器元素上。

<transition-group>用于同时渲染多个元素,通常情况下渲染的是列表元素。被<transition-group>渲染的每个元素都需要有一个我i唯一的key属性值。