应用/搭建用户界面/网页端组件/横向列表
横向列表
更新于: 2026-06-25 17:18:51
横向列表组件是一种以横向列表形式展示数据项的布局工具,支持灵活添加组件、绑定数据和动态更新数据,以满足多样化的展示需求。它默认包含一个图片组件、一个容器组件和两个文本组件,你可根据业务需求自定义添加组件。
横向列表组件提供了丰富的属性配置选项,以下是一些关键属性配置说明。关于组件尺寸、位置、样式、指针、变换等通用属性的设置方法,请参考设置组件属性和事件。
横向列表组件支持绑定静态数据,或通过绑定工作流获取动态数据。
output)作为列表组件的数据源,该输出变量必须为 Array 类型。绑定工作流后,需要配置事件以触发工作流的调用,确保数据能够动态加载。
工作流输出变量
绑定数据源
配置事件
item 变量遍历和访问 Array 类型数据源中的每个元素。即你可以为列表组件中的各个子组件绑定具体的数据字段。例如为文本组件绑定数据字段 {{item.name}},为图片组件绑定数据字段 {{item.contentUrl}}。配置示例,请参考配置示例。说明
为图片组件绑定数据字段时,字段值需为图片地址,支持 jpg、png格式,暂不支持svg。
item 变量
为文本组件绑定数据字段
为图片组件绑定数据字段
横向列表组件以横向列表形式展示内容,支持通过设置间距值来调整各列表项之间的间隔,从而优化布局和视觉效果。
横向列表组件默认包含一个图片组件、一个容器组件和两个文本组件。你可以根据业务需求,在横向列表组件中自由添加其他组件或删除默认的子组件。当你在一个横向列表组件中添加或删除子组件时,其他列表块也会同步完成相同的操作。
例如在横向列表组件中,删除原有的文本组件,然后添加一个容器组件和一个图标组件。
横向列表组件的可见性可通过设置常用条件或表达式灵活控制,以实现特定场景下的隐藏或显示。
通过配置横向列表组件的事件,可以为横向列表组件添加丰富的交互功能,以增强用户体验和界面的互动性。
| 事件项 | 说明 |
|---|---|
|
事件类型 |
支持以下事件类型:
|
|
组件方法 |
支持以下组件方法:
|
例如想要在网页中以横向列表形式展示最近一周的科技新闻,则你可以创建一个搜索新闻的工作流,并通过横向列表组件展示。具体操作如下:
output 的值为头条新闻插件输出结果中的 news ,其为 Array 类型,包括新闻的标题、时间、图片、链接等信息。output 绑定到横向列表组件上。{{ item.cover }}。cover 字段值为新闻相关的图片 URL。{{ item.time }}。time 字段值为新闻时间。{{ item.summary }}。summary 字段值为新闻内容。