本文主要介绍Vue3中的内置组件(transition)的普通写法和setup写法。
目录
- 一、在普通写法中使用内置组件(transition)
- 二、在setup写法中使用内置组件(transition)
- 三、使用注意项
在Vue3中,内置了一些组件,其中之一是<transition>
组件。<transition>
组件用于在元素插入或删除时,为其添加过渡效果。
在Vue2中,<transition>
组件使用name
属性来定义过渡效果的类名,然后使用CSS来实现具体的过渡效果。而在Vue3中,<transition>
组件使用了新的API来定义过渡效果。
一、在普通写法中使用内置组件(transition)
Vue3中<transition>
组件的用法如下:
<transition name="fade" mode="out-in"><div v-if="show" key="1">Content</div>
</transition>
在上面的代码中,<transition>
组件包裹了一个<div>
元素。当show
为true
时,<div>
元素会被插入到DOM中,并且在插入时会有一个淡入的过渡效果。当show
为false
时,<div>
元素会从DOM中删除,并且在删除时会有一个淡出的过渡效果。
在<transition>
组件中,可以设置以下属性来控制过渡效果:
name
:定义过渡效果的类名。Vue会自动为该类名添加前缀,例如-enter
、-leave
等。type
:定义过渡效果的类型,默认为transition
,可选值为transition
或animation
。mode
:定义过渡模式。有以下几种模式可选:in-out
:新元素先进行过渡,然后当前元素进行过渡。out-in
:当前元素先进行过渡,然后新元素进行过渡。
duration
:定义过渡的持续时间,可以是一个数字或一个对象,对象可以设置enter
、leave
和appear
三种状态的持续时间。appear
:是否在初始渲染时显示过渡效果,默认为false
。css
:是否使用CSS过渡,默认为true
。如果设置为false
,则需要手动编写过渡效果的JavaScript逻辑。onBeforeEnter
、onEnter
、onAfterEnter
、onBeforeLeave
、onLeave
、onAfterLeave
、onBeforeAppear
、onAppear
、onAfterAppear
:过渡的各个阶段的钩子函数。
在Vue3中,<transition>
组件的过渡效果可以通过新的API来自定义,例如使用<transition>
组件的<template v-slot:>
语法来自定义过渡效果的持续时间和钩子函数。
二、在setup写法中使用内置组件(transition)
在Vue3中,可以使用<script setup lang="ts">
来编写组件的逻辑部分,包括定义内置组件<transition>
的过渡效果。
下面是一个在<script setup lang="ts">
中使用<transition>
组件的示例:
<template><div><button @click="toggle">Toggle</button><transition name="fade" mode="out-in"><div v-if="show" key="1">Content</div></transition></div>
</template><script setup lang="ts">
import { ref } from 'vue'const show = ref(false)const toggle = () => {show.value = !show.value
}
</script>
在上面的代码中,我们首先使用import
语句导入了ref
函数。然后,在<script setup lang="ts">
中定义了一个名为show
的响应式变量,初始值为false
。接下来,我们定义了一个名为toggle
的函数,用于切换show
的值。在按钮的@click
事件中,我们调用了toggle
函数。
在<template>
部分,我们使用了<transition>
组件来包裹一个<div>
元素。当show
为true
时,<div>
元素会被插入到DOM中,并且在插入时会有一个淡入的过渡效果。当show
为false
时,<div>
元素会从DOM中删除,并且在删除时会有一个淡出的过渡效果。
通过使用<script setup lang="ts">
,我们可以在组件的逻辑部分直接使用响应式变量和方法,而无需在setup()
函数中显式地返回一个对象。这样可以让我们的代码更加简洁和易读。
三、使用注意项
在使用 Vue 3 中的内置组件 transition
时,有一些需要注意的地方:
-
导入
transition
组件:在 Vue 3 中,transition
组件已经被重命名为Transition
,所以在导入时需要使用import { Transition } from 'vue'
。 -
使用
Transition
组件:在 Vue 3 中,Transition
组件的使用方式与 Vue 2 有一些不同。首先,Transition
组件的标签名已经改为<transition>...</transition>
,而不再是<transition-group>...</transition-group>
。此外,Transition
组件的属性也有一些改变,例如name
属性改为name
或appear
、appear-from-class
、appear-to-class
等属性改为appear
、enter-from-class
、enter-to-class
等属性。 -
使用不同的过渡类名:在 Vue 3 中,过渡类名的生成方式也有所改变。以前,Vue 2 默认使用
v-
前缀加上过渡类型名称作为类名,例如v-enter
、v-leave-to
等。而在 Vue 3 中,使用了更加直观的类名,例如enter-active
、leave-active
等。这意味着在使用自定义过渡类名时,需要根据 Vue 3 的类名规则进行相应的修改。 -
使用
v-if
和v-show
:在 Vue 3 中,transition
组件不再支持与v-if
和v-show
一起使用。如果需要在组件动态切换时实现过渡效果,可以考虑使用transition
组件的appear
属性或Transition
组件的v-if
和v-else
。 -
使用
JSX
:如果在 Vue 3 中使用JSX
的方式来写模板代码,需要注意Transition
组件的使用方式与普通模板的略有不同。在JSX
中,需要使用v-slots
来定义过渡的内容,并且Transition
组件需要使用闭合标签<Transition></Transition>
。