鸿蒙（HarmonyOS）项目方舟框架（ArkUI）之List容器组件

最新推荐文章于 2025-08-11 11:58:52 发布

原创

最新推荐文章于 2025-08-11 11:58:52 发布 · 932 阅读

CC 4.0 BY-SA版权

文章标签：

鸿蒙（HarmonyOS）项目方舟框架（ArkUI）之List容器组件

操作系统: Windows 10 专业版、IDE:DevEco Studio 3.1、SDK:HarmonyOS 3.1

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

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

参数名	参数类型	必填	参数描述
space	number \| string	否	子组件主轴方向的间隔。默认值：0 说明：设置为除-1外其他负数或百分比时，按默认值显示。 space参数值小于List分割线宽度时，子组件主轴方向的间隔取分割线宽度。
initialIndex	number	否	设置当前List初次加载时视口起始位置显示的item的索引值。默认值：0 说明：设置为除-1外其他负数或超过了当前List最后一个item的索引值时视为无效取值，无效取值按默认值显示。
scroller	Scroller	否	可滚动组件的控制器。用于与可滚动组件进行绑定。说明：不允许和其他滚动类组件绑定同一个滚动控制对象。

参数名

参数类型

必填

参数描述

space

number | string

否

子组件主轴方向的间隔。

默认值：0

说明：

设置为除-1外其他负数或百分比时，按默认值显示。

space参数值小于List分割线宽度时，子组件主轴方向的间隔取分割线宽度。