SwiftUI @AppStorage @State @Publ
@AppStorage 详解
@AppStorage 是 SwiftUI 中的一个属性包装器,用于在应用程序中存储和检索用户默认值。它可以用于将数据保存在应用程序的用户默认设置中,以便在应用程序的不同启动之间保留数据状态。以下是关于 @AppStorage 的详细解释:
声明和用法:
要使用 @AppStorage,您需要将其附加到您的属性上,如下所示:
@AppStorage("keyName") var someValue: Type = defaultValue
"keyName" 是存储属性的键,它在用户默认设置中唯一标识该属性。
someValue 是您要存储和检索的属性。
Type 是属性的数据类型。
defaultValue 是如果找不到与键关联的值时要使用的默认值。
示例:
下面是一个示例,演示如何使用 @AppStorage 存储和检索用户的设置:
struct ContentView: View {
@AppStorage("user_name") var username: String = "Guest"
var body: some View {
VStack {
Text("Hello, \(username)!")
Button("Change Username") {
username = "NewUser"
}
}
}
}
在上述示例中,username 属性使用 @AppStorage 进行存储和检索,它的键为 "user_name",默认值为 "Guest"。当用户点击 "Change Username" 按钮时,username 的值会更改,并且在应用程序的不同启动之间保留。
注意事项:
- @AppStorage 只能用于 SwiftUI 视图。
- 当属性的值更改时,它将自动更新视图。
- 存储的数据类型必须与属性的声明类型匹配。
- 您可以将 @AppStorage 用于基本数据类型(如 String、Int、Bool 等),但不能用于自定义类或结构体。
数据存储位置:
数据存储在应用程序的用户默认设置中,可以在 "UserDefaults" 中找到。您可以在 Xcode 的 "Product" 菜单下选择 "Scheme" -> "Edit Scheme" -> "Run" -> "Options" 中的 "Application Group" 设置中指定共享应用组,以使数据在不同应用之间共享。
总之,@AppStorage 是一个方便的属性包装器,可用于在 SwiftUI 中轻松地存储和检索用户默认设置。它适用于许多应用程序中需要持久化保存用户数据的情况。
@State 详解
@State 是 SwiftUI 中的一个属性包装器,用于在视图内部存储和管理可变的状态。它允许您声明一个属性,该属性的值的更改会触发视图的重新渲染。以下是关于 @State 的详细解释:
声明和用法:
要使用 @State,您需要将其附加到您的属性上,如下所示:
@State private var someValue: Type = initialValue
someValue 是您要在视图中存储的属性。
Type 是属性的数据类型。
initialValue 是属性的初始值。
示例:
下面是一个示例,演示如何在 SwiftUI 视图中使用 @State:
struct ContentView: View {
@State private var count: Int = 0
var body: some View {
VStack {
Text("Count: \(count)")
Button("Increment") {
count += 1
}
}
}
}
在上述示例中,count 属性使用 @State 进行存储,并且当用户点击 "Increment" 按钮时,count 的值会更改,从而触发视图的重新渲染。
注意事项:
1 .@State 属性必须声明为 private,以确保只有拥有视图的代码可以修改它。
- 属性的更改只会在包含该属性的视图内触发重新渲染,而不会影响其他视图。
- @State 属性通常用于存储视图内的临时状态,例如表单字段的文本或按钮的状态。
- 不要将 @State 用于全局或应用程序范围的状态。对于跨多个视图共享的状态,应该使用 @ObservedObject 或 @EnvironmentObject。
与@Binding的关系:
@Binding 是另一个属性包装器,通常与 @State 一起使用。它允许将视图的状态传递给其子视图,并在子视图内更改该状态。通常,您将通过在父视图中使用 @State 创建一个绑定,然后将绑定传递给子视图,以实现状态在多个视图之间的共享和更改。
总之,@State 是 SwiftUI 中用于存储和管理视图内部状态的关键属性包装器。它使您能够创建响应用户操作的交互式界面元素,并确保视图在状态更改时自动重新渲染。
@Published 详解
@Published 是 Swift 中的一个属性包装器,通常与 Combine 框架一起使用,用于创建可以发布(发布者)其更改的属性。它通常用于在 SwiftUI 中实现数据绑定,以便当数据发生更改时,视图可以自动更新。以下是关于 @Published 的详细解释:
声明和用法:
要使用 @Published,您需要将其附加到您的属性上,如下所示:
@Published var someValue: Type = initialValue
someValue 是您要发布的属性。
Type 是属性的数据类型。
initialValue 是属性的初始值。
示例:
下面是一个示例,演示如何在 SwiftUI 中使用 @Published:
import Combine
class UserData: ObservableObject {
@Published var name: String = "John"
}
在上述示例中,我们创建了一个名为 UserData 的类,它使用 @Published 将 name 属性发布为可观察对象。任何订阅了此可观察对象的视图都将在 name 属性更改时自动更新。
数据绑定:
@Published 通常用于 SwiftUI 中的数据绑定,允许视图自动反映属性的更改。在视图中,您可以使用 @ObservedObject 属性包装器来订阅可观察对象,并观察其中的 @Published 属性的更改。这样,当属性更改时,视图将自动重新渲染。
struct ContentView: View {
@ObservedObject var userData = UserData()
var body: some View {
Text("Hello, \(userData.name)!")
}
}
在上述示例中,ContentView 视图订阅了 UserData 可观察对象,以便在 name 属性更改时更新文本。
与 Combine 框架的关系:
@Published 属性包装器通常与 Combine 框架一起使用,因为它允许属性发布其更改,而 Combine 提供了处理和响应这些更改的工具。您可以使用 Combine 操作符来处理 @Published 属性的更改,例如过滤、映射、组合等。
总之,@Published 是 SwiftUI 中的一个关键属性包装器,用于创建可发布其更改的属性。它在数据绑定和响应式编程方面非常有用,使得 SwiftUI 应用程序可以轻松地管理和自动更新视图中的数据。
总结
在 Xcode 中遇到不太熟悉的属性,其实可以 「Alt + 鼠标点击」那个属性查看官方文档。官方文档注释很清晰了已经。这点苹果做得真不错。