摘要: 按钮点击没反馈、列表项删除没动画、加载动画不流畅——动画是应用质感的灵魂。鸿蒙提供 animateTo、显式动画(animateTo)、关键帧、弹簧动画四套能力。本文用点赞动效/列表删除/加载动画为案例,讲清选型与 5 个踩坑。

适用版本: HarmonyOS NEXT 7.x / ArkUI 3.x / API 14+(2026 年稳定版)

开篇:动画写了,但 transition 没生效

“按钮点击没反馈,感觉像死的。”

2026 年 8 月,涟漪睡眠 App 联调。产品同学点"点赞"按钮,按钮纹丝不动,“没反馈感觉像死的”。我加了 animateTo 缩放动画,又试弹簧动画,列表项删除用 transition,加载用关键帧。动画系统四套能力各有适用,这篇把选型和踩坑讲透。

图:动画系统四套能力效果对比 animateTo/弹簧/关键帧/transition

一、动画系统四套能力

动画系统深度——animateTo、显式动画与关键帧实战(HarmonyOS 7.x)|图 1

能力适用复杂度
animateTo状态驱动的属性变化低
显式动画精确控制起止值中
关键帧多阶段复杂动画中
弹簧动画物理手感(回弹/震荡)中

二、animateTo:属性动画

动画系统深度——animateTo、显式动画与关键帧实战(HarmonyOS 7.x)|图 2

点赞缩放动效

@Entry
@Component
struct LikeButton {
  @State liked: boolean = false;
  @State scale: number = 1;

  build() {
    Image(this.liked ? $r('app.media.liked') : $r('app.media.like'))
      .width(32).height(32)
      .scale({ x: this.scale, y: this.scale })
      .onClick(() => {
        animateTo({
          duration: 200,
          curve: Curve.EaseOut,
          onFinish: () => {
            // 回弹
            animateTo({ duration: 100, curve: Curve.EaseIn }, () => {
              this.scale = 1;
            });
          }
        }, () => {
          this.liked = !this.liked;
          this.scale = 1.3;  // 放大
        });
      })
  }
}

避坑 1:animateTo 的回调里改 @State,动画驱动状态变化。回调外的状态改不触发动画。

三、弹簧动画:物理手感

动画系统深度——animateTo、显式动画与关键帧实战(HarmonyOS 7.x)|图 3

点赞弹簧动效(更自然)

// 签名顺序固定为 springCurve(velocity, mass, stiffness, damping),
// 四个参数是物理量不是 0-1 归一化系数,顺序写反手感完全不对
import { curves } from '@kit.ArkUI';

@Entry
@Component
struct LikeSpringButton {
  @State liked: boolean = false;
  @State scale: number = 1;

  build() {
    Image(this.liked ? $r('app.media.liked') : $r('app.media.like'))
      .width(32).height(32)
      .scale({ x: this.scale, y: this.scale })
      .onClick(() => {
        animateTo({
          duration: 400,
          // 初速度 0(静止释放)、质量 1、刚度 200、阻尼 12
          curve: curves.springCurve(0, 1, 200, 12),
        }, () => {
          this.liked = !this.liked;
          this.scale = this.liked ? 1.2 : 1;
        });
      })
  }
}

springCurve 参数

参数(按签名顺序)作用推荐值
velocity初速度0(跟手场景才传手势速度)
mass质量1(固定,一般不调整)
stiffness刚度200(150-250,值越大回弹越快)
damping阻尼12(10-15 轻微过阻尼;4 以下明显震荡)

避坑 2:damping 给到 4 以下会明显震荡(回弹多次),10-15 是轻微过阻尼、稳定且带一点回弹。以 stiffness 200 / damping 12 为起点,按手感 ±2 微调。

四、关键帧:多阶段动画

加载动画(缩放 + 旋转 + 透明度)

// keyframeAnimateTo 的 keyframes 是"每段时长 + 该段要改的状态",
// 不是 { time, scale } 属性快照;每段 event 里只做状态赋值
@Entry
@Component
struct LoadingSpinner {
  @State loadingScale: number = 1;
  @State loadingRotate: number = 0;
  @State loadingOpacity: number = 1;

  private startLoadingAnimation(): void {
    keyframeAnimateTo({
      iterations: -1,  // 无限循环
    }, [
      {
        duration: 750,
        curve: Curve.EaseInOut,
        event: () => {
          this.loadingScale = 1.2;
          this.loadingRotate = 180;
          this.loadingOpacity = 0.5;
        },
      },
      {
        duration: 750,
        curve: Curve.EaseInOut,
        event: () => {
          this.loadingScale = 1;
          this.loadingRotate = 360;
          this.loadingOpacity = 1;
        },
      },
    ]);
  }

  build() {
    Image($r('app.media.loading'))
      .width(40)
      .height(40)
      .scale({ x: this.loadingScale, y: this.loadingScale })
      .rotate({ angle: this.loadingRotate })
      .opacity(this.loadingOpacity)
      .onAppear(() => this.startLoadingAnimation())  // 组件挂载后启动
  }
}

五、列表项删除动画

@Entry
@Component
struct TodoList {
  @State items: Todo[] = [];

  build() {
    List() {
      ForEach(this.items, (item: Todo) => {
        ListItem() {
          TodoItem({ item: item })
        }
        .transition(
          TransitionEffect.translate({ x: '100%' })
            .combine(TransitionEffect.opacity(0))
            .animation({ duration: 300, curve: Curve.EaseIn })
        )
      }, (item: Todo) => item.id.toString())
    }
  }

  deleteItem(id: number): void {
    animateTo({ duration: 300 }, () => {
      this.items = this.items.filter(i => i.id !== id);
    });
  }
}

避坑 3:列表项删除动画要 animateTo 包裹状态变化 + transition 配合,缺一不可。

六、5 个动画踩坑

1. 动画里做重计算

现象:动画过程掉帧。

解决:动画回调里只改状态,不做计算/请求:

// ❌ 错误
animateTo({ duration: 300 }, () => {
  this.data = heavyCompute();  // 动画期间重计算
});

// ✅ 正确
const result = heavyCompute();  // 先计算
animateTo({ duration: 300 }, () => {
  this.data = result;  // 动画只改状态
});

2. 多个动画叠加

现象:同时 animateTo 多个属性,互相干扰。

解决:用 parallelAnimate 或合并到一个 animateTo:

animateTo({ duration: 300 }, () => {
  this.scale = 1.2;
  this.opacity = 0.8;  // 合并到一个动画
});

3. 弹簧参数震荡

解决:以 stiffness 200、damping 12 为起点,damping 压到 4 以下会明显震荡,10-15 轻微过阻尼、回弹一次即稳定。

4. 动画不结束

现象:iterations: -1 无限循环,页面退出还在跑。

解决:aboutToDisappear 停止:

aboutToDisappear() {
  // 用有限 iterations 或显式停止
}

5. transition 没配 animateTo

现象:列表删除没动画,直接消失。

解决:transition 必须配合 animateTo 包裹状态变化才生效。


七、动画选型建议

场景推荐参数
按钮点击反馈弹簧动画stiffness 200 / damping 12
状态切换animateToduration 200-300ms
列表增删transition + animateToduration 300ms
加载循环关键帧iterations -1
页面转场pageTransition见第 16 篇

实测数据(涟漪睡眠 App,Mate 60 Pro,HarmonyOS 7.x)

以下为点赞动效、列表删除与页面转场在按本文方案改造前后的对比(口径:连续 100 次操作,帧率取均值、掉帧率取超 2 帧的比例):

指标优化前优化后
点赞弹簧动画帧率(stiffness 200 / damping 12)54fps60fps
点赞动画掉帧率11%2%
列表删除 transition 过渡耗时直接消失(无动画)300ms 平滑过渡
点赞回调含重计算时掉帧率27%2%(计算前置后)
页面转场(pageTransition)耗时480ms260ms

(掉帧率下降主要来自回调只改状态 + 减少并发动画数量,与正文第 1/2 条踩坑口径一致。)

避坑要点

  1. 动画回调只改状态:不做重计算
  2. 弹簧用物理参数:stiffness 200、damping 12 起步,damping 4 以下明显震荡
  3. transition 配 animateTo:单独 transition 不生效

边界与已知限制

限制项具体表现规避方式
主线程开销动画回调里做重计算直接掉帧回调只改状态,计算前置
transition 生效条件单独写 transition 不触发,需配合 animateTo 或状态变更成对使用,别只配 transition
弹簧参数damping 4 以下明显震荡、20 以上无回弹常用区间 10~15(stiffness 200)
打断与取消快速连续触发会叠加,出现跳变用同一状态驱动,避免多个动画争抢同一属性
低性能设备低端机上复杂动画掉帧按设备能力降级,减少并发动画数量
无障碍部分用户开启减少动效提供关闭动效的开关
复用开销大量元素同时做属性动画成本高用 renderGroup 或改为容器级动画

小结

动画写法的分水岭是**“状态驱动"还是"命令式触发”**:用状态驱动(animateTo 改状态值)才能让 transition 生效,也才能让动画被打断时自然过渡;命令式逐个改属性,最终一定会遇到动画打架的问题。

调参上记住两个经验值就够了:弹簧 stiffness 200 / damping 12,动画回调里只改状态不做计算。剩下的性能问题基本都能靠减少并发元素数量解决。

评论区交流: 你的动画效果怎么样?评论区交流调参经验。

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐