# image-animator - [子组件](#zh-cn_topic_0000001173324625_section393521619565) - [属性](#zh-cn_topic_0000001173324625_section1342212415618) - [样式](#zh-cn_topic_0000001173324625_section1774719169253) - [事件](#zh-cn_topic_0000001173324625_section17969351566) - [方法](#zh-cn_topic_0000001173324625_section1428810433566) - [示例](#zh-cn_topic_0000001173324625_section118221913375) 图片帧动画播放器。 ## 子组件不支持。 ## 属性除支持[通用属性](js-components-common-attributes.md#ZH-CN_TOPIC_0000001163812208)外，还支持如下属性：

名称	类型	默认值	必填	描述
images	Array<ImageFrame>	-	是	设置图片帧信息集合。每一帧的帧信息包含图片路径、图片大小和图片位置信息。目前支持以下图片格式：png、jpg。ImageFrame的详细说明请见表1。说明：使用时需要使用数据绑定的方式，如images = {{images}}，js中声明相应变量：images: [{src: "/common/heart-rate01.png"}, {src: "/common/heart-rate02.png"}]。 js中声明相应变量：images: [{src: "/common/heart-rate01.png", duration: "100"}, {src: "/common/heart-rate02.png", duration: "200"}]。支持配置每一帧图片的时长，单位毫秒。⁶⁺
predecode⁶⁺	number	0	否	是否启用预解码，默认值为0，即不启用预解码，如该值设为2，则播放当前页时会提前加载后面两张图片至缓存以提升性能。
iteration	number \| string	infinite	否	设置帧动画播放次数。number表示固定次数，infinite枚举表示无限次数播放。
reverse	boolean	false	否	设置播放顺序。false表示从第1张图片播放到最后1张图片； true表示从最后1张图片播放到第1张图片。
fixedsize	boolean	true	否	设置图片大小是否固定为组件大小。 true表示图片大小与组件大小一致，此时设置图片的width 、height 、top 和left属性是无效的。false表示每一张图片的 width 、height 、top和left属性都要单独设置。
duration	string	-	是	设置单次播放时长。单位支持[s(秒)\|ms(毫秒)]，默认单位为ms。 duration为0时，不播放图片。值改变只会在下一次循环开始时生效，当images中设置了单独的duration后，该属性设置无效。
fillmode⁵⁺	string	forwards	否	指定帧动画执行结束后的状态。可选项有： none：恢复初始状态。 forwards：保持帧动画结束时的状态（在最后一个关键帧中定义）。

**表 1** ImageFrame说明

名称	类型	默认值	必填	描述
src	<uri>	-	是	图片路径，图片格式为svg，png和jpg。
width	<length>	0	否	图片宽度。
height	<length>	0	否	图片高度。
top	<length>	0	否	图片相对于组件左上角的纵向坐标。
left	<length>	0	否	图片相对于组件左上角的横向坐标。
duration⁶⁺	number	-	否	每一帧图片的播放时长，单位毫秒。

## 样式支持[通用样式](js-components-common-styles.md#ZH-CN_TOPIC_0000001163932190)。 ## 事件除支持[通用事件](js-components-common-events.md#ZH-CN_TOPIC_0000001209412119)外，还支持如下事件：

名称	参数	描述
start	-	帧动画启动时触发。
pause	-	帧动画暂停时触发。
stop	-	帧动画结束时触发。
resume	-	帧动画恢复时触发。

## 方法支持[通用方法](js-components-common-methods.md#ZH-CN_TOPIC_0000001209252157)外，还支持如下方法：

名称	参数	描述
start	-	开始播放图片帧动画。再次调用，重新从第1帧开始播放。
pause	-	暂停播放图片帧动画。
stop	-	停止播放图片帧动画。
resume	-	继续播放图片帧。
getState	-	获取播放状态。可能值有： playing：播放中 paused：已暂停 stopped：已停止。

## 示例 ```

``` ``` /* xxx.css */ .container { flex-direction: column; justify-content: center; align-items: center; left: 0px; top: 0px; width: 454px; height: 454px; } .animator { width: 70px; height: 70px; } .btn-box { width: 264px; height: 120px; flex-wrap: wrap; justify-content: space-around; align-items: center; } .btn { border-radius: 8px; width: 120px; margin-top: 8px; } ``` ``` //xxx.js export default { data: { frames: [ { src: "/common/asserts/heart78.png", }, { src: "/common/asserts/heart79.png", }, { src: "/common/asserts/heart80.png", }, { src: "/common/asserts/heart81.png", }, { src: "/common/asserts/heart82.png", }, { src: "/common/asserts/heart83.png", }, { src: "/common/asserts/heart84.png", }, { src: "/common/asserts/heart85.png", }, { src: "/common/asserts/heart86.png", }, { src: "/common/asserts/heart87.png", }, { src: "/common/asserts/heart88.png", }, { src: "/common/asserts/heart89.png", }, { src: "/common/asserts/heart90.png", }, { src: "/common/asserts/heart91.png", }, { src: "/common/asserts/heart92.png", }, { src: "/common/asserts/heart93.png", }, { src: "/common/asserts/heart94.png", }, { src: "/common/asserts/heart95.png", }, { src: "/common/asserts/heart96.png", }, ], }, handleStart() { this.$refs.animator.start(); }, handlePause() { this.$refs.animator.pause(); }, handleResume() { this.$refs.animator.resume(); }, handleStop() { this.$refs.animator.stop(); }, }; ``` ![](figures/image-animator.gif)