感知
为不官方支持观察的平台提供观察工具。
了解更多
这个库由Brandon Williams和Stephen Celis创建,他们是Point-Free视频系列的主持人,该系列探讨高级Swift语言概念。
概述
Perception库提供了模仿Swift 5.9中@Observable
和withObservationTracking
的工具,但它们被移植回iOS 13、macOS 10.15、tvOS 13和watchOS 6。这意味着你现在就可以开始利用Swift 5.9的观察工具,即使你不能放弃对旧版Apple平台的支持。使用这个库的工具几乎与使用官方工具完全相同,只有一个小异常。
首先,使用@Perceptible
宏而不是@Observable
宏来标记一个类为可观察的:
@Perceptible
class FeatureModel {
var count = 0
}
然后你可以在你的视图中使用常规的let
属性来持有一个可感知的模型:
struct FeatureView: View {
let model: FeatureModel
// ...
}
在视图的body
中,你必须使用WithPerceptionTracking
视图包装你的内容,以便正确设置观察:
struct FeatureView: View {
let model: FeatureModel
var body: some View {
WithPerceptionTracking {
Form {
Text(model.count.description)
Button("增加") { model.count += 1 }
}
}
}
}
不得不用WithPerceptionTracking
包装视图的内容确实有些不便,但如果你忘记了,你会收到一个有用的运行时警告,告诉你观察没有正确设置:
🟣 运行时警告:访问了可感知状态但未被追踪。通过将视图包装在'WithPerceptionTracking'视图中来追踪状态变化。
Bindable
SwiftUI的@Bindable
属性包装器也被移植以支持可感知对象。你可以简单地用Perception
模块限定属性包装器:
struct FeatureView: View {
@Perception.Bindable var model: FeatureModel
// ...
}
Environment
SwiftUI的@Environment
属性包装器和environment
视图修饰符对观察的支持也被移植以支持可感知对象,使用完全相同的API:
struct FeatureView: View {
@Environment(Settings.self) var settings
// ...
}
// 在某个父视图中:
.environment(settings)
社区
如果你想讨论这个库或有关于如何使用它解决特定问题的疑问,有几个地方可以与其他Point-Free爱好者讨论:
- 对于长篇讨论,我们推荐使用这个仓库的discussions标签。
- 对于随意聊天,我们推荐Point-Free社区Slack。
文档
Perception API的最新文档可在这里找到。
许可证
这个库在MIT许可下发布。详情请见LICENSE。