list-item

About 8 min

list-item

<list>的子组件,用来展示列表具体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吸顶,消失效果渐隐消失,仅在智能穿戴上支持。

stickyradius

<length>

1000px

设置智能穿戴上吸顶item的圆弧效果半径,未设置时使用默认半径。sticky属性为none时,设置该属性无效。

clickeffect5+

boolean

true

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

  • false:item点击时无点击动效。
  • true:item点击时有点击动效。

样式

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

名称

类型

默认值

必填

描述

column-span

<number>

1

当前的list-item需要在list中占据的列的数量,默认占一列,仅在list为多列时生效。

事件

除支持通用事件外,还支持如下事件:

名称

参数

描述

sticky

{ state: boolean }

吸顶组件回调事件。

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

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

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

方法

支持通用方法

示例

详见List示例