ArKTS基础组件

一.AlphabetIndexer

可以与容器组件联动用于按逻辑结构快速定位容器显示区域的组件。

子组件

color:设置文字颜色。

参数名	类型	必填	说明
value	ResourceColor	是	文字颜色。 默认值：0x99182431。

 selectedColor:设置选中项文字颜色。

参数名	类型	必填	说明
value	ResourceColor	是	选中项文字颜色。 默认值：0xFF007DFF。

 popupColor:设置提示弹窗文字颜色。

参数名	类型	必填	说明
value	ResourceColor	是	提示弹窗文字颜色。 默认值：0xFF007DFF。

 selectedBackgroundColor:设置选中项背景颜色。

参数名	类型	必填	说明
value	ResourceColor	是	选中项背景颜色。 默认值：0x1A007DFF。

 popupBackground:设置提示弹窗背景色。

参数名	类型	必填	说明
value	ResourceColor	是	提示弹窗背景色。 默认值： API version 11及以前：0xFFFFFFFF。 API version 12及以后：#66808080。

usingPopup:设置是否使用提示弹窗。

参数名	类型	必填	说明
value	boolean	是	是否使用提示弹窗。 默认值：false

selectedFont:设置选中项文字样式。

参数名	类型	必填	说明
value	Font	是	选中项文字样式。 默认值： API version 11及以前： { size:'12.0fp', style:FontStyle.Normal, weight:FontWeight.Normal, family:'HarmonyOS Sans' } API version 12及以后： { size:'10.0vp', style:FontStyle.Normal, weight:FontWeight.Medium, family:'HarmonyOS Sans' }

popupFont:设置提示弹窗字体样式。

参数名	类型	必填	说明
value	Font	是	提示弹窗字体样式。 默认值： { size:'24.0vp', style:FontStyle.Normal, weight:FontWeight.Normal, family:'HarmonyOS Sans' }

font:设置字母索引条默认字体样式

参数名	类型	必填	说明
value	Font	是	字母索引条默认字体样式。 默认值： API version 11及以前： { size:'12.0fp', style:FontStyle.Normal, weight:FontWeight.Normal, family:'HarmonyOS Sans' } API version 12及以后： { size:'10.0vp', style:FontStyle.Normal, weight:FontWeight.Medium, family:'HarmonyOS Sans' }

 itemSize:设置字母索引条字母区域大小。

参数名	类型	必填	说明
value	string | number	是	字母索引条字母区域大小，字母区域为正方形，即正方形边长。不支持设置为百分比。 默认值：16.0 单位：vp

alignStyle :设置字母索引条弹框的对齐样式

参数名	类型	必填	说明
value	IndexerAlign	是	字母索引条弹框的对齐样式，支持弹窗显示在索引条右侧和左侧。 默认值: IndexerAlign.END。

offset10+

Length

否

提示弹窗与索引条之间间距，大于等于0为有效值，在不设置或设置为小于0的情况下间距与popupPosition.x相同。与popupPosition同时设置时，水平方向上offset生效，竖直方向上popupPosition.y生效

 selected8+:设置选中项索引值。

参数名	类型	必填	说明
index	number	是	选中项索引值。 默认值：0

popupPosition8+:设置弹出窗口相对于索引器条上边框中点的位置

参数名	类型	必填	说明
value	Position	是	弹出窗口相对于索引器条上边框中点的位置。 默认值：{x:60.0, y:48.0}

 popupSelectedColor10+:设置提示弹窗非字母部分选中文字色。

参数名	类型	必填	说明
value	ResourceColor	是	提示弹窗非字母部分选中文字色。 默认值：#FF182431

 popupUnselectedColor10+:设置提示弹窗非字母部分未选中文字色。

参数名	类型	必填	说明
value	ResourceColor	是	提示弹窗非字母部分未选中文字色。 默认值：#FF182431

 popupItemFont10+:设置提示弹窗非字母部分字体样式。

参数名	类型	必填	说明
value	Font	是	提示弹窗非字母部分字体样式。 默认值： { size:24, weight:FontWeight.Medium }

popupItemBackgroundColor10+ :设置提示弹窗非字母部分背景色。

参数名	类型	必填	说明
value	ResourceColor	是	提示弹窗非字母部分背景色。 默认值： API version 11及以前：#FFFFFFFF。 API version 12及以后：#00000000。

autoCollapse11+ :设置是否使用自适应折叠模式。

参数名	类型	必填	说明
value	boolean	是	是否使用自适应折叠模式。 默认值：false

 popupItemBorderRadius12+:设置提示弹窗索引项背板圆角半径。

参数名	类型	必填	说明
value	number	是	设置提示弹窗索引项背板圆角半径。 默认值：24vp。 不支持百分比，小于0时按照0设置。 提示弹窗背板圆角自适应变化（索引项圆角半径+4vp）。

 itemBorderRadius12+:设置索引项背板圆角半径

参数名	类型	必填	说明
value	number	是	设置索引项背板圆角半径。 默认值：8vp 不支持百分比，小于0时按照0设置。 索引条背板圆角自适应变化（索引项圆角半径+4vp）。

 popupBackgroundBlurStyle12:设置提示弹窗的背景模糊材质

参数名	类型	必填	说明
value	BlurStyle	是	设置提示弹窗的背景模糊材质。 默认值：COMPONENT_REGULAR。

 popupTitleBackground12+:设置提示弹窗首个索引项背板颜色。

参数名	类型	必填	说明
value	ResourceColor	是	设置提示弹窗首个索引项背板颜色。 默认值： 提示弹窗只有一个索引项：#00FFFFFF。 提示弹窗有多个索引项：#0c182431。

 enableHapticFeedback12+:

参数名	类型	必填	说明
enable	boolean	否	支持触控反馈。 默认值：true

onSelected(deprecated):索引条选中回调，返回值为当前选中索引。

参数名	类型	必填	说明
index	number	是	当前选中的索引。

onSelect8+:索引条选中回调，返回值为当前选中索引

参数名	类型	必填	说明
index	number	是	当前选中的索引。

onRequestPopupData8+:选中字母索引后，请求索引提示弹窗显示内容回调。

参数名	类型	必填	说明
index	number	是	当前选中的索引

onPopupSelect8+:字母索引提示弹窗字符串列表选中回调。

参数名	类型	必填	说明
index	number	是	当前选中的索引。

示例代码:

实现样式:电话薄首字母选项

    Stack(){List(){ForEach(this.txls,(txl:Txl,index)=>{ListItemGroup({header:this.tou(txl.key)}){ForEach(txl.lxr,(lxr:Lxr,i)=>{ListItem(){Row(){Image(lxr.tImg).height(30).borderRadius(100)Text(lxr.names).fontSize(18)}.width('100%').backgroundColor(i%2==0?'#abc':'#fcf')}})}})}.sticky(StickyStyle.Header).onScrollIndex((first)=>{this.selectIndex=first})AlphabetIndexer({arrayValue:this.strs,selected:0}).selectedFont({size:30}).itemSize(60).font({size:28}).selected(this.selectIndex).usingPopup(true).onRequestPopupData((index:number)=>{//1.清空数组this.strs2=[]for (let i=0;i<this.txls[index].lxr.length;i++){//添加数据this.strs2.push(this.txls[index].lxr[i].names)}return this.strs2})}.height('100%').width('100%')

二. Blank

空白填充组件，在容器主轴方向上，空白填充组件具有自动填充容器空余部分的能力。仅当父组件为Row/Column/Flex时生效。

子组件

color:设置空白填充的填充颜色。

参数名	类型	必填	说明
value	ResourceColor	是	空白填充的填充颜色。 默认值：Color.Transparent

示例代码: 

  @Builder test2(){Row(){Text('左边')Blank().color('red')Text('右边')}.width('100%').backgroundColor('#abcded')Column(){Text('上边')Blank().color('red')Text('下边')}.height(100).width('100%').backgroundColor('#abc')}

 三.Button

按钮组件，可快速创建不同样式的按钮。

子组件

Button:创建可以包含单个子组件的按钮

参数名	类型	必填	说明
options	ButtonOptions	是	配置按钮的显示样式。

Button:使用文本内容创建相应的按钮组件，此时Button无法包含子组件。

参数名	类型	必填	说明
label	ResourceStr	是	按钮文本内容。
options	ButtonOptions	否	配置按钮的显示样式。

type:设置Button样式。

参数名	类型	必填	说明
value	ButtonType	是	Button样式。 默认值：ButtonType.Capsule

fontSize:设置文本显示字号。

参数名	类型	必填	说明
value	Length	是	文本显示字号。 默认值：若controlSize的值为：controlSize.NORMAL，取'16fp'，若controlSize的值为：controlSize.SMALL，取'12fp'

fontColor:设置文本显示颜色。

参数名	类型	必填	说明
value	ResourceColor	是	文本显示颜色。 默认值：'#ffffff'

fontWeight:设置文本的字体粗细。

参数名	类型	必填	说明
value	FontWeight | number | string	是	文本的字体粗细，number类型取值[100, 900]，取值间隔为100，取值越大，字体越粗。 默认值：400

fontStyle:设置文本的字体样式。

参数名	类型	必填	说明
value	FontStyle	是	文本的字体样式。 默认值：FontStyle.Normal。

stateEffect:设置是否开启按压态显示效果。

参数名	类型	必填	说明
value	boolean	是	按钮按下时是否开启按压态显示效果，当设置为false时，按压效果关闭。 默认值：true

fontFamily:设置字体列表。

参数名	类型	必填	说明
value	Resource | string	是	字体列表。默认字体'HarmonyOS Sans'，当前支持'HarmonyOS Sans'字体和注册自定义字体。

 labelStyle10+:设置Button组件label文本和字体的样式。

参数名	类型	必填	说明
value	LabelStyle	是	Button组件label文本和字体的样式。

buttonStyle11+:设置Button组件的样式和重要程度

参数名	类型	必填	说明
value	ButtonStyleMode	是	Button组件的样式和重要程度。 默认值:ButtonStyleMode.EMPHASIZED

controlSize11+:设置Button组件的尺寸。

参数名	类型	必填	说明
value	ControlSize	是	Button组件的尺寸。 默认值:ControlSize.NORMAL

 role12+:设置Button组件的角色。

参数名	类型	必填	说明
value	ButtonRole	是	设置Button组件的角色。 默认值:ButtonRole.NORMAL

contentModifier12+:定制Button内容区的方法

参数名	类型	必填	说明
modifier	ContentModifier<ButtonConfiguration>	是	在Button组件上，定制内容区的方法。 modifier: 内容修改器，开发者需要自定义class实现ContentModifier接口。

 四.Checkbox

提供多选框组件，通常用于某选项的打开或关闭。

属性:

select:设置多选框是否选中。

参数名	类型	必填	描述
value	boolean	是	多选框是否选中。 默认值：false

selectedColor:设置多选框选中状态颜色。

参数名	类型	必填	描述
value	ResourceColor	是	多选框选中状态颜色。 默认值：$r('sys.color.ohos_id_color_text_primary_activated')。 异常值按照默认值处理。

unselectedColor10+:设置多选框非选中状态边框颜色。

参数名	类型	必填	描述
value	ResourceColor	是	多选框非选中状态边框颜色。 默认值：'#33ffffff'。

mark10+:设置多选框内部图标样式。

参数名	类型	必填	描述
value	MarkStyle	是	多选框内部图标样式。 从API version 12开始，设置了indicatorBuilder时，按照indicatorBuilder中的内容显示。

shape11+:设置CheckBox组件形状, 包括圆形和圆角方形。

参数名	类型	必填	描述
value	CheckBoxShape	是	CheckBox组件形状, 包括圆形和圆角方形。 默认值：CheckBoxShape.CIRCLE

contentModifier12+:定制CheckBox内容区的方法。

参数名	类型	必填	说明
modifier	ContentModifier<CheckBoxConfiguration>	是	在CheckBox组件上，定制内容区的方法。 modifier: 内容修改器，开发者需要自定义class实现ContentModifier接口。

onChange :当选中状态发生变化时，触发该回调。

参数名	类型	必填	描述
value	boolean	是	返回true时，表示已选中。返回false时，表示未选中

实例代码:

@Builder conStyle1(num:number){Text(num<=99?num.toString():'99+').fontSize(num<=99?16:10)}@Builder CheckBox(){Row(){Text('爱好:')Checkbox({name:'ah',group:'hobby'}).select(true).selectedColor('red').unselectedColor('blue').mark({strokeColor:'#fcf',size:30,strokeWidth:3}).shape(CheckBoxShape.ROUNDED_SQUARE)Checkbox({name:'ah',group:'hobby',indicatorBuilder:()=>{this.conStyle()}})Checkbox({name:'ah',group:'hobby',indicatorBuilder:()=>{this.conStyle1(100)}})}Column(){Text('全选')CheckboxGroup({group:'ah'})}Row(){Checkbox({name:'c',group:'ah',})Text('唱')Checkbox({name:'c',group:'ah',})Text('跳')Checkbox({name:'c',group:'ah',})Text('rap')}
}

 

 五.CheckBoxGroup

多选框群组，用于控制多选框全选或者不全选状态。

属性:

selectAll:设置是否全选。若同组的Checkbox显式设置了select属性，则Checkbox的优先级高。

参数名	类型	必填	说明
value	boolean	是	是否全选。 默认值：false

 selectedColor:设置被选中或部分选中状态的颜色。

参数名	类型	必填	说明
value	ResourceColor	是	被选中或部分选中状态的颜色。 默认值：$r('sys.color.ohos_id_color_text_primary_activated') 异常值按照默认值处理。

unselectedColor10+:设置非选中状态边框颜色。

参数名	类型	必填	说明
value	ResourceColor	是	非选中状态边框颜色。 默认值：'#33ffffff'。

mark10+:设置多选框内部图标样式。

参数名	类型	必填	说明
value	MarkStyle	是	多选框内部图标样式。

checkboxShape12:设置CheckboxGroup组件形状， 包括圆形和圆角方形。

参数名	类型	必填	说明
value	CheckBoxShape	是	设置CheckboxGroup组件形状， 包括圆形和圆角方形。 默认值:CheckBoxShape.CIRCLE。 说明： CheckboxGroup组件形状按照设置显示。 CheckboxGroup内所有没有单独设置shape类型的Checkbox形状和CheckboxGroup的保持一致。 CheckboxGroup内有单独设置shape类型的Checkbox形状则优先于CheckboxGroup，按照设置形状显示。

六. ContainerSpan

Text组件的子组件，用于统一管理多个Span、ImageSpan的背景色及圆角弧度。

属性:

textBackgroundStyle:设置文本背景样式。子组件在不设置该属性时，将继承此属性值。

参数名	类型	必填	说明
style	TextBackgroundStyle	是	文本背景样式。 默认值： { color: Color.Transparent, radius: 0 }

示例代码:

  @Builder container(){Text(){SymbolSpan($r('sys.symbol.cinema'))ContainerSpan(){Span('文字')ImageSpan($r('app.media.app_icon')).height(30)}.textBackgroundStyle({color:'#abc',radius:5})}.width('100%')}

 七.DataPanel

数据面板组件，用于将多个数据占比情况使用占比图进行展示。

属性:

closeEffect:设置关闭数据占比图表旋转动效和投影效果

参数名	类型	必填	说明
value	boolean	是	关闭数据占比图表旋转动效和投影效果。 默认值：false

valueColors10+:设置各数据段颜色。

参数名	类型	必填	说明
value	Array<ResourceColor | LinearGradient>	是	各数据段颜色，ResourceColor为纯色，LinearGradient为渐变色。

 trackBackgroundColor10+:设置底板颜色。

参数名	类型	必填	说明
value	ResourceColor	是	底板颜色。 默认值：'#08182431'，格式为十六进制ARGB值，前俩位代表透明度

strokeWidth10+:设置圆环粗细。数据面板的类型为DataPanelType.Line时该属性不生效。

参数名	类型	必填	说明
value	Length	是	圆环粗细。 默认值：24 单位：vp 说明： 设置小于0的值时，按默认值显示。

 trackShadow10+:设置投影样式。

参数名	类型	必填	说明
value	DataPanelShadowOptions	是	投影样式。 说明： 设置null为不开启投影。

contentModifier12+:定制DataPanel内容区的方法。

参数名	类型	必填	说明
modifier	ContentModifier<DataPanelConfiguration>	是	在DataPanel组件上，定制内容区的方法。 modifier: 内容修改器，开发者需要自定义class实现ContentModifier接口。

 示例代码:

  @State ages:number[]=[18,19,18,18,19,20,16,22,25]@Builder DatePanelTest(){DataPanel({values:this.ages,max:300,type:DataPanelType.Circle})// .width(200).closeEffect(false)//动效开关.valueColors([Color.Blue,'#fcf','#ccc','#fbc','#fba',Color.Orange,Color.Yellow,]).trackBackgroundColor('green')//底板颜色.strokeWidth(50)//圆环粗细DataPanel({values:this.ages,max:300,type:DataPanelType.Line})}

八. CalendarPicker

日历选择器组件，提供下拉日历弹窗，可以让用户选择日期。

属性:

edgeAlign:设置选择器与入口组件的对齐方式。

参数名	类型	必填	说明
alignType	CalendarAlign	是	对齐方式类型。 默认值：CalendarAlign .END
offset	Offset	否	按照对齐类型对齐后，选择器相对入口组件的偏移量。 默认值：{dx: 0, dy: 0}

textStyle:入口区的文本颜色、字号、字体粗细。

参数名	类型	必填	说明
value	PickerTextStyle	是	设置入口区的文本颜色、字号、字体粗细。 默认值： { color: '#ff182431', font: { size: '16fp', weight: FontWeight.Regular } }

示例代码:

  now:Date=new Date('2023-08-09')@State selectDate:Date=new Date('2023-08-09')@Builder CalenderText(){Text('日期文本')CalendarPicker({hintRadius:10,//底板圆角0-16selected:this.now//默认选中的日期})// .edgeAlign(CalendarAlign.END,{dx:10,dy:20}).textStyle({color:'red',font:{size:19,weight:700}}).onChange((val)=>{this.selectDate=val})Text('选中的日期:'+this.selectDate)}

 

 九.DatePicker

日期选择器组件，用于根据指定日期范围创建日期滑动选择器。

属性:

lunar:设置弹窗的日期是否显示农历。

参数名	类型	必填	说明
value	boolean	是	日期是否显示农历。 - true：展示农历。 - false：不展示农历。 默认值：false

disappearTextStyle10+:设置所有选项中最上和最下两个选项的文本样式。

参数名	类型	必填	说明
value	PickerTextStyle	是	所有选项中最上和最下两个选项的文本颜色、字号、字体粗细。 默认值： { color: '#ff182431', font: { size: '14fp', weight: FontWeight.Regular } }

textStyle10+:设置所有选项中除了最上、最下及选中项以外的文本样式。

参数名	类型	必填	说明
value	PickerTextStyle	是	所有选项中除了最上、最下及选中项以外的文本颜色、字号、字体粗细。 默认值： { color: '#ff182431', font: { size: '16fp', weight: FontWeight.Regular } }

selectedTextStyle10+:设置选中项的文本样式。

参数名	类型	必填	说明
value	PickerTextStyle	是	选中项的文本颜色、字号、字体粗细。 默认值： { color: '#ff007dff', font: { size: '20vp', weight: FontWeight.Medium } }

PickerTextStyle10+类型说明

参数名	参数类型	必填	参数描述
color	ResourceColor	否	文本颜色。
font	Font	否	文本样式，picker只支持字号、字体粗细的设置。

实例代码:

  @Builder DatePickerTest(){DatePicker({start:new Date('2000-01-01'),end:new Date(),selected:new Date()}).lunar(true)//显示农历.disappearTextStyle({color:'red',font:{size:10,weight:FontWeight.Bold}}).textStyle({color:'green',font:{size:20,weight:FontWeight.Bold}}).selectedTextStyle({color:Color.Yellow,font:{size:30,weight:FontWeight.Bold}})
}

十. Divider

提供分隔器组件，分隔不同内容块/内容元素。

属性:

vertical:设置分割线的方向。

参数名	类型	必填	说明
value	boolean	是	使用水平分割线还是垂直分割线。 false：水平分割线；true：垂直分割线。 默认值：false

color:设置分割线的颜色。

参数名	类型	必填	说明
value	ResourceColor	是	分割线颜色。 默认值：'#33182431'

strokeWidth:设置分割线的宽度。

参数名	类型	必填	说明
value	number | string	是	分割线宽度。 默认值：1px 单位：vp 说明： 分割线的宽度不支持百分比设置。优先级低于通用属性height，超过通用属性设置大小时，按照通用属性进行裁切。

strokeWidth:设置分割线的宽度。

参数：

参数名	类型	必填	说明
value	number | string	是	分割线宽度。 默认值：1px 单位：vp 说明： 分割线的宽度不支持百分比设置。优先级低于通用属性height，超过通用属性设置大小时，按照通用属性进行裁切。

lineCap:设置分割线的端点样式。

参数名	类型	必填	说明
value	LineCapStyle	是	分割线的端点样式。 默认值：LineCapStyle.Butt

实例代码:

 Divider().width(60).height(100).vertical(true).color('red').strokeWidth(10).lineCap(LineCapStyle.Square)

十一: Gauge

数据量规图表组件，用于将数据展示为环形图表。

属性:

value:设置量规图的数据值。

参数名	类型	必填	说明
value	number	是	量规图的数据值，可用于动态修改量规图的数据值。 默认值：0

startAngle:设置起始角度位置。

参数名	类型	必填	说明
angle	number	是	起始角度位置，时钟0点为0度，顺时针方向为正角度。 默认值：0

endAngle:设置终止角度位置。

参数名	类型	必填	说明
angle	number	是	终止角度位置，时钟0点为0度，顺时针方向为正角度。 默认值：360

colors:设置量规图的颜色。

参数名	类型	必填	说明
colors	ResourceColor11+ | LinearGradient11+ | Array<[ResourceColor | LinearGradient11+ | number]>	是	量规图的颜色，支持分段颜色设置。 API version 9 默认值：Color.Black API version 11默认值： 若不传颜色，或者数组为空，无法确定圆环类型及颜色，则圆环颜色为"0xFF64BB5C"、"0xFFF7CE00"、"0xFFE84026"的渐变环。 若传入颜色，但颜色值有误，则该颜色为"0xFFE84026"。

 strokeWidth:设置环形量规图的环形厚度。

参数名	类型	必填	说明
length	Length	是	环形量规图的环形厚度。 默认值：4 单位：vp 说明： 设置小于0的值时，按默认值显示。 不支持百分比。

 description11+:设置说明内容。

参数名	类型	必填	说明
value	CustomBuilder	是	说明内容。 说明： @Builder中的内容由开发者自定义，建议使用文本或者图片。 若自定义部分的宽高为百分比形式，则基准范围为圆环直径的44.4%*25.4%的矩形（图片为28.6%*28.6%），距离圆环底部0vp，左右居中。 设置null则不显示内容。 不设置则依赖是否设置数据最大最小值。 若设置最大最小值或者只设置其中一个，则显示最大最小值。 若未设置最大最小值，则不显示内容。 最大最小值显示在圆环底部，位置不可移动，若圆环开口角度设置不恰当，存在圆环遮挡文字的情况。

trackShadow11+:设置阴影样式。

参数名	类型	必填	说明
value	GaugeShadowOptions	是	阴影样式。 说明： 阴影颜色与圆环颜色一致。 设置null为不开启投影。

 indicator11+:设置指针样式。

参数名	类型	必填	说明
value	GaugeIndicatorOptions	是	指针样式。 说明： 设置null则不显示指针。

privacySensitive12+:设置隐私敏感。

参数名	类型	必填	说明
isPrivacySensitiveMode	[Optional<boolean>]	是	设置隐私敏感，隐私模式下Gauge指针指向0位置，最大值最小值文本将被遮罩，量程显示灰色或者底色。 说明： 设置null则不敏感。 需要卡片框架支持。

 contentModifier12+:定制Slider内容区的方法。

参数名	类型	必填	说明
modifier	ContentModifier<GaugeConfiguration>	是	在Gauge组件上，定制内容区的方法。 modifier: 内容修改器，开发者需要自定义class实现ContentModifier接口。

示例代码:

  @Builder gaugeTest(){Gauge({value:50,min:0,max:100}){Text(`${this.num}%`).textAlign(TextAlign.Center).fontSize(30)}.value(this.num).startAngle(270)//起始角度.endAngle(90)//结束角度.colors(this.lColor).strokeWidth(20).description(this.cus(this.num)).trackShadow({radius:90,offsetX:10,offsetY:10}).indicator({icon:$r('sys.symbol.paperplane'),space:5})Gauge({value:50,min:0,max:100}).contentModifier(new myTest(this.num,100,0))Button('增加').onClick(()=>{this.num+=10})Button('减少').onClick(()=>{this.num-=10})}

十二.Image

Image为图片组件，常用于在应用中显示图片。

属性:

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

state:控制播放状态

参数名	类型	必填	说明
value	AnimationStatus	是	默认为初始状态，用于控制播放状态。 默认值：AnimationStatus.Initial

duration:设置播放时长。

参数名	类型	必填	说明
value	number	是	播放时长。 value为0时，不播放图片。 value的改变只会在下一次循环开始时生效。 单位：毫秒 默认值：1000ms

reverse:设置播放方向。

参数名	类型	必填	说明
value	boolean	是	播放方向。 false表示从第1张图片播放到最后1张图片，true表示从最后1张图片播放到第1张图片。 默认值：false

fixedSize:设置图片大小是否固定为组件大小。

参数名	类型	必填	说明
value	boolean	是	设置图片大小是否固定为组件大小。 true表示图片大小与组件大小一致，此时设置图片的width 、height 、top 和left属性是无效的。false表示每一张图片的width 、height 、top和left属性都要单独设置。 默认值：true

fillMode:设置当前播放方向下，动画开始前和结束后的状态。

参数名	类型	必填	说明
value	FillMode	是	当前播放方向下，动画开始前和结束后的状态。 默认值：FillMode.Forwards

iterations:设置播放次数。

参数名	类型	必填	说明
value	number	是	默认播放一次，设置为-1时表示无限次播放。 默认值：1

示例代码:

 @Builder imageTest(){ImageAnimator().images([{ src: $r('app.media.app_icon'),width:200,height:200,duration:1000,left:60,top:20},{ src: $r('app.media.app_icon'),width:200,height:200,duration:1000,left:60,top:20},{ src: $r('app.media.app_icon'),width:200,height:200,duration:1000,left:60,top:20},{ src: $r('app.media.app_icon'),width:200,height:200,duration:1000,left:60,top:20},{ src: $r('app.media.app_icon'),width:200,height:200,duration:1000,left:60,top:20},{ src: $r('app.media.app_icon'),width:200,height:200,duration:1000,left:60,top:20},{ src: $r('app.media.app_icon'),width:200,height:200,duration:1000,left:60,top:20}]).width('100%').state(this.state).reverse(true)//播放方向.fixedSize(false).fillMode(FillMode.Forwards).iterations(-1).onStart(()=>{console.log('开始了')}).onPause(()=>{console.log('暂停了')}).onRepeat(()=>{console.log('重复播放')}).onCancel(()=>{console.log('最初状态')}).onFinish(()=>{console.log('动画完成')})Button('初识').onClick(()=>{this.state=AnimationStatus.Initial})Button('开始').onClick(()=>{this.state=AnimationStatus.Running})Button('暂停').onClick(()=>{this.state=AnimationStatus.Paused})Button('停止').onClick(()=>{this.state=AnimationStatus.Stopped})}

十三.LoadingProgress

用于显示加载动效的组件。

属性:

color:设置加载进度条前景色。

参数名	类型	必填	说明
value	ResourceColor	是	加载进度条的前景色。 默认值： API version 10及以下：'#99666666' API version 11及以上：'#ff666666'

enableLoading10+:设置LoadingProgress动画显示或者不显示。

参数名	类型	必填	说明
value	boolean	是	LoadingProgress动画是否显示。 默认值：true

 contentModifier12+:定制LoadingProgress内容区的方法。

参数名	类型	必填	说明
modifier	ContentModifier<LoadingProgressConfiguration>	是	在LoadingProgress组件上，定制内容区的方法。 modifier: 内容修改器，开发者需要自定义class实现ContentModifier接口

 实例代码:

@Builder loadTest(){LoadingProgress().color('#fcf').width(30)// .enableLoading(false)Text('动画')}

十四. Marquee

跑马灯组件，用于滚动展示一段单行文本。仅当文本内容宽度超过跑马灯组件宽度时滚动，不超过时不滚动。

属性:

marqueeUpdateStrategy12+:跑马灯组件属性更新后，跑马灯的滚动策略。(当跑马灯为播放状态，且文本内容宽度超过跑马灯组件宽度时，该属性生效。)

参数名	类型	必填	说明
value	MarqueeUpdateStrategy	是	跑马灯组件属性更新后，跑马灯的滚动策略。 默认值: MarqueeUpdateStrategy.DEFAULT

示例代码:

 @Builder marqueeTest(){Marquee({start:true,step:3,loop:-1,fromStart:true,src:'这是滚动的文字恶化发u回复挥发分哈回复诶啊额护肤i啊好覅'+$r('app.media.app_icon')}).width(100).backgroundColor('#abcdef').marqueeUpdateStrategy(MarqueeUpdateStrategy.DEFAULT)}