循环展示
Repeater
适用场景
用于循环展示组件的场景,可将一个数组
循环展示在页面中,比如循环一个新闻列表。
注意:您需升级到最新的组件库,才可使用该组件。
基础能力说明
1. 循环数组并展示
拖入一个循环展示组件,默认带了一个文本,可以看到文本已循环展示了 3 次。
在示例中,文本组件展示了循环的 index 序号和
name
字段,是由于文本拼接了表达式绑定了index
和 name
字段。
2. 获取循环序号
在循环展示组件内,可获取当前循环展示的序号,如图:
应用示例
新建一个变量,类型为数组。一个数组类型的记录,并将数据展示出来。
首先新建变量list
,如下图:
然后将变量list
绑定到循环展示的属性【数据】上
=
在循环中拖入一个文本组件,打开表达式,在循环对象
中选择年龄,即可展示变量中的年龄信息,其他数据同理也可以获取。
属性
组件接收的外部传入的属性
属性名 | 属性标识 | 类型 | 说明 |
---|
数据 | data | array | 用于产生循环的数组数据 |
数据主键 | key | string | 以循环对象属性名为标识保存循环成员状态 |
属性 API
通过属性 API,可以获取组件内部的状态和属性值,可以通过$w.componentId.propertyName
来访问组件内部的值,如 $w.input1.value
,详请请参考 属性 API
只读属性名 | 属性标识 | 类型 | 说明 |
---|
循环数据 | data | array | 获取循环的数据 |
存量兼容通知
自 2023 年 1 月起,使用该组件需先升级最新组件库。 老版本的循环展示属性将不再继续支持,已配置的应用在运行态不受影响。