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() {