跳到主要内容

循环展示

Repeater

适用场景#

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

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

基础能力说明#

1. 循环数组并展示#

拖入一个循环展示组件,默认带了一个文本和示例数据,可以看到文本已循环展示了 2 次。

点击循环数据,可打开表达式查看示例数据详情。

在示例中,文本组件展示了循环 name 字段,是由于文本通过表达式绑定了name字段。

2. 获取循环序号#

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

3. 修改数组并循环任意组件#

使用时,只按修改按照实际情况修改数组,如添加img字段:

然后往内部添加任意子组件(如图片等其他任意组件),绑定对应的字段,即可展示数据信息:

应用示例#

数据列表是查询数组的数据组件,当数据容器将数据查询结果返回后,会用循环展示组件将数据循环呈现出来。

属性#

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

属性名
属性标识
类型
属性分组
默认值
说明
循环数据dataarray基础属性null用于产生循环的数组数据
循环标识keystring基础属性""以循环对象属性名为标识保存循环成员状态

属性 API#

通过属性 API,可以获取组件内部的状态和属性值

只读属性名
属性标识
类型
说明
循环数据dataarray获取循环的数据

存量兼容通知#

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