跳到主要内容

SwiftUI 滚动效果怎么选:视图动画、可见性与滚动状态

· 阅读需 4 分钟
GoSwiftUI
goswiftui.com

给列表卡片加淡入、让视频离屏后暂停、滚过首屏再显示返回顶部按钮,看起来都在追踪滚动,实际需要的是三种不同的信息。Natalia Panferova 的文章给了一个实用的判断方法:先问谁需要知道滚动了,再选 API。

本文是中文摘要解读,并非完整译文。

只改滚动项的外观,不必把偏移量存起来​

卡片在滚动区域边缘变淡、进入后恢复,用 scrollTransition 就够了。它让你为进入、离开和正常显示定义不同的视觉效果,默认可以随滚动位置在这些效果之间插值。要做的如果是“离容器中心越远,卡片里的图像偏移越多”,则用 visualEffect 读取视图在滚动容器里的位置,不必把它近似成几个阶段。

这两种方式改的是附加视图的外观,不改变它在布局中占的空间,也不需要为了滚动而写入共享状态。若希望旁边的卡片真的重新排版,就不能把视觉偏移当成布局调整。

动作由可见性或几何变化触发,区别在于你需要什么信息​

视频何时应该暂停,通常只取决于它是否还露出足够面积。给它加 onScrollVisibilityChange,传入所需阈值,在回调里处理播放或暂停即可。若要在列表层统一追踪哪些条目可见,用 scrollTargetLayout 标记目标布局,再用 onScrollTargetVisibilityChange 接收可见项 ID。

如果滚动要驱动列表外的控件,例如超过首屏后显示工具栏里的返回顶部按钮,用 onScrollGeometryChange 更合适。它可以读偏移、容器尺寸和边距,但回调只在你派生出的 Equatable 值变化时触发。按钮只关心显不显示,就返回 Bool,而不是把每次变化的原始偏移量写进状态。

本站建议:先验收边界,再加动效​

用同一份列表测试三件事:初次打开时已经可见的项目是否正确响应;在阈值附近来回滚动时是否反复启动播放或请求;快速滚到顶部和底部触发回弹时,列表外的控件是否闪动。若阈值依据滚动距离计算,也要换一种安全区或内容边距配置重测,别把初始偏移默认为零。

博文来源​