SwiftUI 手势系统内部

Source: Dev.to

SwiftUI 手势在表面上看起来很简单：

.onTapGesture { }

但在内部，SwiftUI 拥有一个强大且分层的手势系统，用来决定：

• 哪个手势获胜
• 哪个手势失败
• 哪些手势可以同时运行
• 手势何时相互取消
• 手势如何在视图树中传播

大多数手势错误都是因为开发者不了解手势的优先级和解析方式。

本文将从引擎层面拆解 SwiftUI 手势的实际工作原理——帮助你构建可靠、可预测且复杂的交互。

🧠 核心手势模型

SwiftUI 手势遵循以下流程：

Touch input
   ↓
Hit‑testing
   ↓
Gesture recognition
   ↓
Gesture competition
   ↓
Resolution (win / fail / simultaneous)
   ↓
State updates

多个手势可以观察同一次触摸——但并非所有手势都会获胜。

🖐 1. 手势类型（SwiftUI）

SwiftUI 提供了几种原始手势：

• TapGesture
• LongPressGesture
• DragGesture
• MagnificationGesture
• RotationGesture

这些是值类型，组合到视图树中。

🧩 2. 手势附加在视图上 — 而非屏幕

Text("Hello")
    .onTapGesture { print("Tapped") }

此手势仅在视图被命中测试的区域内有效。

关键规则：
📌 如果视图没有尺寸或在命中测试中是透明的，则其手势不会触发。

使用 content shape 定义可点击区域：

.contentShape(Rectangle())

⚔️ 3. 手势竞争：谁获胜？

当多个手势检测到相同的触摸时，SwiftUI 按以下顺序解决它们：

1. 独占手势（默认）
2. 高优先级手势
3. 同时手势
4. 父手势

默认情况下，最深层的子手势获胜。

🥇 4. highPriorityGesture

Overrides child‑gesture precedence.

.view
    .highPriorityGesture(
        TapGesture().onEnded { print("Parent tap") }
    )

使用场景：

• 父视图必须拦截触摸。
• 子视图交互不能阻塞父视图逻辑。

警告： 如果过度使用，可能会破坏预期的用户体验。

🤝 5. simultaneousGesture

允许手势同时触发。

.view
    .simultaneousGesture(
        TapGesture().onEnded { print("Also tapped") }
    )

典型用法：

• 分析
• 触觉反馈
• 次要效果
• 记录交互

这 不会 阻塞其他手势。

🔗 6. 组合手势

SwiftUI 允许你显式地组合手势。

顺序（一个接一个）

LongPressGesture()
    .sequenced(before: DragGesture())

同时

TapGesture()
    .simultaneously(with: LongPressGesture())

排他

TapGesture()
    .exclusively(before: DragGesture())

这些组合器让你能够完全控制手势的流向。

📏 7. 手势状态 vs. 视图状态

使用 @GestureState 来保存临时的手势值。

@GestureState private var dragOffset = CGSize.zero

关键属性：

• 手势结束时会自动重置。
• 不会触发永久状态更新。
• 非常适合驱动动画。

示例：

DragGesture()
    .updating($dragOffset) { value, state, _ in
        state = value.translation
    }

📌 指南： 对于运动使用 @GestureState，对结果使用 @State。

🔄 8. 手势生命周期

每个手势都有阶段：

• .onChanged
• .onEnded
• .updating

在内部，手势可以：

• 失败
• 取消
• 重新启动

这就是为什么当手势的身份改变时，它们有时会感觉“跳动”。

🧱 9. 手势传播与视图标识

如果视图被重新创建：

• 手势会重新创建。
• 手势状态会重置。
• 正在进行的手势会被取消。

常见原因：

• 更改 id()
• 条件视图
• 列表标识问题
• 父视图失效

📌 稳定的标识 = 稳定的手势行为。

📜 10. ScrollView 与手势

ScrollView 拥有高优先级的拖拽手势，这意味着：

• 子视图的拖拽手势有时不会触发。
• 自定义滑动手势可能会出现异常。

解决方案：

• 使用 simultaneousGesture。
• 将手势附加到 overlay 上。
• 临时禁用滚动。
• 使用 gesture(_:including:) 包含子视图。

.gesture(drag, including: .subviews)

⚠️ 11. 常见手势错误（以及修复方法）

理解系统即可解决所有这些问题。

🧠 心智模型速查表

• 手势存在于 视图 上。
• 标识 很重要——稳定的 ID 能保持手势的稳定性。
• 默认情况下 子视图优先。
• 优先级 修饰符（highPriorityGesture、simultaneousGesture）会改变行为。
• 同时手势 不会相互阻塞。
• @GestureState 是 短暂的；@State 是持久的。
• ScrollView 对其自身的拖拽手势 非常激进。
• 布局会影响 命中测试。

🚀 最后思考

SwiftUI 手势并非魔法——它们是确定性的系统。
一旦你理解了：

• 竞争
• 优先级
• 身份
• 传播

你就能自信地构建可靠、复杂的交互。

ld:

• 滑动操作
• 自定义滑块
• 拖动关闭
• 多点触控交互
• 高级动画

…而不与 SwiftUI 冲突。