HarmonyOS NEXT实战开发：ListItem组件

用来展示列表具体item，必须配合List来使用。

说明

• 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
• 该组件的父组件只能是List或者ListItemGroup。
• 当ListItem配合LazyForEach使用时，ListItem子组件在ListItem创建时创建。配合if/else、ForEach使用时，或父组件为List/ListItemGroup时，ListItem子组件在ListItem布局时创建。

子组件

可以包含单个子组件。

接口

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

ListItem10+

ListItem(value?: ListItemOptions)

元服务API： 从API version 11开始，该接口支持在元服务中使用。

参数：

ListItem(deprecated)

ListItem(value?: string)

从API version 10开始, 该接口不再维护，推荐使用ListItem10+。

参数：

属性

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

sticky(deprecated)

sticky(value: Sticky)

设置ListItem吸顶效果。

从API version9开始废弃不再使用，推荐使用List组件sticky属性。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

editable(deprecated)

editable(value: boolean | EditMode)

设置当前ListItem元素是否可编辑，进入编辑模式后可删除或移动列表项。

从API version9开始废弃不再使用，无替代接口。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

selectable8+

selectable(value: boolean)

设置当前ListItem元素是否可以被鼠标框选。外层List容器的鼠标框选开启时，ListItem的框选才生效。

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

元服务API： 从API version 11开始，该接口支持在元服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

selected10+

selected(value: boolean)

设置当前ListItem选中状态。该属性支持$$双