• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 卡片使用动效能力
2
3
4ArkTS卡片开放了使用动画效果的能力，支持[显式动画](../reference/arkui-ts/ts-explicit-animation.md)、[属性动画](../reference/arkui-ts/ts-animatorproperty.md)、[组件内转场](../reference/arkui-ts/ts-transition-animation-component.md)能力。需要注意的是，ArkTS卡片使用动画效果时具有以下限制：
5
6
7**表1** 动效参数限制
8
9| 名称 | 参数说明 | 限制描述 |
10| -------- | -------- | -------- |
11| duration | 动画播放时长 | 限制最长的动效播放时长为1秒，当设置大于1秒的时间时，动效时长仍为1秒。 |
12| tempo | 动画播放速度 | 卡片中禁止设置此参数，使用默认值1。 |
13| delay | 动画延迟执行的时长 | 卡片中禁止设置此参数，使用默认值0。 |
14| iterations | 动画播放次数 | 卡片中禁止设置此参数，使用默认值1。 |
15
16以下示例代码实现了按钮旋转的动画效果：
17![WidgetAnimation](figures/WidgetAnimation.gif)
18
19
20
21```ts
22@Entry
23@Component
24struct AttrAnimationExample {
25  @State rotateAngle: number = 0;
26
27  build() {
28    Column() {
29      Button('change rotate angle')
30        .onClick(() => {
31          this.rotateAngle = 90;
32        })
33        .margin(50)
34        .rotate({ angle: this.rotateAngle })
35        .animation({
36          curve: Curve.EaseOut,
37          playMode: PlayMode.AlternateReverse
38        })
39    }.width('100%').margin({ top: 20 })
40  }
41}
42```
43