过度动画 Transition
通过使用 transition 给元素添加进入、离开的动画效果。
使用
API安装使用
{
// 原生小程序
"usingComponents": {
"ti-transition": "@titian-design/weapp/transition/index"
},
// titan-cli搭建的项目
"usingComponents": {
"ti-transition": "platform://titian-mp/ti-transition"
}
}
用法示例
- index.wxml
- index.wxss
<ti-transition
show="{{show}}"
name="fade"
extClass="demo-block"
>
<view >内容</view>
</ti-transition>
.demo-block {
position: fixed;
top: 100rpx;
left: 0rpx;
right: 0rpx;
margin: auto;
width: 100rpx;
height: 100rpx;
border: 1rpx solid red;
line-height: 100rpx;
text-align: center;
}
ti-transition 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
名称 | 参数列表 | 描述 | 备注 |
---|---|---|---|
bind:enter | - | 入场动画开始时触发 | - |
bind:entering | - | 入场动画进行中时触发 | - |
bind:entered | - | 入场动画结束时触发 | - |
bind:exit | - | 出场动画开始时触发 | - |
bind:exiting | - | 出场动画进行中时触发 | - |
bind:exited | - | 出场动画结束时触发 | - |
插槽 Slots
名称 | 说明 | 备注 |
---|---|---|
default | 默认插槽 | - |
外部样式类 External Classes
名称 | 说明 | 备注 |
---|---|---|
ext-class | 根节点可扩展的类名 | - |
enter | 定义开始入场时的过渡状态。存在于 transition 节点被插入或者被展示的前一帧,之后会被删掉 | - |
enter-active | 定义入场生效时的状态。在整个入场阶段中应用,在元素被插入之前生效,在过渡/动画完成之后会被移除。这个类可以被用来定义进入过渡的过程时间,延迟和曲线函数。 | - |
enter-done | 定义入场的结束状态。在元素被插入之后下一帧生效 (与此同时 enter 会被移除),并在过渡/动画完成之后移除。 | - |
exit | 定义出场开始状态。在触发出场状态时立刻生效,并在下一帧被移除。 | - |
exit-active | 定义出场生效时的状态。在整个出场过渡的阶段中应用,在触发出场时立刻生效,在出场完成之后移除。这个类可以被用来定义离开过渡的过程时间,延迟和曲线函数。 | - |
exit-done | 定义出场的结束状态。在触发出场之后下一帧生效 (与此同时 exit 被删除),并在出场完成之后移除。 | - |