鸿蒙5.0开发进阶：ArkTS组件-属性动画 (animation)

往期鸿蒙5.0全套实战文章必看：（文中附带全栈鸿蒙5.0学习资料）

• 鸿蒙开发核心知识点，看这篇文章就够了

• 最新版！鸿蒙HarmonyOS Next应用开发实战学习路线

• 鸿蒙HarmonyOS NEXT开发技术最全学习路线指南

• 鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）

---

属性动画 (animation)

组件的某些通用属性变化时，可以通过属性动画实现渐变过渡效果，提升用户体验。支持的属性包括width、height、backgroundColor、opacity、scale、rotate、translate等。布局类改变宽高的动画，内容都是直接到终点状态，例如文字、Canvas的内容等，如果要内容跟随宽高变化，可以使用renderFit属性配置。

说明

从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

接口

animation(value:AnimateParam)

元服务API： 从API version 11开始，该接口支持在元服务中使用。

参数：

参数	类型	是否必填	描述
value	AnimateParam	是	设置动画效果相关参数。

属性动画只对写在animation前面的属性生效，且对组件构造器的属性不生效。

@State widthSize: number = 250;
@State heightSize: number = 100;
@State rotateAngle: number = 0;
@State flag: boolean = true;
@State space: number = 10;
// ...
Column({ space: this.space }) // 改变Column构造器中的space动画不生效
 .onClick(() => {
   if (this.flag) {
     this.widthSize = 150;
     this.heightSize = 60;
     this.space = 20; // 改变this.space动画不生效
   } else {
     this.widthSize = 250;
     this.heightSize = 100;;
     this.space = 10; // 改变this.space动画不生效
   }
   this.flag = !this.flag;
 })
 .margin(30)
 .width(this.widthSize) // 只有写在animation前面才生效
 .height(this.heightSize) // 只有写在animation前面才生效
 .animation({
   duration: 2000,
   curve: Curve.EaseOut,
   iterations: 3,
   playMode: PlayMode.Normal
 })
 // .width(this.widthSize) // 动画不生效
 // .height(this.heightSize) // 动画不生效

示例

该示例通过animation实现了组件的属性动画。

// xxx.ets
@Entry
@Component
struct AttrAnimationExample {
  @State widthSize: number = 250
  @State heightSize: number = 100
  @State rotateAngle: number = 0
  @State flag: boolean = true

  build() {
    Column() {
      Button('change size')
        .onClick(() => {
          if (this.flag) {
            this.widthSize = 150
            this.heightSize = 60
          } else {
            this.widthSize = 250
            this.heightSize = 100
          }
          this.flag = !this.flag
        })
        .margin(30)
        .width(this.widthSize)
        .height(this.heightSize)
        .animation({
          duration: 2000,
          curve: Curve.EaseOut,
          iterations: 3,
          playMode: PlayMode.Normal
        })
      Button('change rotate angle')
        .onClick(() => {
          this.rotateAngle = 90
        })
        .margin(50)
        .rotate({ angle: this.rotateAngle })
        .animation({
          duration: 1200,
          curve: Curve.Friction,
          delay: 500,
          iterations: -1, // 设置-1表示动画无限循环
          playMode: PlayMode.Alternate,
          expectedFrameRateRange: {
            min: 20,
            max: 120,
            expected: 90,
          }
        })
    }.width('100%').margin({ top: 20 })
  }
}