iOS 17中viewAligned模式ScrollView快速滑动跳视图问题求助

开发者阿泽

2026-7-11

解决iOS 17 ScrollView viewAligned 自动连续跳视图的问题

你遇到的是viewAligned滚动目标行为的默认动量滚动特性——当快速滑动时，ScrollView会利用动量自动对齐到后续的多个目标视图。要禁用这种自动连续跳转的行为，你可以通过自定义ViewAlignedScrollTargetBehavior并修改其动量行为配置来实现：

修改后的代码

@State private var colors: [Color] = Array(repeating: [.red, .orange, .yellow, .blue], count: 100)
// 自定义滚动目标行为，禁用动量驱动的连续对齐
private let customScrollBehavior = ViewAlignedScrollTargetBehavior()
    .momentumBehavior(.none)

ScrollView(.horizontal) {
    LazyHStack(spacing: 8) {
        // 修正原代码遍历逻辑：处理嵌套颜色数组的展示
        ForEach(colors, id: \.self) { colorGroup in
            HStack(spacing: 0) {
                ForEach(colorGroup, id: \.self) { color in
                    color
                        .containerRelativeFrame(.horizontal) { length, _ in
                            (length - 32) / CGFloat(colorGroup.count)
                        }
                }
            }
        }
    }
    .scrollTargetLayout()
    .padding(.horizontal, 8) // 替换原未定义的`spacing`变量
    .padding(.trailing, 16)
}
.scrollTargetBehavior(customScrollBehavior)

关键配置说明

momentumBehavior(.none)：关闭动量滚动时的自动连续对齐逻辑，仅在手动拖拽动作结束后，将最近的目标视图对齐到容器边界，避免快速滑动导致的连续跳视图问题。
若希望保留少量动量但限制单次跳转数量，可将.none替换为.paging，此配置会让动量滚动仅对齐到下一个目标视图，而非连续跳转多个。