点击、拖动及其他手势
本文档介绍了如何在 Flutter 中监听和响应手势。手势的例子包括点击、拖动和缩放。
Flutter 中的手势系统有两个独立的层。第一层是原始指针事件,它们描述了指针(例如触摸、鼠标和触控笔)在屏幕上的位置和移动。第二层是手势,它们描述了由一个或多个指针移动组成的语义动作。
指针
#指针表示用户与设备屏幕交互的原始数据。有四种类型的指针事件:
PointerDownEvent
- 指针已在特定位置接触屏幕。
PointerMoveEvent
- 指针已从屏幕上的一个位置移动到另一个位置。
PointerUpEvent
- 指针已停止接触屏幕。
PointerCancelEvent
- 此指针的输入不再指向此应用。
当指针按下时,框架会对你的应用进行命中测试,以确定指针接触屏幕的位置处存在哪个 widget。然后,指针按下事件(以及该指针的后续事件)被分派到命中测试发现的最内部 widget。从那里,事件沿着树向上冒泡,并被分派到从最内部 widget 到树根路径上的所有 widget。目前没有机制可以取消或阻止指针事件的进一步分派。
要直接从 widget 层监听指针事件,请使用 Listener
widget。然而,通常建议改为使用手势(如下所述)。
手势
#手势表示语义动作(例如,点击、拖动和缩放),这些动作是从多个单独的指针事件(甚至可能是多个单独的指针)中识别出来的。手势可以分派多个事件,对应于手势的生命周期(例如,拖动开始、拖动更新和拖动结束)。
点击
onTapDown
- 可能导致点击的指针已在特定位置接触屏幕。
onTapUp
- 触发点击的指针已在特定位置停止接触屏幕。
onTap
- 先前触发
onTapDown
的指针也触发了onTapUp
,最终导致了一次点击。 onTapCancel
- 先前触发
onTapDown
的指针最终不会导致一次点击。
双击
onDoubleTap
- 用户在同一位置快速连续点击了屏幕两次。
长按
onLongPress
- 指针在同一位置长时间保持与屏幕接触。
垂直拖动
onVerticalDragStart
- 指针已接触屏幕并可能开始垂直移动。
onVerticalDragUpdate
- 与屏幕接触并垂直移动的指针已沿垂直方向移动。
onVerticalDragEnd
- 之前与屏幕接触并垂直移动的指针不再与屏幕接触,并且在停止接触屏幕时以特定速度移动。
水平拖动
onHorizontalDragStart
- 指针已接触屏幕并可能开始水平移动。
onHorizontalDragUpdate
- 与屏幕接触并水平移动的指针已沿水平方向移动。
onHorizontalDragEnd
- 先前与屏幕接触并水平移动的指针已不再与屏幕接触,并且在停止接触屏幕时以特定速度移动。
平移
onPanStart
- 指针已接触屏幕并可能开始水平或垂直移动。如果设置了
onHorizontalDragStart
或onVerticalDragStart
,此回调将崩溃。 onPanUpdate
- 与屏幕接触并在垂直或水平方向移动的指针。如果设置了
onHorizontalDragUpdate
或onVerticalDragUpdate
,此回调将崩溃。 onPanEnd
- 先前与屏幕接触的指针已不再与屏幕接触,并且在停止接触屏幕时以特定速度移动。如果设置了
onHorizontalDragEnd
或onVerticalDragEnd
,此回调将崩溃。
为 widget 添加手势检测
#要从 widget 层监听手势,请使用 GestureDetector
。
如果你正在使用 Material 组件,其中许多 widget 已经响应点击或手势。例如,IconButton
和 TextButton
响应按压(点击),而 ListView
响应滑动以触发滚动。如果你不使用这些 widget,但希望在点击时出现“墨水飞溅”效果,你可以使用 InkWell
。
手势消歧
#在屏幕上的给定位置,可能存在多个手势检测器。例如:
- 一个
ListTile
有一个点击识别器,响应整个ListTile
,还有一个嵌套在尾部图标按钮周围的点击识别器。现在尾部图标的屏幕区域被两个手势识别器覆盖,如果手势是点击,它们需要协商由谁来处理。 - 一个单独的
GestureDetector
覆盖了一个配置为处理多种手势的屏幕区域,例如长按和点击。当用户触摸屏幕的该部分时,tap
识别器现在必须与long press
识别器进行协商。根据该指针接下来发生的情况,两个识别器中的一个会接收手势,或者如果用户执行的操作既不是点击也不是长按,则两者都不会接收手势。
所有这些手势检测器都会监听流经的指针事件流,并尝试识别特定手势。GestureDetector
widget 根据其哪些回调函数不为 null 来决定尝试识别哪些手势。
当屏幕上给定指针存在多个手势识别器时,框架通过让每个识别器加入手势竞技场(gesture arena)来消除用户意图的歧义。手势竞技场使用以下规则决定哪个手势获胜:
在任何时候,识别器都可以自行退出竞技场。如果竞技场中只剩下一个识别器,则该识别器获胜。
在任何时候,识别器都可以宣布自己获胜,导致所有剩余的识别器失败。
例如,在消除水平和垂直拖动的歧义时,两个识别器在接收到指针按下事件时都会进入竞技场。识别器会观察指针移动事件。如果用户水平移动指针超过一定数量的逻辑像素,则水平识别器宣布获胜,并且手势被解释为水平拖动。同样,如果用户垂直移动超过一定数量的逻辑像素,则垂直识别器宣布自己获胜。
当只有一个水平(或垂直)拖动识别器时,手势竞技场是有益的。在这种情况下,竞技场中只有一个识别器,水平拖动会立即被识别,这意味着水平移动的第一个像素可以被视为一次拖动,用户无需等待进一步的手势消歧。