Appearance
纵向列表
纵向列表组件用于纵向展示数据项的列表视图,纵向列表组件默认包含两个文本组件,你可以通过拖放组件,将目标组件拖动至纵向列表组件中。
属性设置
纵向列表组件提供了丰富的属性配置选项,以下是一些关键属性配置说明。关于组件尺寸、位置、样式、指针、变换等通用属性的设置方法,请参考设置组件属性和事件。
绑定数据源
为纵向列表组件支持绑定静态数据,或通过绑定工作流获取动态数据。
为纵向列表组件绑定一个 Array 类型的数据源。
- 例如将工作流的输出变量(例如
output)作为列表组件的数据源,该输出变量必须为 Array 类型。绑定工作流后,需要配置事件以触发工作流的调用,确保数据能够动态加载。
为纵向列表组件中的各个子组件绑定具体的数据字段。
绑定数据源后,你可以通过
item变量遍历和访问 Array 类型数据源中的每个元素。即你可以为列表组件中的各个子组件绑定具体的数据字段。例如为文本组件绑定数据字段{{item.name}},为图片组件绑定数据字段{{item.contentUrl}}。具体示例,请参考配置示例。说明
为图片组件绑定数据字段时,字段值需为图片地址,支持上传
jpg、png格式,暂不支持svg。
设置列数及间距
支持通过间距值设置每个列表项之间的间距。
调整组件
纵向列表组件默认包含一个图片组件、一个容器组件和两个文本组件。你可以根据业务需求,在纵向列表组件中自由添加其他组件或删除默认的子组件。当你在一个列表项中添加或删除子组件时,其他列表项中也会同步完成相同的操作。
例如在纵向列表组件中,删除原有的文本组件,然后添加一个图标组件。
隐藏组件
纵向列表组件的可见性可通过设置常用条件或表达式灵活控制,以实现特定场景下的隐藏或显示。
表达式方式
设置为 false:显示组件。
设置为 true:隐藏组件。
设置为变量:通过变量值(true 或 false)动态控制组件的可见性。配置示例,请参考隐藏组件。
常用条件方式
支持通过可视化界面设置条件,以控制组件的可见性。配置示例,请参考隐藏组件。
事件设置
通过配置纵向列表组件的事件,可以为纵向列表组件添加丰富的交互功能,以增强用户体验和界面的互动性。
| 事件项 | 说明 |
|---|---|
| 事件类型 | 支持以下事件类型: 点击单元格时:当用户点击纵向列表组件中的单元格时触发。 加载时:当组件完成加载时触发。 |
| 组件方法 | 设置隐藏:隐藏组件,使其不可见。 |
配置示例
例如想要在小程序中以纵向列表形式展示最近一周的科技新闻,则你可以创建一个搜索新闻的工作流,并通过纵向列表组件展示。具体操作如下:
创建工作流。
- 使用头条新闻插件(getToutiaoNews)搜索新闻。其中,在结束节点中,设置输出变量
output的值为头条新闻插件输出结果中的news,其为 Array 类型,包括新闻的标题、时间、图片、链接等信息。
绑定数据。
将工作流的输出变量 output 绑定到纵向列表组件上。
为纵向列表组件添加调用工作流事件。
- 例如配置事件为纵向列表组件加载时,即调用工作流,搜索新闻。
为纵向列表组件中的图片组件绑定数据字段 {{ item.cover }}。
cover字段值为新闻相关的图片 URL。
为纵向列表组件中的文本组件(Text3)绑定数据字段 {{ item.time }}。
time字段值为新闻时间。
为纵向列表组件中的文本组件(Text4)绑定数据字段 {{ item.summary }}。
summary字段值为新闻内容。
预览效果。
- 小程序以纵向列表形式展示新闻内容。
当前版本实操
本页使用独立的 纵向列表 示例页面,页面内不混放其他组件。
- 进入低代码应用的 用户界面,确认搭建类型为 小程序和 H5。
- 单击画布底部的 新建页面,创建一个空白页面。
- 在左侧 组件 面板中找到 纵向列表,单击或拖入当前页面。
- 切换到 结构 面板,确认该页面只包含当前 纵向列表 组件。
- 选中组件,在右侧 属性 面板中检查列表方向、数据绑定、列表项内容和间距。
- 检查画布中的实际显示效果,再使用页面顶部的预览入口验证交互。

