第九节HarmonyOS 常用基础组件21-ImageAnimator

1、描述

提供帧动画组件来实现逐帧播放图片的能力,可以配置需要播放的图片列表,每张图片可以配置时长。

2、接口

ImageAnimator()

3、属性

|------------|-------------------------|--------------------------------------------------------------------------------------------------------------------------------|
| 参数名 | 参数类型 | 描述 |
| images | Array<ImageFrameInfo> | 设置图片帧信息集合,每一帧的帧信息(ImageFrameInfo)包含图片路径,图片大小、图片位置和图片播放时长信息。 |
| state | AnimationStatus | 默认为初始状态,用于控制 播放状态。 默认值:AnimationStatus.Initial |
| duration | number | 单位为毫秒。默认时长为1000ms;duration为0时不播放图片; |
| reverse | boolean | 设置播放顺序;false表示从第1张图片播放到最后1张;true表示从最后1张播放到第1张图片。 默认值:false |
| fixedSize | boolean | 设置图片大小是否固定为组件大小;true表示图片大小与组件大小一致,此时设置图片的一些属性是无效的(width、height、top、left等)。false表示每一张图片的width、height、top、left属性都要单独设置。 默认值:true |
| fillMode | FillMode | 设置动画开始与结束后的状态。 默认值:FillMode.Forwards |
| Iterations | number | 默认播放一次,设置为-1时表示无限次播放。 默认值:1 |

4、ImageFrameInfo对象说明

|----------|--------------------|----|------------------------|
| 参数名 | 参数类型 | 必填 | 描述 |
| src | string | Resource | 是 | 图片路径,图片格式svg、png、jpg。 |
| width | number | string | 否 | 图片宽度,默认值:0。 |
| height | number | string | 否 | 图片高度,默认值:0。 |
| top | number | string | 否 | 图片相对于组件左上角的纵向坐标,默认值:0。 |
| left | number | string | 否 | 图片相对于组件左上角的横向坐标,默认值:0。 |
| duration | number | 否 | 每一帧图片播放的时长,单位毫秒,默认值:0。 |

5、AnimationStatus对象说明

|---------|-----------|
| 名称 | 描述 |
| Initial | 动画初始状态。 |
| Running | 动画处于播放状态。 |
| Paused | 动画处于暂停状态。 |
| Stopped | 动画处于停止状态。 |

6、FillMode对象说明

|-----------|-------------------------------------------------------------------------------------------------------------------------------------|
| 名称 | 描述 |
| None | 动画未执行时不会将任何样式应用于目标,动画播放完成之后恢复初始默认状态。 |
| Forwards | 目标将保留动画执行期间最后一个关键帧状态。 |
| Backwards | 动画将在应用于目标时立即应用第一个关键帧的值,并在delay期间保留此值。第一个关键帧取决于playMode,playMode为Normal或Alternate时为form的状态,playMode为Reverse或AlternateReverse时为to的状态。 |
| Both | 动画将遵循Forwards和Backwards的规则,从而在两个方向上拓展动画属性。 |

7、事件

onStart(event: () => void) - 状态回调,动画开始播放时触发。

onPause(event: () => void) - 状态回调,动画暂停播放时触发。

onRepeat(event: () => void) - 状态回调,动画重复播放时触发。

onCancel(event: () => void) - 状态回调,动画取消播放时触发。

onFinish(event: () => void) - 状态回调,动画播放完成时触发。

8、示例

复制代码
import router from '@ohos.router'

@Entry
@Component
struct ImageAnimatorPage {
  @State message: string = '提供帧动画组件来实现逐帧播放图片的能力,可以配置需要播放的图片列表,每张图片可以配置时长。'
  @State arrayImgs: ImageFrameInfo[] = [{
    src: $r('app.media.android'),
  }, {
    src: $r('app.media.java'),
  }, {
    src: $r('app.media.harmony'),
  }, {
    src: $r('app.media.css'),
  }, {
    src: $r('app.media.java_script'),
  }, {
    src: $r('app.media.typescript'),
  }]
  @State state: AnimationStatus = AnimationStatus.Initial;
  @State reverse:boolean = false;
  @State iterations:number = 1;


  build() {
    Row() {
      Scroll() {
        Column() {
          Text(this.message)
            .fontSize(20)
            .fontWeight(FontWeight.Bold)
            .width("96%")
          Blank(12)

          ImageAnimator()
            .images(this.arrayImgs)// 加载资源
            .duration(2000)// 设置动画间时长
            .state(this.state) // 控制播放状态
            .reverse(this.reverse) // 设置播放顺序。false表示从前到后,true表示从后往前,默认值:false。
            .iterations(this.iterations) // 设置默认播放次数,-1时无限次播放,默认值1.
            .width("96%")
            .height(200)

          Row() {
            Button('开始').width(100).padding(5).onClick(() => {
              this.state = AnimationStatus.Running
            }).margin(5)
            Button('暂停').width(100).padding(5).onClick(() => {
              this.state = AnimationStatus.Paused // 显示当前帧图片
            }).margin(5)
            Button('停止').width(100).padding(5).onClick(() => {
              this.state = AnimationStatus.Stopped // 显示动画的起始帧图片
            }).margin(5)
          }

          Row() {
            Button('播放顺序').width(100).padding(5).onClick(() => {
              this.reverse = !this.reverse
            }).margin(5)
            Button('循环次数').width(100).padding(5).onClick(() => {
              this.iterations = 2
            }).margin(5)
            Button('无限循环').width(100).padding(5).onClick(() => {
              this.iterations = -1 // 无限循环播放
            }).margin(5)
          }

          Blank(12)
          Button("ImageAnimator文本文档")
            .fontSize(20)
            .backgroundColor('#007DFF')
            .width('96%')
            .onClick(() => {
              // 处理点击事件逻辑
              router.pushUrl({
                url: "pages/baseComponent/imageAnimator/ImageAnimatorDesc",
              })
            })
          Blank(12)

        }
        .width('100%')
      }
    }
    .padding({ top: 12, bottom: 12 })
  }
}

9、效果图

相关推荐
锋行天下24 分钟前
LangGraph 对接 MCP 实战指南:从本地开发到线上部署与模型防坑
前端·人工智能·后端
Highcharts.js1 小时前
Highcharts与TypeScript集成指南
前端·javascript·typescript·前端框架·数据可视化·highcharts
跳跳的小古风1 小时前
前端转全栈:一条接口从前端请求到 SQL 完整流程
java·前端
亿元程序员2 小时前
微信小游戏备案很久?这样操作可以直接发布!
前端
福狼2 小时前
The Expanse:让风沙成为世界的一部分
前端·three.js
程序员鱼皮2 小时前
这 3 年 AI Agent 到底进化了啥?万字大白话,一次讲透!
前端·后端·aigc
用户900305093622 小时前
Claude Code平替评测:换掉之前先理清楚这些选型条件
前端
bai2732 小时前
同一个 JSON,Node 读出了三种坏法:Windows 上四种写法的编码实测
前端
ZANE2 小时前
纯前端实现的 .gitignore 生成器技术实现
前端
小y的笔记2 小时前
Vue 3 异步搜索实战:watch、请求取消与竞态控制
前端·javascript