鸿蒙ArkTS容器组件：【List】

List

列表包含一系列相同宽度的列表项。适合连续、多行呈现同类数据，例如图片和文本。

说明：
开发前请熟悉鸿蒙开发指导文档：gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。

• 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
• 该组件回弹的前提是要有滚动。内容小于一屏时，没有回弹效果。

子组件

仅支持[ListItem]、[ListItemGroup]子组件。

说明：

List的子组件的索引值计算规则：

按子组件的顺序依次递增。

if/else语句中，只有条件成立的分支内的子组件会参与索引值计算，条件不成立的分支内子组件不计算索引值。

ForEach/LazyForEach语句中，会计算展开所有子节点索引值。

[if/else]、[ForEach]和[LazyForEach]发生变化以后，会更新子节点索引值。

ListItemGroup作为一个整体计算一个索引值，ListItemGroup内部的ListItem不计算索引值。

List子组件visibility属性设置为Hidden或None依然会计算索引值。

List子组件的visibility属性设置为None时不显示，但该子组件上下的space还会生效。

接口

List(value?:{space?: number | string, initialIndex?: number, scroller?: Scroller})

从API version 9开始，该接口支持在ArkTS卡片中使用。

参数：

参数名	参数类型	必填	参数描述
space	number	string	否
initialIndex	number	否	设置当前List初次加载时视口起始位置显示的item的索引值。 默认值：0 说明： 设置为负数或超过了当前List最后一个item的索引值时视为无效取值，无效取值按默认值显示。
scroller	[Scroller]	否	可滚动组件的控制器。用于与可滚动组件进行绑定。 说明： 不允许和其他滚动类组件绑定同一个滚动控制对象。

属性

除支持[通用属性]外，还支持以下属性：

名称	参数类型	描述
listDirection	[Axis]	设置List组件排列方向。 默认值：Axis.Vertical 从API version 9开始，该接口支持在ArkTS卡片中使用。
divider	{ strokeWidth: [Length], color?:[ResourceColor], startMargin?: Length, endMargin?: Length }	null
scrollBar	[BarState]	设置滚动条状态。 默认值：BarState.Off 从API version 9开始，该接口支持在ArkTS卡片中使用。 说明： API version 9及以下版本默认值为BarState.Off，API version 10的默认值为BarState.Auto。
cachedCount	number	设置列表中ListItem/ListItemGroup的预加载数量，只在[LazyForEach]中生效，其中ListItemGroup将作为一个整体进行计算，ListItemGroup中的所有ListItem会一次性全部加载出来。具体使用可参考[减少应用白块说明]。 默认值：1 从API version 9开始，该接口支持在ArkTS卡片中使用。 说明： 单列模式下，会在List显示的ListItem前后各缓存cachedCount个ListItem。 多列模式下， 会在List显示的ListItem前后各缓存cachedCount*列数个ListItem。
edgeEffect	[EdgeEffect]	设置组件的滑动效果，支持弹簧效果和阴影效果。 默认值：EdgeEffect.Spring 从API version 9开始，该接口支持在ArkTS卡片中使用。
chainAnimation	boolean	设置当前List是否启用链式联动动效，开启后列表滑动以及顶部和底部拖拽时会有链式联动的效果。链式联动效果：List内的list-item间隔一定距离，在基本的滑动交互行为下，主动对象驱动从动对象进行联动，驱动效果遵循弹簧物理动效。 默认值：false - false：不启用链式联动。 - true：启用链式联动。 从API version 9开始，该接口支持在ArkTS卡片中使用。 说明： 链式动效生效后，List的分割线不显示。 链式动效生效需要满足以下前提条件： -  List边缘效果为Spring类型 -  List没有启用多列模式
multiSelectable8+