diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-imageanimator.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-imageanimator.md
index 7c7545bbe9b30e254109c712b068f528a832aa22..f9f3851de17552859fae2e99777fd72f811f5523 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-imageanimator.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-imageanimator.md
@@ -26,15 +26,25 @@ ImageAnimator()
| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
| -------- | -------- | -------- | -------- | -------- |
-| images | Array<{
src:string,
width?:Length,
height?:Length,
top?:Length,
left?:Length,
duration?:number
}> | [] | 是 | 设置图片帧信息集合。每一帧的帧信息包含图片路径、图片大小、图片位置和图片播放时长信息。详细说明如下:
src:图片路径,图片格式为svg,png和jpg。
width:图片宽度。
height:图片高度。
top:图片相对于组件左上角的纵向坐标。
left:图片相对于组件左上角的横向坐标。
duration:每一帧图片的播放时长,单位毫秒。 |
+| images | Array<ImageFrameInfo> | [] | 是 | 设置图片帧信息集合。每一帧的帧信息(ImageFrameInfo)包含图片路径、图片大小、图片位置和图片播放时长信息,具体见下面的关于ImageFrameInfo的属性说明。 |
| state | AnimationStatus | Initial | 否 | 默认为初始状态,用于控制播放状态。 |
-| duration | number | 1000 | 否 | 单位为毫秒,默认时长为1000ms;duration为0时,不播放图片;值的改变只会在下一次循环开始时生效;当images中设置了单独的duration后,该属性设置无效。 |
+| duration | number | 1000 | 否 | 单位为毫秒,默认时长为1000ms;duration为0时,不播放图片;值的改变只会在下一次循环开始时生效;当images中任意一帧图片设置了单独的duration后,该属性设置无效。 |
| reverse | boolean | false | 否 | 设置播放顺序。false表示从第1张图片播放到最后1张图片; true表示从最后1张图片播放到第1张图片。 |
-| fixedSize | boolean | true | 否 | 设置图片大小是否固定为组件大小。 true表示图片大小与组件大小一致,此时设置图片的width 、height 、top 和left属性是无效的。false表示每一张图片的 width 、height 、top和left属性都要单独设置。 |
+| fixedSize | boolean | true | 否 | 设置图片大小是否固定为组件大小。 true表示图片大小与组件大小一致,此时设置图片的width 、height 、top 和left属性是无效的。false表示每一张图片的width 、height 、top和left属性都要单独设置。 |
| preDecode | number | 0 | 否 | 是否启用预解码,默认值为0,即不启用预解码,如该值设为2,则播放当前页时会提前加载后面两张图片至缓存以提升性能。 |
| fillMode | FillMode | Forwards | 否 | 设置动画开始前和结束后的状态,可选值参见FillMode说明。 |
| iterations | number | 1 | 否 | 默认播放一次,设置为-1时表示无限次播放。 |
+- ImageFrameInfo的属性说明
+ | 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
+ | -------- | -------- | -------- | -------- | -------- |
+ | src | string \| [Resource](../../ui/ts-types.md#resource类型)9+ | "" | 是 | 图片路径,图片格式为svg,png和jpg,从API9起支持[Resource](../../ui/ts-types.md#resource类型)类型的路径 |
+ | width | [Length](../../ui/ts-types.md#长度类型) | 0 | 否 | 图片宽度 |
+ | height | Length | 0 | 否 | 图片高度 |
+ | top | Length | 0 | 否 | 图片相对于组件左上角的纵向坐标 |
+ | left | Length | 0 | 否 | 图片相对于组件左上角的横向坐标 |
+ | duration | number | 0 | 否 | 每一帧图片的播放时长,单位毫秒 |
+
- AnimationStatus枚举说明
| 名称 | 描述 |
| -------- | -------- |
@@ -94,7 +104,7 @@ struct ImageAnimatorExample {
left: 0
},
{
- src: '/comment/bg3.jpg',
+ src: $r('app.media.bg3'),
duration: 500,
width: 325,
height: 200,
@@ -102,7 +112,7 @@ struct ImageAnimatorExample {
left: 0
},
{
- src: '/comment/bg4.jpg',
+ src: $rawfile('bg4.jpg'),
duration: 500,
width: 325,
height: 200,
@@ -126,6 +136,7 @@ struct ImageAnimatorExample {
console.info('Cancel')
})
.onFinish(() => { // 当帧动画播放完成后触发
+ this.state = AnimationStatus.Stopped
console.info('Finish')
})
Row() {