openharmony 鸿蒙 js-service-widget-container-list-item

2025-06-12 浏览 (1)

list-item

<list>的子组件,用来展示列表具体item。

说明:

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

  • 由于父元素list组件的align-items默认样式为stretch,该组件宽度默认充满list组件。设置父元素list组件的align-items样式为非stretch来生效自定义宽度。

  • list-item组件开发避免长按和拖动操作。

子组件

支持。

属性

除支持通用属性外,还支持如下属性:

名称类型默认值必填描述
typestringdefaultlist-item类型,默认值为default,同一list中可以包含多种type的list-item,相同type的list-item需要确保渲染后的视图布局也相同,如果type固定,则使用show属性代替if属性,确保视图布局不变。
sectionstring-当前item的匹配字符串,如不设置则为空。不支持动态修改。group内只有主item设置有效。
stickystringnone设置当前item是否为吸顶item以及其吸顶消失的效果,当前仅支持纵向list,group内部的item不可吸顶,设置该属性无效。
- none:当前item不吸顶。
- normal:当前item吸顶,消失效果滑动消失。
- opacity:当前item吸顶,消失效果渐隐消失,仅在智能穿戴上支持。
clickeffectbooleantrue设置当前item是否有点击动效。
- false:item点击时无点击动效。
- true:item点击时有点击动效。

样式

除支持通用样式外,还支持如下样式:

名称类型默认值必填描述
column-span<number>1当前的list-item需要在list中占据的列的数量,默认占一列,仅在list为多列时生效。
click-color<color>-设置列表项按压点击时的背板颜色。

事件

支持通用事件

示例

详见list示例

你可能感兴趣的鸿蒙文章

harmony 鸿蒙JS服务卡片UI组件

harmony 鸿蒙数据类型说明

harmony 鸿蒙button

harmony 鸿蒙calendar

harmony 鸿蒙chart

harmony 鸿蒙clock

harmony 鸿蒙divider

harmony 鸿蒙image

harmony 鸿蒙input

harmony 鸿蒙progress

  • 所属分类: 后端技术
  • 本文标签: 鸿蒙 软件
  • 版权声明: 本文链接 https://seaxiang.com/blog/V0ePUm