循环展示

Repeater

适用场景

用于循环展示组件的场景，可将一个数组循环展示在页面中，比如循环一个新闻列表。

注意：您需升级到最新的组件库，才可使用该组件。

基础能力说明

1. 循环数组并展示

拖入一个循环展示组件，默认带了一个文本，可以看到文本已循环展示了 3 次。

在示例中，文本组件展示了循环的 index 序号和 name 字段，是由于文本拼接了表达式绑定了index 和 name字段。

2. 获取循环序号

在循环展示组件内，可获取当前循环展示的序号，如图：

应用示例

新建一个变量，类型为数组。一个数组类型的记录，并将数据展示出来。

首先新建变量list，如下图：

然后将变量list绑定到循环展示的属性【数据】上

=

在循环中拖入一个文本组件，打开表达式，在循环对象中选择年龄，即可展示变量中的年龄信息，其他数据同理也可以获取。

属性

组件接收的外部传入的属性

属性名	属性标识	类型	说明

数据	data	array	用于产生循环的数组数据
数据主键	key	string	表示数据唯一的标识，如_id。可选项，当列表变化时，配置该项可保持组件状态不被重新创建。详见文档 以循环对象属性名为标识保存循环成员状态

属性 API

通过属性 API，可以获取组件内部的状态和属性值，可以通过$w.componentId.propertyName 来访问组件内部的值，如 $w.input1.value ，详请请参考 属性 API

只读属性名	属性标识	类型	说明

循环数据

data

array

获取循环的数据

存量兼容通知

自 2023 年 1 月起，使用该组件需先升级最新组件库。 老版本的循环展示属性将不再继续支持，已配置的应用在运行态不受影响。