名称	类型	默认值	必填	描述
scrollpage	boolean	false	否	设置为true时，将 list 顶部页面中非 list 部分随 list 一起滑出可视区域，当list方向为row时，不支持此属性。
cachedcount	number	0	否	长列表延迟加载时list-item最少缓存数量。可视区域外缓存的list-item数量少于该值时，会触发requestitem事件。
scrollbar	string	off	否	侧边滑动栏的显示模式（当前只支持纵向）： off：不显示。 auto：按需显示(触摸时显示，2s后消失)。 on：常驻显示。
scrolleffect	string	spring	否	滑动效果，目前支持如下滑动效果： spring：弹性物理动效，滑动到边缘后可以根据初始速度或通过触摸事件继续滑动一段距离，松手后回弹。 fade：渐隐物理动效，滑动到边缘后展示一个波浪形的渐隐，根据速度和滑动距离的变化渐隐也会发送一定的变化。 no：滑动到边缘后无效果。
indexer	boolean \| Array<string>	false	否	是否展示侧边栏快速字母索引栏。设置为true或者自定义索引时，索引栏会显示在列表右边界处。示例： "indexer" : "true"表示使用默认字母索引表。 "indexer" : "false"表示无索引。 "indexer" : ['#',‘1’,'2',‘3’,'4',‘5’,'6',‘7’,'8']表示自定义索引表。自定义时"#"必须要存在。说明： indexer属性生效需要flex-direction属性配合设置为column，且columns属性设置为1。点击索引条进行列表项索引需要list-item子组件配合设置相应的section属性。
indexercircle⁵⁺	boolean	-	否	是否为环形索引。穿戴设备默认为true，其他为false。indexer为false时不生效。
indexermulti⁵⁺	boolean	false	否	是否开启索引条多语言功能。 indexer为false时不生效。
indexerbubble⁵⁺	boolean	true	否	是否开启索引切换的气泡提示。 indexer为false时不生效。
divider⁵⁺	boolean	false	否	item是否自带分隔线。其样式参考样式列表的divider-color、divider-height、divider-length、divider-origin。
shapemode	string	default	否	侧边滑动栏的形状类型。 default：不指定，跟随主题； rect：矩形； round：圆形。
itemscale	boolean	true	否	焦点处理时，可以通过这个属性取消焦点进出的放大缩小效果。该效果仅在智能穿戴和智慧屏上生效。说明：仅在columns样式为1的时候生效。
itemcenter	boolean	false	否	初始化页面和滑动后页面总是有一个item处于视口交叉轴的中心位置。该效果仅在智能穿戴上生效。
updateeffect	boolean	false	否	用于设置当list内部的item发生删除或新增时是否支持动效。 false：新增删除item时无过渡动效。 true：新增删除item时播放过程动效。
chainanimation⁵⁺	boolean	false	否	用于设置当前list是否启用链式联动动效，开启后列表滑动以及顶部和底部拖拽时会有链式联动的效果。链式联动效果：list内的list-item间隔一定距离，在基本的滑动交互行为下，主动对象驱动从动对象进行联动，驱动效果遵循弹簧物理动效。 false：不启用链式联动 true：启用链式联动说明：不支持动态修改。如同时配置了indexer，链式动效不生效。如配置了链式动效，list-item的sticky不生效。
scrollvibrate	boolean	true	否	用于设置当list滑动时是否有振动效果，仅在智能穿戴场景生效，其他场景滑动无振动效果。 true：列表滑动时有振动效果。 false：列表滑动时无振动效果。
initialindex	number	0	否	用于设置当前List初次加载时视口起始位置显示的item，默认为0，即显示第一个item，如设置的序号超过了最后一个item的序号，则设置不生效，当同时设置了initialoffset属性时，当前属性不生效。当indexer为true或者scrollpage为true时，不生效。
initialoffset	<length>	0	否	用于设置当前List初次加载时视口的起始偏移量，偏移量无法超过当前List可滑动的范围，如果超过会被截断为可滑动范围的极限值。当indexer为true或者scrollpage为true时，不生效。
selected⁵⁺	string	-	否	指定当前列表中被选中激活的项，可选值为list-item的section属性值。

名称

类型

默认值

必填

描述

scrollpage

boolean

false

否

设置为true时，将 list 顶部页面中非 list 部分随 list 一起滑出可视区域，当list方向为row时，不支持此属性。

cachedcount

number

否

长列表延迟加载时list-item最少缓存数量。

可视区域外缓存的list-item数量少于该值时，会触发requestitem事件。

scrollbar

string

off

否

侧边滑动栏的显示模式（当前只支持纵向）：

off：不显示。
auto：按需显示(触摸时显示，2s后消失)。
on：常驻显示。

scrolleffect

string

spring

否

滑动效果，目前支持如下滑动效果：

spring：弹性物理动效，滑动到边缘后可以根据初始速度或通过触摸事件继续滑动一段距离，松手后回弹。
fade：渐隐物理动效，滑动到边缘后展示一个波浪形的渐隐，根据速度和滑动距离的变化渐隐也会发送一定的变化。
no：滑动到边缘后无效果。

indexer

boolean | Array<string>

false

否

是否展示侧边栏快速字母索引栏。设置为true或者自定义索引时，索引栏会显示在列表右边界处。示例：

"indexer" : "true"表示使用默认字母索引表。

"indexer" : "false"表示无索引。

"indexer" : ['#',‘1’,'2',‘3’,'4',‘5’,'6',‘7’,'8']表示自定义索引表。自定义时"#"必须要存在。

说明：

indexer属性生效需要flex-direction属性配合设置为column，且columns属性设置为1。
点击索引条进行列表项索引需要list-item子组件配合设置相应的section属性。

indexercircle⁵⁺

boolean

否

是否为环形索引。

穿戴设备默认为true，其他为false。indexer为false时不生效。

indexermulti⁵⁺

boolean

false

否

是否开启索引条多语言功能。

indexer为false时不生效。

indexerbubble⁵⁺

boolean

true

否

是否开启索引切换的气泡提示。

indexer为false时不生效。

divider⁵⁺

boolean

false

否

item是否自带分隔线。

其样式参考样式列表的divider-color、divider-height、divider-length、divider-origin。

shapemode

string

default

否

侧边滑动栏的形状类型。

default：不指定，跟随主题；
rect：矩形；
round：圆形。

itemscale

boolean

true

否

焦点处理时，可以通过这个属性取消焦点进出的放大缩小效果。该效果仅在智能穿戴和智慧屏上生效。

说明：

仅在columns样式为1的时候生效。

itemcenter

boolean

false

否

初始化页面和滑动后页面总是有一个item处于视口交叉轴的中心位置。该效果仅在智能穿戴上生效。

updateeffect

boolean

false

否

用于设置当list内部的item发生删除或新增时是否支持动效。

false：新增删除item时无过渡动效。
true：新增删除item时播放过程动效。

chainanimation⁵⁺

boolean

false

否

用于设置当前list是否启用链式联动动效，开启后列表滑动以及顶部和底部拖拽时会有链式联动的效果。链式联动效果：list内的list-item间隔一定距离，在基本的滑动交互行为下，主动对象驱动从动对象进行联动，驱动效果遵循弹簧物理动效。

false：不启用链式联动
true：启用链式联动
说明：
- 不支持动态修改。
- 如同时配置了indexer，链式动效不生效。
- 如配置了链式动效，list-item的sticky不生效。

scrollvibrate

boolean

true

否

用于设置当list滑动时是否有振动效果，仅在智能穿戴场景生效，其他场景滑动无振动效果。

true：列表滑动时有振动效果。
false：列表滑动时无振动效果。

initialindex

number

否

用于设置当前List初次加载时视口起始位置显示的item，默认为0，即显示第一个item，如设置的序号超过了最后一个item的序号，则设置不生效，当同时设置了initialoffset属性时，当前属性不生效。当indexer为true或者scrollpage为true时，不生效。

initialoffset

否

用于设置当前List初次加载时视口的起始偏移量，偏移量无法超过当前List可滑动的范围，如果超过会被截断为可滑动范围的极限值。当indexer为true或者scrollpage为true时，不生效。

selected⁵⁺

string

否

指定当前列表中被选中激活的项，可选值为list-item的section属性值。

名称	类型	默认值	必填	描述
divider-color⁵⁺	<color>	transparent	否	item分隔线颜色，仅当list的divider属性为true时生效。
divider-height⁵⁺	<length>	1	否	item分隔线高度，仅当list的divider属性为true时生效。
divider-length⁵⁺	<length>	主轴宽度	否	item分隔线长度，不设置时最大长度为主轴宽度，具体长度取决于divider-origin，仅当list的divider属性为true时生效。
divider-origin⁵⁺	<length>	0	否	item分隔线相对于item主轴起点位置的偏移量，仅当list的divider属性为true时生效。
flex-direction	string	column	否	设置flex容器主轴的方向，指定flex项如何放置在flex容器中，可选值为： column：主轴为纵向。 row：主轴为横向。其他组件默认值为row，在list组件中默认值为column。
columns	number	1	否	list交叉轴方向的显示列数，默认为1列。说明：设置多列时，在list交叉轴上进行均分，每一列大小相同。
align-items	string	stretch	否	list每一列交叉轴上的对齐格式，可选值为： stretch：弹性元素被在交叉轴方向被拉伸到与容器相同的高度或宽度。 flex-start：元素向交叉轴起点对齐。 flex-end：元素向交叉轴终点对齐。 center：元素在交叉轴居中。说明： align-items样式作用在每一列的子元素上，列与列之间采用均分方式布局。
item-extent	<length> \| <percentage>	-	否	设置内部item为固定大小，设置为百分比格式时，指相对于list的视口主轴方向长度的百分比。
fade-color	<color>	grey	否	设置渐隐物理动效的颜色。当滑动效果设置为渐隐物理动效时生效。
scrollbar-color⁶⁺	<color>	-	否	设置滚动条的颜色。
scrollbar-width⁶⁺	<length>	-	否	设置滚动条的宽度。
scrollbar-offset⁶⁺	<length>	0	否	设置滚动条距离List默认位置的偏移量，只支持正数，默认位置在List右边缘，可以通过这个偏移量调整滚动条的水平位置，如果滚动条绘制在list外部，而list父组件有裁剪，会导致滚动条被裁剪。

名称

类型

默认值

必填

描述

divider-color⁵⁺

<color>

transparent

否

item分隔线颜色，仅当list的divider属性为true时生效。

divider-height⁵⁺

否

item分隔线高度，仅当list的divider属性为true时生效。

divider-length⁵⁺

主轴宽度

否

item分隔线长度，不设置时最大长度为主轴宽度，具体长度取决于divider-origin，仅当list的divider属性为true时生效。

divider-origin⁵⁺

否

item分隔线相对于item主轴起点位置的偏移量，仅当list的divider属性为true时生效。

flex-direction

string

column

否

设置flex容器主轴的方向，指定flex项如何放置在flex容器中，可选值为：

column：主轴为纵向。
row：主轴为横向。

其他组件默认值为row，在list组件中默认值为column。

columns

number

否

list交叉轴方向的显示列数，默认为1列。

说明：

设置多列时，在list交叉轴上进行均分，每一列大小相同。

align-items

string

stretch

否

list每一列交叉轴上的对齐格式，可选值为：

stretch：弹性元素被在交叉轴方向被拉伸到与容器相同的高度或宽度。
flex-start：元素向交叉轴起点对齐。
flex-end：元素向交叉轴终点对齐。
center：元素在交叉轴居中。
说明：
align-items样式作用在每一列的子元素上，列与列之间采用均分方式布局。

item-extent

否

设置内部item为固定大小，设置为百分比格式时，指相对于list的视口主轴方向长度的百分比。

fade-color

<color>

grey

否

设置渐隐物理动效的颜色。当滑动效果设置为渐隐物理动效时生效。

scrollbar-color⁶⁺

<color>

否

设置滚动条的颜色。

scrollbar-width⁶⁺

否

设置滚动条的宽度。

scrollbar-offset⁶⁺

否

设置滚动条距离List默认位置的偏移量，只支持正数，默认位置在List右边缘，可以通过这个偏移量调整滚动条的水平位置，如果滚动条绘制在list外部，而list父组件有裁剪，会导致滚动条被裁剪。

名称	参数	描述
indexerchange⁵⁺	{ local: booleanValue }	多语言索引条切换事件，仅当indexer属性为true，indexermulti为true时生效。booleanValue可能值为true或者false： true: 当前展示本地索引。 false: 当前展示字母索引。
scroll	{ scrollX: scrollXValue, scrollY: scrollYValue, scrollState: stateValue }	列表滑动的偏移量和状态回调。 stateValue: 0表示列表滑动已经停止。 stateValue: 1表示列表正在用户触摸状态下滑动。 stateValue: 2表示列表正在用户松手状态下滑动。
scrollbottom	-	当前列表已滑动到底部位置。
scrolltop	-	当前列表已滑动到顶部位置。
scrollend	-	列表滑动已经结束。
scrolltouchup	-	手指已经抬起且列表仍在惯性滑动。
requestitem	-	请求创建新的list-item。长列表延迟加载时，可视区域外缓存的list-item数量少于cachedcount时，会触发该事件。
rotation⁷⁺	{ rotateValue: number }	返回表冠旋转角度增量值，仅智能穿戴支持。

名称

参数

描述

indexerchange⁵⁺

{ local: booleanValue }

多语言索引条切换事件，仅当indexer属性为true，indexermulti为true时生效。booleanValue可能值为true或者false：

true: 当前展示本地索引。
false: 当前展示字母索引。

scroll

{ scrollX: scrollXValue, scrollY: scrollYValue, scrollState: stateValue }

列表滑动的偏移量和状态回调。

stateValue: 0表示列表滑动已经停止。

stateValue: 1表示列表正在用户触摸状态下滑动。

stateValue: 2表示列表正在用户松手状态下滑动。

scrollbottom

当前列表已滑动到底部位置。

scrolltop

当前列表已滑动到顶部位置。

scrollend

列表滑动已经结束。

scrolltouchup

手指已经抬起且列表仍在惯性滑动。

requestitem

请求创建新的list-item。

长列表延迟加载时，可视区域外缓存的list-item数量少于cachedcount时，会触发该事件。

rotation⁷⁺

{ rotateValue: number }

返回表冠旋转角度增量值，仅智能穿戴支持。

名称	参数	描述
scrollTo	{ index: number(指定位置) }	list滑动到指定index的item位置。
scrollBy	ScrollParam	触发list滑动一段距离。智慧屏特有方法。
scrollTop	{ smooth: boolean }	smooth缺省为false，表示直接滚动到顶部。 smooth为true，表示平滑滚动到顶部。
scrollBottom	{ smooth: boolean }	smooth缺省为false，表示直接滚动到底部。 smooth为true，表示平滑滚动到底部。
scrollPage	{ reverse: boolean, smooth: boolean }	reverse缺省值为false，表示下一页，无完整页则滚动到底部。 reverse为true，表示上一页，无完整页则滚动到顶部。 smooth缺省值为false，表示直接滚动一页。 smooth为true，表示平滑滚动一页。
scrollArrow	{ reverse: boolean, smooth: boolean }	reverse缺省值为false，表示向底部方向滑动一段距离，无足够距离则滚动到底部。 reverse为true，表示向顶部方向滑动一段距离，无足够距离则滚动到顶部。 smooth缺省值为false，表示直接滚动。 smooth为true，表示平滑滚动。
collapseGroup	{ groupid: string }	收拢指定的group。 groupid：需要收拢的group的id。当groupid未指定时收拢所有的group。
expandGroup	{ groupid: string }	展开指定的group。 groupid：需要展开的group的id。当groupid未指定时展开所有的group。
currentOffset	-	返回当前滑动的偏移量。返回值类型是Object，返回值说明请见表2。

名称

参数

描述

scrollTo

{ index: number(指定位置) }

list滑动到指定index的item位置。

scrollBy

ScrollParam

触发list滑动一段距离。

智慧屏特有方法。

scrollTop

{ smooth: boolean }

smooth缺省为false，表示直接滚动到顶部。

smooth为true，表示平滑滚动到顶部。

scrollBottom

{ smooth: boolean }

smooth缺省为false，表示直接滚动到底部。

smooth为true，表示平滑滚动到底部。

scrollPage

{ reverse: boolean, smooth: boolean }

reverse缺省值为false，表示下一页，无完整页则滚动到底部。

reverse为true，表示上一页，无完整页则滚动到顶部。

smooth缺省值为false，表示直接滚动一页。

smooth为true，表示平滑滚动一页。

scrollArrow

{ reverse: boolean, smooth: boolean }

reverse缺省值为false，表示向底部方向滑动一段距离，无足够距离则滚动到底部。

reverse为true，表示向顶部方向滑动一段距离，无足够距离则滚动到顶部。

smooth缺省值为false，表示直接滚动。

smooth为true，表示平滑滚动。

collapseGroup

{ groupid: string }

收拢指定的group。

groupid：需要收拢的group的id。

当groupid未指定时收拢所有的group。

expandGroup

{ groupid: string }

展开指定的group。

groupid：需要展开的group的id。

当groupid未指定时展开所有的group。

currentOffset

返回当前滑动的偏移量。返回值类型是Object，返回值说明请见表2。

名称	类型	是否必选	默认值	备注
dx	number	否	0	水平方向滑动的偏移量，单位为px。
dy	number	否	0	垂直方向滑动的偏移量，单位为px。
smooth	boolean	否	true	列表位置跳转时是否有滑动动画。

名称

类型

是否必选

默认值

备注

number

否

水平方向滑动的偏移量，单位为px。

number

否

垂直方向滑动的偏移量，单位为px。

smooth

boolean

否

true

列表位置跳转时是否有滑动动画。

名称	类型	备注
x	number	当前x轴滑动偏移量，单位为px。
y	number	当前y轴滑动偏移量，单位为px。

名称

类型

备注

number

当前x轴滑动偏移量，单位为px。

number

当前y轴滑动偏移量，单位为px。