过度动画 Transition

通过使用 transition 给元素添加进入、离开的动画效果。

使用

API

安装使用

import { TiTransition } from '@titian-design/mobile-vue';

用法示例

基本使用

演示

codesanbox

copy

code

<template>
  <TiButton @click="toggle(true)">演示</TiButton>
  <TiTransition :show="show" @entered="toggle(false)">
    <div class="transition-card" />
  </TiTransition>
</template>

<script lang="ts" setup>
import { ref } from 'vue';
import { TiTransition } from 'titian-h5-vue';

const show = ref(false);
const toggle = (s: boolean) => {
  show.value = s;
};
</script>

<style>
.transition-card {
  width: 40px;
  height: 40px;
  background-color: #fa2c19;
}
</style>

动画类型

fadefade downfade upfade leftfade rightslide downslide upslide leftslide rightzoom

codesanbox

copy

code

<template>
  <TiButton @click="handle('fade')">fade</TiButton>
  <TiButton @click="handle('fade-down')">fade down</TiButton>
  <TiButton @click="handle('fade-left')">fade left</TiButton>
  <TiButton @click="handle('slide-down')">slide down</TiButton>
  <TiButton @click="handle('slide-up')">slide up</TiButton>
  <TiButton @click="handle('slide-left')">slide left</TiButton>
  <TiButton @click="handle('slide-right')">slide right</TiButton>
  <TiButton @click="handle('zoom')">zoom</TiButton>
  <TiTransition :show="show" :name="name" @entered="close()">
    <div class="transition-card" />
  </TiTransition>
</template>

<script lang="ts" setup>
import { ref } from 'vue';
import { TiTransition, TiButton, TransitionName } from 'titian-h5-vue';

const show = ref(false);
const name = ref<TransitionName>('fade');
const close = () => {
  show.value = false;
};
const handle = (type: TransitionName) => {
  if (!show.value) {
    show.value = true;
    name.value = type;
  }
};
</script>

<style>
.transition-card {
  width: 40px;
  height: 40px;
  background-color: #fa2c19;
}
</style>

TiTransition API

属性 Properties

名称	类型	是否必填	默认值	说明	备注
name	string	是	-	过渡动画类型	-
enter-name	string	否	-	入场动画类型	-
exit-name	string	否	-	出场动画类型	-
show	boolean	否	false	是否显示过渡动画	-
duration	number | object	否	-	过渡动画持续时间	-
destroy-on-exit	boolean	否	false	出场后是否移除节点	-
timing-function	string	否	-	动画加速度曲线	-

过渡动画类型

名称	说明	备注
fade	淡入淡出	-
fade-down	从下淡入淡出	-
fade-up	从上淡入淡出	-
fade-left	从左淡入淡出	-
fade-right	从右淡入淡出	-
slide-down	从下滑入滑出	-
slide-up	从上滑入滑出	-
slide-left	从左滑入滑出	-
slide-right	从右滑入滑出	-

事件 Events

名称	参数列表	描述	备注
enter	-	入场动画开始时触发	-
entering	-	入场动画进行中时触发	-
entered	-	入场动画结束时触发	-
exit	-	出场动画开始时触发	-
exiting	-	出场动画进行中时触发	-
exited	-	出场动画结束时触发	-

插槽 Slots

名称	说明	备注
default	默认插槽	-

外部样式类 External Classes

名称	说明	备注
ext-class	根节点可扩展的类名	-
enter	定义开始入场时的过渡状态。存在于 transition 节点被插入或者被展示的前一帧，之后会被删掉	-
enter-active	定义入场生效时的状态。在整个入场阶段中应用，在元素被插入之前生效，在过渡/动画完成之后会被移除。这个类可以被用来定义进入过渡的过程时间，延迟和曲线函数。	-
enter-done	定义入场的结束状态。在元素被插入之后下一帧生效 (与此同时 enter 会被移除)，并在过渡/动画完成之后移除。	-
exit	定义出场开始状态。在触发出场状态时立刻生效，并在下一帧被移除。	-
exit-active	定义出场生效时的状态。在整个出场过渡的阶段中应用，在触发出场时立刻生效，在出场完成之后移除。这个类可以被用来定义离开过渡的过程时间，延迟和曲线函数。	-
exit-done	定义出场的结束状态。在触发出场之后下一帧生效 (与此同时 exit 被删除)，并在出场完成之后移除。	-