列表组件

应用场景

列表组件适用于统一展示多种样式但数据不同的内容，如商品分类、商品展示、评论发帖等。

列表设计

滚动方向

• 纵向：上下滚动
• 横向：左右滚动

纵向滚动	横向滚动

行/列数量

• 固定：直接填写数字
• 自动：根据屏幕宽度/项目宽度自动计算
• 填充剩余宽度：自动模式下生效，填满剩余空间

横向/纵向间距

设置行或列之间的间距。

刷新时滚动到顶部

当使用【刷新】行为刷新列表时，可以设置列表是否滚动到顶部

• 关闭： 默认，即刷新列表时不会滚动到顶部
• 主动刷新： 只希望在其他组件上配置并主动触发了【刷新】该列表的行为时，该列表会滚动到顶部，配置该选项
• 自动刷新： 只希望在列表设置了过滤条件，过滤条件发生变化时刷新列表内容时，该列表会滚动到顶部，配置该选项
• 全部打开： 无论是过滤条件变化，还是主动刷新该列表时都希望列表滚动到顶部时，配置该选项

表头

可在列表顶部区域放置其他组件，形成整体结构。

轮播

支持轮播模式，可设置自动播放、循环、指示器等。

反向加载

默认向下滑动加载更多，开启后可向上滑动加载。

样式

支持自定义透明度、圆角、背景色等。

子容器

拖入列表组件后，可在首行“在此处添加组件”区域配置子容器内容。

列表数据

一般通过远程数据请求获取，支持筛选、排序、去重等。

如何为列表绑定远程数据

选中列表后，点击内容，数据来源选择【远程数据】，数据表选择已在数据模型中创建好的数据表。

限额数量

设置单次请求的数据条数，提升加载体验。开启【加载更多】后，滑动至底部自动加载更多数据。

加载更多

默认开启，单次请求条数为 10 时，滑动到底部自动加载新数据，直至全部加载完毕。

数据筛选

可根据条件配置不同筛选规则，如价格排序、面积排序等。

配置示例	效果示例

取消过滤

不设置过滤条件时，读取全部数据（谨慎使用，建议设置过滤条件）。

过滤

通过设置条件筛选出符合要求的数据，如性别=男。

排序和去重

• 排序：设置排序字段及升/降序。开启去重时，排序字段需与去重字段一致。
• 去重：设置去重字段后，重复数据仅显示一条。

请求状态变化时

可配置请求状态变化（如载入、错误、成功等）时的行为，常用于用户提示或数据处理。

成功时

数据读取动作正常完成（无论有无数据）即为成功。可在此配置后续行为，如判断账号是否存在等。

如何为列表的每一项绑定数据

双击进入列表组件，向子视图拖入展示内容的组件（如文本），内容中点击【+】号，选择“组件内数据-列表-item-字段”进行绑定。

• index：当前项索引（从 0 开始）
• item：当前项数据对象，可选其字段展示

列表行为

可配置滚动、加载、点击等行为，实现丰富交互。