数据流与状态管理 on LYon's Blog

objectWillChange.send() 使用场景详解

Fri, 27 Jun 2025 00:00:00 +0000

在 SwiftUI 中，objectWillChange.send() 是 ObservableObject 协议的核心方法，用于通知 SwiftUI 视图模型中的数据即将发生变化。以下是详细的用法说明和实际场景：

观察者模式引起的无限递归问题

Mon, 28 Apr 2025 00:00:00 +0000

SwiftUI 的 @Observable 宏能让数据变更自动触发 UI 更新，但在某些场景下会导致严重的无限循环问题：

@Observable 
class DataManager {
 var data: [String: Int] = [:]
 
 func calculateValue(for key: String) -> Int {
 let result = performCalculation()
 data[key] = result // 这里修改了被观察的属性
 return result
 }
}

当视图依赖 calculateValue 方法时，每次视图刷新都会执行该方法，导致 data 字典被修改，这又会触发新一轮视图刷新，形成无限循环。

ObservableObject

Wed, 16 Apr 2025 00:00:00 +0000

在 SwiftUI 中，将 @MainActor 与 ObservableObject 结合使用是一种常见的做法，主要是为了 确保线程安全 和 简化 UI 更新逻辑。以下是具体原因和解释：

1. 为什么 `ObservableObject` 需要 `@MainActor`？#

(1) UI 更新必须在主线程#

SwiftUI 的所有界面更新（如刷新 @Published 属性绑定的视图）必须发生在主线程。
如果 ObservableObject 的 @Published 属性在后台线程被修改，会导致运行时警告（甚至崩溃）。

(2) `ObservableObject` 的默认线程不安全#

默认情况下，ObservableObject 不限制线程，它的 @Published 属性可能被任意线程修改。
例如：网络请求回调、数据库操作可能在后台线程中触发属性修改。

(3) 使用 `@MainActor` 的解决方案#

通过将整个 ObservableObject 标记为 @MainActor：

Observable

Mon, 10 Mar 2025 00:00:00 +0000

Observable 协议和 SwiftData 的关系#

在 SwiftUI 中，数据模型（Model Data）的设计和持久化与 Observable 协议以及 SwiftData 密切相关。以下是它们的核心关系和实现逻辑：

1. 为什么需要 `Observable`？#

Observable 是 SwiftUI 中用于实现数据驱动 UI 更新的关键机制。它的作用包括：

Bindable 与 Observable

Tue, 04 Feb 2025 00:00:00 +0000

Bindable#

在 SwiftUI 中，@Bindable 是一个属性包装器（Property Wrapper），用于创建可绑定的状态。它通常与 @Observable 结合使用，允许你将模型数据与视图绑定，从而实现数据的双向绑定。

SwiftUI 中的 @Binding 与自定义绑定

Mon, 27 Jan 2025 00:00:00 +0000

在 SwiftUI 中，@Binding 类型的初始化需要特别处理。以下是完整的实现方案：

1. 正确初始化 Binding 属性的方法#

import SwiftUI

// 父视图
struct ParentView: View {
 @State private var text: String = "初始值"
 
 var body: some View {
 VStack {
 Text("父视图的值: \(text)")
 ChildView(boundText: $text) // 传递绑定
 }
 }
}

// 子视图（接受 Binding）
struct ChildView: View {
 @Binding var boundText: String
 private var customText: String
 
 // 初始化方法
 init(boundText: Binding<String>) {
 // 正确初始化绑定属性（使用下划线访问属性包装器的原始值）
 self._boundText = boundText
 
 // 其他初始化逻辑
 self.customText = "处理后的值: \(boundText.wrappedValue)"
 }
 
 var body: some View {
 VStack {
 Text(customText)
 TextField("输入新值", text: $boundText)
 .padding()
 .border(Color.gray)
 
 Button("重置为初始值") {
 boundText = "初始值"
 }
 }
 }
}

2. 手动创建自定义 Binding#

如果需要创建自定义逻辑的 Binding：

Binding

Wed, 22 Jan 2025 00:00:00 +0000

在 SwiftUI 中，Binding 是用来创建双向数据绑定的核心机制，允许一个视图能够读写绑定数据。这种双向绑定使得视图和数据模型（@State、@EnvironmentObject 等）能够保持同步。

PreferenceKey

Wed, 15 Jan 2025 00:00:00 +0000

什么是 `PreferenceKey`？#

PreferenceKey 是 SwiftUI 中用于在视图树中向上传递数据的机制。即 PreferenceKey 提供了一种从子视图向父视图传递数据的方式。

PreferenceKey 的作用#

数据向上传递（向父视图传递数据）

onPreferenceChange

Sat, 11 Jan 2025 00:00:00 +0000

`onPreferenceChange` 是什么？#

在 SwiftUI 中，onPreferenceChange 是一个修饰符，用于监听由 PreferenceKey 定义的值的变化。它允许在 子视图树中定义一些值 并向父视图传递这些值，父视图可以通过 onPreferenceChange 捕获这些值的变化并做出相应的调整。

FocusState

Wed, 08 Jan 2025 00:00:00 +0000

FocusState 的介绍#

FocusState 是 SwiftUI 中用于管理 键盘焦点状态 的工具，始于 iOS 15+ 和 macOS 12+。它专门用于在多输入框场景中控制某个输入组件（如 TextField 或 SecureField）的焦点状态，或者在程序中让特定的输入字段成为焦点。

ObservedObject

Sun, 27 Oct 2024 00:00:00 +0000

1. `@State` 和 `@Binding`#

https://developer.apple.com/documentation/swiftui/state

@State 是 SwiftUI 中用于声明本地状态变量的属性包装器。任何使用到 @State 变量的视图，当该变量变化时，都会重新渲染。

import SwiftUI

struct ContentView: View {
 @State private var counter = 0
 
 var body: some View {
 VStack {
 Text("Counter: \(counter)")
 Button(action: {
 counter += 1
 }) {
 Text("Increment Counter")
 }
 }
 }
}

@Binding 用于在不同视图之间传递和共享 @State 数据，使得一个视图可以绑定到另一个视图的状态。