1# list-item
2
3<[list](js-lite-components-container-list.md)>的子组件,用来展示列表具体item。
4
5> **说明:**
6>
7> 该组件从从API version 4 开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
8
9
10## 子组件
11
12支持。
13
14
15## 属性
16
17| 名称 | 类型 | 默认值 | 必填 | 描述 |
18| -------- | -------- | -------- | -------- | -------- |
19| id | string | - | 否 | 组件的唯一标识。 |
20| style | string | - | 否 | 组件的样式声明。 |
21| class | string | - | 否 | 组件的样式类,用于引用样式表。 |
22| ref | string | - | 否 | 用来指定指向子元素的引用信息,该引用将注册到父组件的$refs 属性对象上。 |
23
24
25## 事件
26
27| 名称 | 参数 | 描述 |
28| -------- | -------- | -------- |
29| click | - | 点击动作触发该事件。 |
30| longpress | - | 长按动作触发该事件。 |
31| swipe<sup>5+</sup> | [SwipeEvent](js-lite-common-events.md) | 组件上快速滑动后触发。 |
32
33
34## 样式
35
36| 名称 | 类型 | 默认值 | 必填 | 描述 |
37| -------- | -------- | -------- | -------- | -------- |
38| width | &lt;length&gt;&nbsp;\|&nbsp;&lt;percentage&gt;<sup>5+</sup> | - | 否 | 设置组件自身的宽度。<br/>未设置时组件宽度默认为0。 |
39| height | &lt;length&gt;&nbsp;\|&nbsp;&lt;percentage&gt;<sup>5+</sup> | - | 否 | 设置组件自身的高度。<br/>未设置时组件高度默认为0。 |
40| padding | &lt;length&gt; | 0 | 否 | 使用简写属性设置所有的内边距属性。<br/>&nbsp;&nbsp;该属性可以有1到4个值:<br/>-&nbsp;指定一个值时,该值指定四个边的内边距。<br/>-&nbsp;指定两个值时,第一个值指定上下两边的内边距,第二个指定左右两边的内边距。-&nbsp;指定三个值时,第一个指定上边的内边距,第二个指定左右两边的内边距,第三个指定下边的内边距。-&nbsp;指定四个值时分别为上、右、下、左边的内边距(顺时针顺序)。 |
41| padding-[left\|top\|right\|bottom] | &lt;length&gt; | 0 | 否 | 设置左、上、右、下内边距属性。 |
42| border-width | &lt;length&gt; | 0 | 否 | 使用简写属性设置元素的所有边框宽度。 |
43| border-color | &lt;color&gt; | black | 否 | 使用简写属性设置元素的所有边框颜色。 |
44| border-radius | &lt;length&gt; | - | 否 | border-radius属性是设置元素的外边框圆角半径。 |
45| background-color | &lt;color&gt; | - | 否 | 设置背景颜色。 |
46| opacity<sup>5+</sup> | number | 1 | 否 | 元素的透明度,取值范围为0到1,1表示为不透明,0表示为完全透明。 |
47| display | string | flex | 否 | 确定一个元素所产生的框的类型,可选值为:<br/>-&nbsp;flex:弹性布局。<br/>-&nbsp;none:不渲染此元素。 |
48
49
50
51## 示例
52
53参考 [list示例](js-lite-components-container-list.md)