• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# list-item
2
3
4<[list](js-service-widget-container-list.md)>的子组件,用来展示列表具体item。
5
6
7>  **说明:**
8>
9> 从API Version 8 开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
10> - 由于父元素list组件的align-items默认样式为stretch,该组件宽度默认充满list组件。设置父元素list组件的align-items样式为非stretch来生效自定义宽度。
11>
12> - list-item组件开发避免长按和拖动操作。
13
14
15## 子组件
16
17支持。
18
19
20## 属性
21
22除支持[通用属性](js-service-widget-common-attributes.md)外,还支持如下属性:
23
24| 名称 | 类型 | 默认值 | 必填 | 描述 |
25| -------- | -------- | -------- | -------- | -------- |
26| type | string | default | 否 | list-item类型,默认值为default,同一list中可以包含多种type的list-item,相同type的list-item需要确保渲染后的视图布局也相同,如果type固定,则使用show属性代替if属性,确保视图布局不变。 |
27| section | string | - | 否 | 当前item的匹配字符串,如不设置则为空。不支持动态修改。group内只有主item设置有效。 |
28| sticky | string | none | 否 | 设置当前item是否为吸顶item以及其吸顶消失的效果,当前仅支持纵向list,group内部的item不可吸顶,设置该属性无效。<br/>-&nbsp;none:当前item不吸顶。<br/>-&nbsp;normal:当前item吸顶,消失效果滑动消失。<br/>-&nbsp;opacity:当前item吸顶,消失效果渐隐消失,仅在智能穿戴上支持。 |
29| clickeffect | boolean | true | 否 | 设置当前item是否有点击动效。<br/>-&nbsp;false:item点击时无点击动效。<br/>-&nbsp;true:item点击时有点击动效。 |
30
31
32## 样式
33
34除支持[通用样式](js-service-widget-common-styles.md)外,还支持如下样式:
35
36| 名称 | 类型 | 默认值 | 必填 | 描述 |
37| -------- | -------- | -------- | -------- | -------- |
38| column-span | &lt;number&gt; | 1 | 否 | 当前的list-item需要在list中占据的列的数量,默认占一列,仅在list为多列时生效。 |
39| click-color | &lt;color&gt; | - | 否 | 设置列表项按压点击时的背板颜色。 |
40
41
42## 事件
43
44支持[通用事件](js-service-widget-common-events.md)。
45
46
47## 示例
48
49详见[list示例](js-service-widget-container-list.md#示例)。
50