鸿蒙开发中Swiper容器组件常见属性介绍

常见属性

属性方法	传值	作用	默认值
loop	boolean	是否开启循环	true
autoPlay	boolean	是否自动播放	false
interval	number	自动播放的时间间隔（ms）	3000（不建议小于3s，常见的为3s~5s）
vertical	boolean	纵向滑动轮播	false
indicator	DotIndicator10+：圆点指示器样式、 DigitIndicator10+：数字指示器样式、 boolean：是否启用导航点指示器。设置为true启用，false不启用	设置可选导航点指示器样式	默认值：true 默认类型：DotIndicator

DotIndicator10+对象说明

参数名	参数类型	必填项	参数描述
itemWidth	Length	是	设置Swiper组件圆点导航指示器的宽，不支持设置百分比。 默认值：6 单位：vp
itemHeight	Length	是	设置Swiper组件圆点导航指示器的高，不支持设置百分比。 默认值：6 单位：vp
selectedItemWidth	Length	是	设置选中Swiper组件圆点导航指示器的宽，不支持设置百分比。 默认值：12 单位：vp
selectedItemHeight	Length	是	设置选中Swiper组件圆点导航指示器的高，不支持设置百分比。 默认值：6 单位：vp
mask	boolean	是	设置是否显示Swiper组件圆点导航指示器的蒙版样式。 默认值：false
color	ResourceColor	是	设置Swiper组件圆点导航指示器的颜色。 默认值：‘#182431（10%透明度）’
selectedColor	ResourceColor	是	设置选中Swiper组件圆点导航指示器的颜色。 默认值：‘#007DFF’
maxDisplayCount12+	number	是	设置圆点导航点指示器样式下，导航点显示个数最大值，当实际导航点个数大于导航点个数时，会生效超长效果样式。 默认值：没有默认值，如果设置异常值那等同于没有超长显示效果 取值范围：6~9 说明： 超长显示场景，目前暂时不支持交互功能（包括：手指点击拖拽、鼠标操作等）。 在超长显示场景下，中间页面对应的选中导航点的位置，并不是完全固定的，取决于之前的翻页操作序列。

DigitIndicator10+对象说明

参数名	参数类型	必填项	参数描述
fontColor	ResourceColor	是	设置Swiper组件数字导航点的字体颜色。 默认值：‘#ff182431’
selectedFontColor	ResourceColor	是	设置选中Swiper组件数字导航点的字体颜色。 默认值：‘#ff182431’
digitFont	{ size?: Length weight?: number、FontWeight、string }	是	设置Swiper组件数字导航点的字体样式。 size：数字导航点指示器的字体大小，不支持设置百分比。 默认值：14vp weight：数字导航点指示器的字重。 默认值：FontWeight.Normal
selectedDigitFont	{ size?: Length weight?: number、FontWeight、string }	是	设置选中Swiper组件数字导航点的字体样式。 size：数字导航点指示器的字体大小，不支持设置百分比。 默认值：14vp weight：数字导航点指示器的字重。 默认值：FontWeight.Normal

Length说明

类型	说明
string	需要显示指定像素单位，如'10px'，也可以设置百分比字符串，如'100%'。 说明：不指定像素单位时，默认单位vp。
number	默认单位vp。
Rescource	资源引用类型，引入系统资源或者应用资源中的尺寸。

ResourceColor说明

类型	说明
Color	颜色枚举值
number	HEX格式颜色，支持rgb或者argb。示例：0xffffff，oxffff0000。number无法识别传入位数，格式选择依据值的大小，例如0x00ffffff坐rgb格式解析。
string	rgb或者argb格式颜色。示例：#ffffff、#ff000000，rgb(255,100,255)，rgba(255,100,255,0.5)
Resource	使用引入资源的方式，引入系统资源或者应用资源中的颜色。

FontWeight说明

名称	描述
Lighter	字体较细
Normal	字体粗细正常
Regular	字体
Medium	字体粗细适中
Bold	字体较粗
Bolder	字体非常粗