Vue过渡&动画&列表渲染

1,159 阅读9分钟

Vue过渡&动画&列表渲染

Vue提供了一些组件,在满足某些条件的情况下,让开发者能给任何元素或者是组件的进入与退出添加过渡/动画效果,来优化用户的交互。

  • 条件渲染(v-if),通过控制是否渲染元素到html结构
  • 条件展示(v-show),通过控制css样式中的display
  • 动态组件
  • 组件根节点

在了解这些知识前,应该先去了解一下transition这个Vue的内置组件的一些attribute与钩子。

单元素/组件的过渡与动画

Vue新增的相关的类名

在元素的进入/退出的过渡中,Vue将这整个过程分为了6个阶段,并为这6个阶段添加了特定的CSS类名:

  • v-enter:定义元素进入过渡的开始状态,即第一帧的状态。在元素被插入前生效,在元素被插入后的下一帧删除。
  • v-enter-active:定义元素的整个进入过渡/动画生效时的状态,在元素被插入时生效,在整个过渡/动画完成后移除。这个类一般被用于定义进入过渡/动画的过程时间,延迟和曲线函数。 在这个类中常设置:transitionanimation 这2个属性。
  • v-enter-to:定义元素被插入后状态,v-enter被移除时插入,在过渡/动画完成后移除。一般来说不会设置这个类,而直接使用元素自身的样式代替。
  • v-leave:定义离开过渡的开始状态。在离开过渡被触发时立刻生效,下一帧被移除。一般来说不会设置这个类,而直接使用元素自身的样式代替。
  • v-leave-active:和v-enter-active的效果相同,但是定义的是离开过渡/动画生效时的状态。在这个类中常设置:transitionanimation 这2个属性。
  • v-leave-to:定义离开过渡的结束状态。在离开过渡被触发之后下一帧生效 (与此同时 v-leave被删除),在过渡/动画完成之后移除。

这些类名的前缀v-是可以改变的,这就可以让一个页面存在多个不同的过渡/动画效果。

在后面的示例中,我们了解到,Vue提供了一个<transition>组件用于包裹需要添加过渡/动画效果的元素。

如果我们使用一个没有name属性的<transition>,那么这个<transition>包裹的元素的动画效果将由默认前缀v-的类名决定,即上面6个类名。

如果我们给<transition>设置了<name>属性,如:<transition name="my-transition">,那么那么这个<transition>包裹的元素的动画效果将由前缀为my-transition-的类名决定,如:my-transition-entermy-transition-enter-to等。

CSS过渡

下面是一个简单的Vue的CSS过渡的例子。为什么叫CSS过渡?因为我们所定义的过渡动画的效果都是由上面所提及的6个CSS类名所定义的。因此叫CSS过渡。

<!-- html -->
<div id="example-1">
  <button @click="show = !show">
    Toggle render
  </button>
  <!-- 这里name="slide-fade",在css中也可看到类名的前缀是slide-fade -->
  <transition name="slide-fade">
    <p v-if="show">hello</p>
  </transition>
</div>
// js
new Vue({
  el: '#example-1',
  data: {
    show: true
  }
})
/* css */
/* 可以设置不同的进入和离开动画 */
/* 设置持续时间和动画函数 */
.slide-fade-enter-active {
  /* 过渡用transition定义整个过渡的过程的效果 */
  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;
}

CSS动画

跟CSS过渡一样,通过CSS控制动画的效果,所以叫CSS动画。CSS动画一般只会使用上面6个类名中的:v-enter-activev-leave-active,并在这2个类中声明animation样式。其他4个类名所定义的状态都会被定义在keyframes中。

<!-- html -->
<div id="example-2">
  <button @click="show = !show">Toggle show</button>
  <transition name="bounce">
    <p v-if="show">Lorem ipsum dolor sit amet</p>
  </transition>
</div>
// js
new Vue({
  el: '#example-2',
  data: {
    show: true
  }
})
/* css */
/* transition组件的name="bounce" */
.bounce-enter-active {
  /* animation样式定义动画使用的keyframes以及其他效果 */
  animation: bounce-in .5s;
}
.bounce-leave-active {
  animation: bounce-in .5s reverse;
}
/* 动画的4个点状态都被声明在keyframes中 */
@keyframes bounce-in {
  0% {
    transform: scale(0);
  }
  50% {
    transform: scale(1.5);
  }
  100% {
    transform: scale(1);
  }
}

注意:CSS过渡和CSS动画能够同时使用,但是不建议同时使用,因为在某些场景会出现BUG。

自定义过渡的类名

有时候我们希望不使用上面所提供的6个类名来定义CSS样式。比如在使用第三方CSS库的时候,它们为我们提供类名,那么要怎么操作呢?

我们可以通过以下<transition>的attribute来自定义过渡域名,他们的优先级高于普通的类名 。

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

这样我们就能轻松使用第三方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>的一些attribute可以自定义使用域名 -->
  <!-- 这样我们就能轻松配合第三方CSS库使用了 -->
  <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
  }
})

用JS控制动画

除了使用CSS的样式控制动画,我们还能够使用Vue提供的几个钩子(事件)来控制动画。

<!-- 可以通过v-on来监听这些钩子 -->
<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>

这些钩子可以与CSS的过渡/动画结合使用,也可以单独使用。

在仅使用JS控制动画时,在enter和leave钩子的事件函数中必须传入一个函数进行回调,否则这俩钩子将会同步调用,过渡会立即完成。

而且当仅使用JS控制动画时,推荐给过渡的元素的<transition>添加v-bind:css="false"来跳过CSS的检测,同时也能避免CSS的影响。

下面是Vue结合JS动画库Velocity.js实现过渡的简单实例:

<!-- html -->
<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来定义动画效果
      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 })
    }
  }
})

多元素的过渡

多元素的过渡和单元素的大致相同,但有些需要注意的点:

当有相同标签名的元素切换时,需要通过 key attribute 设置唯一的值来标记以让 Vue 区分它们,否则 Vue 为了效率只会替换相同标签内部的内容。即使在技术上没有必要,给在 <transition> 组件中的多个元素设置 key 是一个更好的实践。

<transition>
  <!-- 绑定key来区分2个button -->
  <button v-if="isEditing" key="save">
    Save
  </button>
  <button v-else key="edit">
    Edit
  </button>
</transition>

过渡模式

过渡模式一般在多元素/组件的过渡中才会出现,因为此时涉及到页面元素占位的问题。Vue提供了2个过渡模式:

  • in-out:新元素先进行过渡,完成之后当前元素过渡离开。
  • out-in:当前元素先进行过渡,完成之后新元素过渡进入。

实例:<transition name="fade" mode="out-in"> </transition>

多组件过渡

比起多元素过渡,多组件过渡不需要绑定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 {
  opacity: 0;
}

列表过渡

列表过渡使用的不是<transition>组件而是<transition-group>组件。

<transition>不同的是,<transition-group>组件最后会以一个真实的DOM元素呈现,默认是一个<span>元素。我们可以给<transition-group>添加tag attribute来更换这个元素类型,如:<transition-group tag="div"> 这样<transition-group>最后就会以一个 div 元素呈现。

<transition-group>内容渲染的列表必须以 v-for的形式渲染,而且每个元素都要有一个唯一:key

虽然列表过渡很像是多元素的过渡,但是我们实际上没有切换元素,一般来说只有in或者只有out。

<transition-group>的attribute和<transition>类似,也有name attribute ,在使用CSS过渡来实现过渡时,这些CSS样式都只会作用于<transition-group>的内部列表元素,不会对<transition-group>造成影响。

下面是一个列表进入/离开的过渡实例:

<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 {
  opacity: 0;
  transform: translateY(30px);
}