引子
在我们日常开发中,实现一个列表是非常常见的开发需求。那在 SwiftUI 中,我们如何去实现一个列表呢?
在 SwiftUI 中,是通过 List
组件来构建滚动表格视图的,功能类似于 UIKit 中的 UITableView
,但使用方式更加声明式与直观。
在本文中将会介绍 List
的基本用法和操作交互的内容,让我们开始吧!
基本使用
首先,我们来看一下静态列表的代码实现:
scss
List {
Text("苹果")
Text("香蕉")
Text("梨")
}
可以看到 List
组件的使用方式对比 UITableView
还是非常简洁的,只需要在里面放置内容组件就可以了。效果图如下:

当然,在日常开发场景中,静态列表是不多见的,更多的是需要我们根据数据构建动态列表。
首先,我们需要定义一个模型来表示数据,然后在初期的开发阶段我们还需要造一些本地数据来看页面效果。在没有 AI 工具之前,手动处理这些逻辑还是比较烦人的。但现在,我们可以在 Trae 中输入指令去自动生成模型和假数据。
比如,我们可以在 AI 对话流中选中 ContentView
,输入以下内容来生成模型:生成一个 Fruit 的结构体,包含字符串类型的 name、字符串类型的 color和 Int 类型的 count。遵循 Identifiable 协议。代码如下:
rust
// 定义 Fruit 结构体,遵循 Identifiable 协议
struct Fruit: Identifiable {
let id = UUID() // 自动生成唯一标识符
let name: String
let color: String
let count: Int
}
回车完成就可以看到 Trae
输出的内容,选择应用接受之后,代码就会自动写入到你的源文件中。
接着,在对话流中输入以下内容来生成假数据:用 Swift 生成一个长度为 10 的数组,元素类型为 Fruit。代码如下:
less
private let fruits: [Fruit] = (1...10).map { index in
Fruit(
name: "水果\(index)",
color: index % 2 == 0 ? "红色" : "绿色",
count: index
)
}
数据准备完成,我们就可以使用 List
组件来进行展示了,实例代码如下:
scss
List(fruits) { fruit in
HStack(spacing: 5) {
Text(fruit.name)
Text("颜色:\(fruit.color)")
Text(" 数量:\(fruit.count)")
}
}
效果图如下:

在真实的开发场景中,List
更多的是与 ForEach
来组合使用,示例代码如下:
scss
List {
ForEach(fruits) { fruit in
HStack(spacing: 5) {
Text(fruit.name)
Text("颜色:\(fruit.color)")
Text(" 数量:\(fruit.count)")
}
}
}
当然,静态和动态两种方式你也可以混合着用,示例代码如下:
scss
List {
Text("苹果")
Text("香蕉")
Text("梨")
ForEach(fruits) { fruit in
HStack(spacing: 5) {
Text(fruit.name)
Text("颜色:\(fruit.color)")
Text(" 数量:\(fruit.count)")
}
}
}
关于左滑删除和拖拽排序的功能,我们可以通过 ForEach
的两个操作符 onDelete
和 onMove
来实现,示例代码如下:
scss
// 第一步,fruits 用 @State 修饰
@State private var fruits: [Fruit] = ...
List {
ForEach(fruits) { fruit in
HStack(spacing: 5) {
Text(fruit.name)
Text("颜色:\(fruit.color)")
Text(" 数量:\(fruit.count)")
}
}
// 第二步添加相关操作符
.onDelete { indexSet in
fruits.remove(atOffsets: indexSet)
}
.onMove { indices, newOffset in
fruits.move(fromOffsets: indices, toOffset: newOffset)
}
}
效果图如下:
