SwiftUI中onPreferenceChange闭包为何在Preference未变更时触发?
SwiftUI onPreferenceChange 初始化时触发的原因分析
核心原因
你遇到的情况是SwiftUI偏好系统的正常行为,主要由以下几点导致:
首次渲染的默认触发逻辑
onPreferenceChange的设计逻辑是:在视图首次完成偏好值的传递后,无论值是否发生变化,都会自动执行一次闭包。这是为了让监听者能获取到初始的偏好值,而不是仅在后续值变更时才响应。即使你没有手动修改model,首次渲染时的初始偏好值传递也会触发闭包。引用类型作为偏好值的问题
你将ObservableObject(引用类型)作为PreferenceKey的关联类型,这违背了SwiftUI偏好系统的设计初衷——偏好值应当使用值类型(比如Color、String或自定义结构体):
- 你的
PreferenceKey的defaultValue每次调用都会生成一个全新的TargetedModifier1UIModel实例,和视图中传递的self.model是不同的引用对象; - 虽然你实现了
Equatable来比较属性值,但SwiftUI在处理偏好时,首次传递的新值(self.model)会被视为与默认值不同的“新状态”,从而触发onPreferenceChange。
- 不合理的反向修改逻辑(附带提醒)
你在onPreferenceChange闭包里直接修改model.color = self.color,这会触发@Published的属性变更通知,导致视图重新渲染,进而再次传递偏好值,存在潜在的循环更新风险。偏好系统的设计目的是子视图向上传递信息给父视图,而非反向修改子视图的数据源,这种写法需要修正。
修正建议
- 将偏好值改为值类型:比如直接传递
Color作为PreferenceKey的关联类型,而非整个ObservableObject实例; - 避免在
onPreferenceChange中修改数据源:如果需要修改model的属性,应该在父视图中根据偏好值的变化做处理,而非在修饰器的监听闭包里直接修改。
内容的提问来源于stack exchange,提问作者wimes
相关产品推荐
相关产品推荐

