基础
Charts 是 iOS 16/macOS 13 的新特性,用于构建各种精美的图表,如柱状图、散点图、曲线图等。
> 查看示例
Charts 是一个独立的标准库,使用之前需要导入它:
Chart 构建方法和 List 类似,支持直接从数据源构建,也可以嵌套 ForEach 使用。
以柱状图为例,先定义如下数据源:
1
2
3
4
5
6
7
8
9
10
11
12
|
private let data: [Storage] = [
.init(category: "Apps", sizes: 22.3),
.init(category: "Photos", sizes: 35.8),
.init(category: "System", sizes: 19.8),
.init(category: "Others", sizes: 39.1),
]
private struct Storage: Identifiable {
let id = UUID()
var category: String
var sizes: Double
}
|
然后使用 Chart 构建:
1
2
3
4
5
6
|
Chart(data, id: \.id) { v in
BarMark(
x: .value("Category", v.category),
y: .value("Sizes", v.sizes)
)
}
|
图表的尺寸由系统自动适配,也可以使用 .frame 设置。
假设现在需要将 Apple 多个设备的存储进行可视化展现,可以将数据源作如下修改:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
private let data: [Storage] = [
.init(category: "Apps", sizes: 22.3, device: "iPhone"),
.init(category: "Photos", sizes: 35.8, device: "iPhone"),
.init(category: "System", sizes: 19.8, device: "iPhone"),
.init(category: "Others", sizes: 39.1, device: "iPhone"),
.init(category: "Apps", sizes: 18.3, device: "iPad"),
.init(category: "Photos", sizes: 5.8, device: "iPad"),
.init(category: "System", sizes: 22.8, device: "iPad"),
.init(category: "Others", sizes: 12.3, device: "iPad"),
.init(category: "Apps", sizes: 80.8, device: "Mac"),
.init(category: "Photos", sizes: 25.6, device: "Mac"),
.init(category: "System", sizes: 39.5, device: "Mac"),
.init(category: "Others", sizes: 100.2, device: "Mac"),
]
private struct Storage: Identifiable {
let id = UUID()
var category: String
var sizes: Double
var device: String
}
|
构建图表时作一些自定义设置:
1
2
3
4
5
6
7
8
9
10
11
12
|
Chart(data, id: \.id) { v in
BarMark(
x: .value("Sizes", v.sizes),
y: .value("Category", v.category)
)
.foregroundStyle(by: .value("Device", v.device))
}
.chartForegroundStyleScale([
"iPhone" : .blue,
"iPad" : .yellow,
"Mac" : .purple
])
|
foregroundStyle(by:) 可以设置指定数据类型的样式,默认由系统自动分配样式。
使用 chartForegroundStyleScale(_:) 之后,表示不使用系统自动分配的样式,而是为 foregroundStyle(by:) 指定的数据类型自定义样式。
Chart 内可以叠加使用不同样式的图表,比如示例中的步数图(StepsChart),就同时使用了 LineMark、AreaMark、PointMark、RuleMark。
Charts 支持高度的自定义,比如:
.foregroundStyle:设置前景样式。
.interpolationMethod:设置插值样式,适用于 LineMarks、AreaMarks。
.lineStyle:设置线条样式,适用于 LineMarks、RuleMarks。
.annotation:设置注释。
.chartLegend:设置图例。
- ……
StepsChart 支持手势交互,这里说一下思路,核心代码如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
|
@State private var selectedStep: (String, Int)? = ("1/15", 10876)
Chart {
...
if let selectedStep {
RuleMark(x: .value("Selected Date", selectedStep.0))
.foregroundStyle(.blue)
.lineStyle(.init(lineWidth: 2, dash: [5, 5]))
PointMark(
x: .value("Selected Date", selectedStep.0),
y: .value("Selected Count", selectedStep.1)
)
.foregroundStyle(.blue)
.annotation {
Text(selectedStep.1.formatted())
.font(.footnote)
.foregroundColor(.white)
.padding(3)
.background(.blue)
.cornerRadius(5)
}
}
}
.chartOverlay { chartProxy in
GeometryReader { geometryProxy in
Rectangle()
.fill(.clear)
.contentShape(Rectangle())
.gesture(
DragGesture()
.onChanged { value in
findSelectedStep(
at: value.location,
chartProxy: chartProxy,
geometryProxy: geometryProxy
)
}
)
.onTapGesture { location in
findSelectedStep(
at: location,
chartProxy: chartProxy,
geometryProxy: geometryProxy
)
}
}
}
private func findSelectedStep(
at location: CGPoint,
chartProxy: ChartProxy,
geometryProxy: GeometryProxy
) {
let origin = geometryProxy[chartProxy.plotAreaFrame].origin
// 当前位置
let location = CGPoint(
x: location.x - origin.x,
y: location.y - origin.y
)
// 获取当前位置对应的数据
if var step: (String, Int) = chartProxy.value(at: location) {
step.1 = data.first { $0.date == step.0 }?.count ?? 0
selectedStep = step
}
printLog(selectedStep)
}
|
.chartOverlay 可以为图表添加一个浮层,这里使用了 GeometryReader 用于获取手势的位置,并且添加了一个透明的矩形区域承载点击和拖拽手势。
闭包内返回的是一个 ChartProxy 类型的实例,通过它可以获取到图表的尺寸、位置等信息。这里使用如下方法获取到手势当前位置对应的数据:
1
2
3
|
if var step: (String, Int) = chartProxy.value(at: location) {
...
}
|
需要注意的是,这里获取的数据类型需要和图表的 x、y 轴的数据类型保持一致,否则是获取不到数据的。
现在我们已经知道手势的具体位置和对应的数据了,剩下的工作就是将其展示出来,这里使用的是现成的RuleMark 和 PointMark 。当然,方法不止这一种,比如还可以使用 .chartOverlay 或者 .chartBackground 来实现。
示例中只演示了 Charts 的部分功能,更多特性望读者自行探索。Github 上有个仓库提供了关于 Charts 的丰富样例,可供参考:Swift-Charts-Example 。
饼图与交互
这里并非有意将饼图单独介绍,而是因为它只支持 iOS 17/macOS 14,下文的滑动列表亦是如此。
饼图的实现和上文的图表并无二致,唯一的区别是使用 SectorMark,它表示的是一个扇形区域。下面的代码是从示例中截取的部分代码,它表示的是将一个圆分成四个扇形,每个扇形的角度由 Storage 实例属性 sizes 决定。
这里面有些需要注意的细节:
chartAngleSelection 是新增的 API,用于获取手指所处区域的扇形累计角度,也就是说,手指落在某个扇形上时,获取的不是对应扇形的 sizes,而是所有 sizes 总和乘以手指所在点对应的扇形角度。比如下面的代码,圆形被分为四份(22.3,35.8,19.8,39.1),其总和为 117,那么 Apps 对应的扇形所占的圆形区域为 22.3/117,它也是第一个扇形,默认从 12 点方向开始沿顺时针方向延展。假设手指正好落在第一个扇形的中心区域,那么 selection 的值就是 22.3 * 0.5,如果正好落在第三个扇形的中心区域,则获取的值为 22.3 + 35.8 + 19.8 * 0.5。
chartAngleSelection 获取的值是跟随手指实时变化的,如果手指离开了屏幕,则变为 nil。因此这里声明了一个属性 selectedStorage 来保存当前获取的扇形区域,根据上面提到的“累计角度”,可以计算出当前手指落在了那个扇形区域,这也是 findSelectedStorage 方法的内在逻辑。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
|
private let data: [Storage] = [
.init(category: "Apps", sizes: 22.3),
.init(category: "Photos", sizes: 35.8),
.init(category: "System", sizes: 19.8),
.init(category: "Others", sizes: 39.1),
]
private struct Storage: Identifiable, Equatable {
let id = UUID()
var category: String
var sizes: Double
}
@State private var selection: Double?
@State private var selectedStorage: Storage?
Chart(data, id: \.category) { element in
SectorMark(
angle: .value("Sizes", element.sizes)
)
}
.chartAngleSelection(value: $selection)
.onChange(of: selection) { oldValue, newValue in
if let newValue {
let newSelectedStorage = findSelectedStorage(value: newValue)
if selectedStorage == newSelectedStorage {
selectedStorage = nil
} else {
selectedStorage = newSelectedStorage
}
}
}
private func findSelectedStorage(value: Double) -> Storage? {
var total = 0.0
let ans = data.first { v in
total += v.sizes
return value <= total
}
return ans
}
|
iOS 17/macOS 14 简化了 Charts 的交互,除了上面提到的 chartAngleSelection,还有针对具有 X/Y 轴图表获取点或者范围的方法:chartXSelection 和 chartYSelection,详见文档。
除此以外,SectorMark 还支持自定义扇形的半径、内径、外径等,具体效果见示例。
可滑动图表
iOS 17/macOS 14 对 Charts 的另一大更新就是支持滑动,在此之前,要基于 Charts 实现一个滑动图表非常繁琐,而且容易导致性能问题。
现在只需要在原有的图表基础上添加一个方法 chartScrollableAxes(_:) 就能使其滑动,以下是示例代码:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
Chart {
ForEach(data, id: \.date) { v in
BarMark(
x: .value("Date", v.date, unit: .day),
y: .value("Steps", v.count)
)
.foregroundStyle(.pink)
.annotation {
Text(selectedStep(v))
}
}
}
.frame(height: 160)
.chartScrollableAxes(.horizontal)
.chartXVisibleDomain(length: Self.secondsPerDay * 7)
.chartScrollPosition(initialX: initialPosition)
.chartScrollPosition(x: $scrollPosition)
.chartScrollTargetBehavior(.paging)
.chartXSelection(value: $selection)
.onChange(of: selection) { oldValue, newValue in
selection = newValue
}
|
以下是对新增的一些 API 的说明:
- chartScrollableAxes:设置滑动的方向。
- chartXVisibleDomain:设置可见区域,
Self.secondsPerDay * 7 表示可以展示 7 天的数据。
- chartScrollPosition(initialX:):设置图表的初始位置。
- chartScrollPosition(x:):获取图表滚动的位置,更改绑定的值也能触发图表滚动至指定位置。
- chartScrollTargetBehavior:设置图表的滚动方式,和 ScrollView 是一样的。
- chartXSelection:图表的选择,与上文提到的
chartAngleSelection 是类似的。