手势响应系统
手势响应系统管理你应用中手势的生命周期。一次触摸可以经历多个阶段,因为应用需要确定用户的意图。例如,应用需要确定触摸是滚动、在小部件上滑动还是点击。这甚至可以在触摸的持续时间内发生变化。也可能存在多个同时发生的触摸。
触摸响应系统是必要的,以允许组件协商这些触摸交互,而无需任何关于其父组件或子组件的额外知识。
最佳实践
为了使你的应用体验良好,每个操作都应具有以下属性
- 反馈/高亮 - 向用户展示什么在处理他们的触摸,以及当他们释放手势时会发生什么
- 可取消性 - 在执行操作时,用户应该能够通过拖动手指离开来在中途取消它
这些功能使用户在使用应用时更加舒适,因为它允许人们在不担心犯错的情况下进行实验和互动。
TouchableHighlight 和 Touchable*
响应者系统可能使用起来很复杂。因此,我们为应该“可点击”的事物提供了一个抽象的 Touchable
实现。这使用了响应者系统,并允许你声明式地配置点击交互。在任何你会在 web 上使用按钮或链接的地方使用 TouchableHighlight
。
响应者生命周期
一个视图可以通过实现正确的协商方法来成为触摸响应者。有两种方法询问视图是否想成为响应者
View.props.onStartShouldSetResponder: evt => true,
- 此视图是否希望在触摸开始时成为响应者?View.props.onMoveShouldSetResponder: evt => true,
- 当视图不是响应者时,在视图上的每次触摸移动时调用:此视图是否想要“声明”触摸响应?
如果视图返回 true 并尝试成为响应者,则会发生以下情况之一
View.props.onResponderGrant: evt => {}
- 视图现在正在响应触摸事件。这是高亮并向用户展示正在发生的事情的时候View.props.onResponderReject: evt => {}
- 其他东西现在是响应者,并且不会释放它
如果视图正在响应,则可以调用以下处理程序
View.props.onResponderMove: evt => {}
- 用户正在移动他们的手指View.props.onResponderRelease: evt => {}
- 在触摸结束时触发,即“touchUp”View.props.onResponderTerminationRequest: evt => true
- 其他东西想要成为响应者。此视图是否应该释放响应者?返回 true 允许释放View.props.onResponderTerminate: evt => {}
- 响应者已从视图中移除。可能是被其他视图在调用onResponderTerminationRequest
后移除,或者可能是被操作系统在没有询问的情况下移除(发生在 iOS 上的控制中心/通知中心)
evt
是一个具有以下形式的合成触摸事件
nativeEvent
changedTouches
- 自上次事件以来已更改的所有触摸事件的数组identifier
- 触摸的 IDlocationX
- 触摸的 X 坐标,相对于元素locationY
- 触摸的 Y 坐标,相对于元素pageX
- 触摸的 X 坐标,相对于根元素pageY
- 触摸的 Y 坐标,相对于根元素target
- 接收触摸事件的元素的节点 IDtimestamp
- 触摸的时间标识符,用于速度计算touches
- 屏幕上所有当前触摸的数组
捕获 ShouldSet 处理程序
onStartShouldSetResponder
和 onMoveShouldSetResponder
以冒泡模式调用,其中最深层的节点首先被调用。这意味着当多个视图为 *ShouldSetResponder
处理程序返回 true 时,最深层的组件将成为响应者。这在大多数情况下是可取的,因为它确保所有控件和按钮都是可用的。
然而,有时父组件会希望确保它成为响应者。这可以通过使用捕获阶段来处理。在响应者系统从最深层组件冒泡之前,它会执行捕获阶段,触发 on*ShouldSetResponderCapture
。因此,如果父视图想要阻止子组件在触摸开始时成为响应者,它应该有一个返回 true 的 onStartShouldSetResponderCapture
处理程序。
View.props.onStartShouldSetResponderCapture: evt => true,
View.props.onMoveShouldSetResponderCapture: evt => true,
PanResponder
对于更高级别的手势解释,请查看 PanResponder。