【鸿蒙next开发】JS组件：容器组件（list-item）_鸿蒙 listitem 的宽度问题

 往期鸿蒙5.0全套实战文章必看：（文中附带鸿蒙5.0全栈学习资料）

• 鸿蒙开发核心知识点，看这篇文章就够了

• 最新版！鸿蒙HarmonyOS Next应用开发实战学习路线

• 鸿蒙HarmonyOS NEXT开发技术最全学习路线指南

• 鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）

---

list-item

说明

从API version 4开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

的子组件，用来展示列表具体item。由于父元素list组件的align-items默认样式为stretch，该组件宽度默认充满list组件。设置父元素list组件的align-items样式为非stretch来生效自定义宽度。

权限列表

无

子组件

支持单个子组件。

属性

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

名称 类型 默认值 必填 描述 type string default 否 list-item类型，默认值为default，同一list中可以包含多种type的list-item，相同type的list-item需要确保渲染后的视图布局也相同，如果type固定，则使用show属性代替if属性，确保视图布局不变。 primary boolean false 否 设置为true表示该item是group中的主item，即收拢时显示的item。如果有多个primary，以第一个为准。如果没有标记为primary的item，则以第一个item为主item。 section string - 否 当前item的匹配字符串，如不设置则为空。不支持动态修改。group内只有主item设置有效。 sticky string none 否

设置当前item是否为吸顶item以及其吸顶消失的效果，当前仅支持纵向list，group内部的item不可吸顶，设置该属性无效。

- none：当前item不吸顶。

- normal：当前item吸顶，消失效果滑动消失。

- opacity：当前item吸顶，消失效果渐隐消失，仅在智能穿戴上支持。

clickeffect5+ boolean true 否

设置当前item是否有点击动效。

- false：item点击时无点击动效。

- true：item点击时有点击动效。

样式

除支持通用样式外，还支持如下样式：

名称 类型 默认值 必填 描述 column-span 1 否 当前的list-item需要在list中占据的列的数量，默认占一列，仅在list为多列时生效。

事件

除支持通用事件外，还支持如下事件：

名称 参数 描述 sticky { state: boolean }

吸顶组件回调事件。

value: false表示当前item处于非吸顶状态；

value: true表示当前item处于吸顶状态；

说明：仅当item设置sticky属性时支持注册此事件。