!5761 修改ImageAnimator的文档

Merge pull request !5761 from hehongyang9/dev

zh-cn/application-dev/reference/arkui-ts/ts-basic-components-imageanimator.md

@@ -26,15 +26,25 @@ ImageAnimator()
 
 | 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
 | -------- | -------- | -------- | -------- | -------- |
-| images | Array&lt;{<br/>src:string,<br/>width?:Length,<br/>height?:Length,<br/>top?:Length,<br/>left?:Length,<br/>duration?:number<br/>}&gt; | [] | 是 | 设置图片帧信息集合。每一帧的帧信息包含图片路径、图片大小、图片位置和图片播放时长信息。详细说明如下：<br/>src：图片路径，图片格式为svg，png和jpg。<br/>width：图片宽度。<br/>height：图片高度。<br/>top：图片相对于组件左上角的纵向坐标。<br/>left：图片相对于组件左上角的横向坐标。<br/>duration：每一帧图片的播放时长，单位毫秒。 |
+| images | Array&lt;ImageFrameInfo&gt; | [] | 是 | 设置图片帧信息集合。每一帧的帧信息(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张图片；&nbsp;true表示从最后1张图片播放到第1张图片。 |
-| fixedSize | boolean | true | 否 | 设置图片大小是否固定为组件大小。&nbsp;true表示图片大小与组件大小一致，此时设置图片的width&nbsp;、height&nbsp;、top&nbsp;和left属性是无效的。false表示每一张图片的&nbsp;width&nbsp;、height&nbsp;、top和left属性都要单独设置。 |
+| fixedSize | boolean | true | 否 | 设置图片大小是否固定为组件大小。&nbsp;true表示图片大小与组件大小一致，此时设置图片的width&nbsp;、height&nbsp;、top&nbsp;和left属性是无效的。false表示每一张图片的width&nbsp;、height&nbsp;、top和left属性都要单独设置。 |
 | preDecode | number | 0 | 否 | 是否启用预解码，默认值为0，即不启用预解码，如该值设为2，则播放当前页时会提前加载后面两张图片至缓存以提升性能。 |
 | fillMode | FillMode | Forwards | 否 | 设置动画开始前和结束后的状态，可选值参见FillMode说明。 |
 | iterations | number | 1 | 否 | 默认播放一次，设置为-1时表示无限次播放。 |
 
+- ImageFrameInfo属性说明
+  | 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
+  | -------- | -------- | -------- | -------- | -------- |
+  | src | string \| [Resource](../../ui/ts-types.md#resource类型)<sup>9+</sup> | "" | 是 | 图片路径，图片格式为svg，png和jpg，从API Version9开始支持[Resource](../../ui/ts-types.md#resource类型)类型的路径 |
+  | width | [Length](../../ui/ts-types.md#长度类型) | 0 | 否 | 图片宽度 |
+  | height | [Length](../../ui/ts-types.md#长度类型) | 0 | 否 | 图片高度 |
+  | top | [Length](../../ui/ts-types.md#长度类型) | 0 | 否 | 图片相对于组件左上角的纵向坐标 |
+  | left | [Length](../../ui/ts-types.md#长度类型) | 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() {