ModelData

SwiftUI 为用户界面设计提供了一种声明性方法。当组成视图层次结构时，需要建立视图与数据依赖关系。当数据发生变化时，无论是由于外部事件还是由于用户执行的操作，SwiftUI 会自动更新界面的受影响的视图。

State

State 是一种属性包装器类型，可以读取和写入值来管理 SwiftUI 的视图。

使用 State 作为存储在视图层次结构中的给定值类型的单一真实来源。通过将 @State 属性应用于属性声明并提供初始值，在应用程序、场景或视图中创建状态值。将状态声明为私有状态，以防止在成员初始化器中将其设置。

1struct VisibleBtn: View {
2    @State private var isVisible: Bool = false
3    var body: some View {
4        Button(isVisible ? "隐藏" : "显示") {
5            isVisible.toggle()
6        }
7    }
8}

SwiftUI 管理 State 属性的存储。当 State 属性值发生变化时，SwiftUI会更新视图层次结构中依赖于该值的视图。要访问状态的底层值，请使用其 wrappedValue 属性。然而，作为快捷方式，Swift允许您通过直接引用状态实例来访问包装值。上述示例通过直接引用属性来读取和写入 isVisible 状态属性的包装值。

Warning

不要将 State 属性用于持久存储，因为 State 变量的生命周期反映了视图生命周期。相反，使用它们来管理只影响用户界面的瞬态状态，例如按钮的高亮显示状态、过滤器设置或当前选定的列表项。在准备更改应用程序的数据模型之前，您可能也会发现这种存储在原型时很方便。

Binding

Binding 是一种属性包装器类型，可以读取和写入值的引用。使用 @Binding 接收外部的属性值并绑定到自身属性上，从而建立双向绑定关系。

1struct VisibleBtn: View {
2    @Binding public var isVisible: Bool
3    var body: some View {
4        Button(isVisible ? "隐藏" : "显示") {
5            isVisible.toggle()
6        }
7    }
8}

当初始化子视图时，通过在 State 属性名称前加上 $ 符来访问 projectedValue 获取属性值的绑定，并将其传递到子视图中，完成绑定关系。不论是从子视图的外部还是内部修改绑定属性的值，与该属性值都会发生改变。

 1struct ContentView: View {
 2    @State private var isVisible: Bool = false
 3    var body: some View {
 4        VStack {
 5            VisibleBtn(isVisible: $isVisible)
 6            if isVisible {
 7                Text("Hello Text")
 8            }
 9        }
10    }
11}

ObservableObject

遵循 ObservableObject 的类可创建一个可观察对象。成员属性使用 @Published 属性包装器来标记。当属性值发生变化时，可观察对象会发布通知。SwiftUI 视图可以使用 @ObservedObject 属性包装器来订阅可观察对象的变化。

1class ObjectModel: ObservableObject {
2    @Published var name = "Some Name"
3    @Published var isEnabled = false
4}

StateObject

StateObject 是一个可观察对象的属性包装器类型。使用 @StateObject 在 App、Scene 和 View 内声明符合 ObservableObject 协议的状态对象。状态对象作为您存储在视图层次结构中的参考类型的单一真实来源。通过将属性应用于属性声明并提供符合ObservableObject协议的初始值。

1struct ObjectObservedView: View {
2    @StateObject private var model = ObjectModel()
3    var body: some View {
4        Text(model.name)
5        Text("\(model.isEnabled)")
6    }
7}

ObservedObject

ObservedObject 是一个可观察对象的属性包装器类型。使用 @ObservedObject 将符合 ObservableObject 协议的对象传递到视图中。当对象的发布属性发生变化时，视图会更新。

 1
 2struct ObjectObservedView: View {
 3    @StateObject private var model = ObjectModel()
 4    var body: some View {
 5        Text(model.name)
 6        Text("\(model.isEnabled)")
 7        MySubView(model: model)
 8    }
 9}
10
11struct MySubView: View {
12    @ObservedObject public var model: ObjectModel
13    var body: some View {
14        Toggle(model.isEnabled ? "关闭" : "开启", isOn: $model.isEnabled)
15    }
16}

Note

在可观察对象前使用 $ 访问可观察对象的属性，并将其绑定到视图控件中。

DynamicProperty

DynamicProperty 是 SwiftUI 框架中的一个协议，专门用于为自定义属性包装器提供状态管理和生命周期集成能力。它让你能创建自己的状态属性（如 @State、@ObservedObject、@EnvironmentObject、@Environment 等都是基于 DynamicProperty 的），这些属性能在视图生命周期内自动更新和保持一致。

SwiftUI 在每次视图更新时会自动调用 DynamicProperty 协议的 update() 方法，让你的属性能在视图变更时同步状态。