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 | <length> \| <percentage><sup>5+</sup> | - | 否 | 设置组件自身的宽度。<br/>未设置时组件宽度默认为0。 | 39| height | <length> \| <percentage><sup>5+</sup> | - | 否 | 设置组件自身的高度。<br/>未设置时组件高度默认为0。 | 40| padding | <length> | 0 | 否 | 使用简写属性设置所有的内边距属性。<br/> 该属性可以有1到4个值:<br/>- 指定一个值时,该值指定四个边的内边距。<br/>- 指定两个值时,第一个值指定上下两边的内边距,第二个指定左右两边的内边距。- 指定三个值时,第一个指定上边的内边距,第二个指定左右两边的内边距,第三个指定下边的内边距。- 指定四个值时分别为上、右、下、左边的内边距(顺时针顺序)。 | 41| padding-[left\|top\|right\|bottom] | <length> | 0 | 否 | 设置左、上、右、下内边距属性。 | 42| border-width | <length> | 0 | 否 | 使用简写属性设置元素的所有边框宽度。 | 43| border-color | <color> | black | 否 | 使用简写属性设置元素的所有边框颜色。 | 44| border-radius | <length> | - | 否 | border-radius属性是设置元素的外边框圆角半径。 | 45| background-color | <color> | - | 否 | 设置背景颜色。 | 46| opacity<sup>5+</sup> | number | 1 | 否 | 元素的透明度,取值范围为0到1,1表示为不透明,0表示为完全透明。 | 47| display | string | flex | 否 | 确定一个元素所产生的框的类型,可选值为:<br/>- flex:弹性布局。<br/>- none:不渲染此元素。 | 48 49 50 51## 示例 52 53参考 [list示例](js-lite-components-container-list.md)