Flutter 基础之 GestureDetector 手势 (交互模型篇)

声明：本篇文章已授权微信公众号 YYGeeker 独家发布。
博主原创文章，转载请注明出处：小嵩的博客

介绍

GestureDetector是Flutter的手势检测器，它会尝试识别与之非null的回调相对应的手势。对于宽高的处理，如果此Widget组件具有子控件，那么它的大小调整行为将遵从该子控件。若它没有子控件，那么它宽高将变大以适应父控件。

默认情况下，带有不可见子控件的手势检测器会忽略触摸；可以通过行为控制此逻辑。GestureDetector还监听可访问性事件，并将其映射到callback回调。若要忽略可访问性事件，请将ExcludeFromSemantics设置为true。

Flutter中的手势系统有两个独立的层。第一层为原始指针(pointer)事件，它描述了屏幕上指针（例如，触摸、鼠标和触控笔）的位置和移动。 第二层为手势，描述由一个或多个指针移动组成的语义动作，如拖拽、缩放、双击、长按等。

手势

在flutter中，手势表示可以从多个单独的指针事件（甚至可能是多个单独的指针）识别的语义动作（例如点击，拖拽和缩放）。 完整的一个手势可以分发多个事件，对应于手势的生命周期（例如，拖拽开始，拖拽更新和拖拽结束）：

• 单击

  • onTapDown 指针已经在特定位置与屏幕接触
  • onTapUp 指针停止在特定位置与屏幕接触
  • onTap 单击事件触发
  • onTapCancel 先前指针触发的onTapDown不会在触发单击事件

• 双击

  • onDoubleTap 用户快速连续两次在同一位置轻敲屏幕.

• 长按

  • onLongPress 指针在相同位置长时间保持与屏幕接触

• 垂直拖拽

  • onVerticalDragStart 指针已经与屏幕接触并可能开始垂直移动
  • onVerticalDragUpdate 指针与屏幕接触并已沿垂直方向移动.
  • onVerticalDragEnd 先前与屏幕接触并垂直移动的指针不再与屏幕接触，并且在停止接触屏幕时以特定速度移动

• 水平拖拽

  • onHorizontalDragStart 指针已经接触到屏幕并可能开始水平移动
  • onHorizontalDragUpdate 指针与屏幕接触并已沿水平方向移动
  • onHorizontalDragEnd 先前与屏幕接触并水平移动的指针不再与屏幕接触，并在停止接触屏幕时以特定速度移动

继承关系

Object —> Diagnosticable —> DiagnosticableTree —> Widget —> StatelessWidget —> GestureDetector

构造函数

GestureDetector({Key key, Widget child, GestureTapDownCallback onTapDown, GestureTapUpCallback onTapUp, GestureTapCallback onTap, GestureTapCancelCallback onTapCancel, GestureTapDownCallback onSecondaryTapDown, GestureTapUpCallback onSecondaryTapUp, GestureTapCancelCallback onSecondaryTapCancel, GestureTapCallback onDoubleTap, GestureLongPressCallback onLongPress, GestureLongPressStartCallback onLongPressStart, GestureLongPressMoveUpdateCallback onLongPressMoveUpdate, GestureLongPressUpCallback onLongPressUp, GestureLongPressEndCallback onLongPressEnd, GestureDragDownCallback onVerticalDragDown, GestureDragStartCallback onVerticalDragStart, GestureDragUpdateCallback onVerticalDragUpdate, GestureDragEndCallback onVerticalDragEnd, GestureDragCancelCallback onVerticalDragCancel, GestureDragDownCallback onHorizontalDragDown, GestureDragStartCallback onHorizontalDragStart, GestureDragUpdateCallback onHorizontalDragUpdate, GestureDragEndCallback onHorizontalDragEnd, GestureDragCancelCallback onHorizontalDragCancel, GestureForcePressStartCallback onForcePressStart, GestureForcePressPeakCallback onForcePressPeak, GestureForcePressUpdateCallback onForcePressUpdate, GestureForcePressEndCallback onForcePressEnd, GestureDragDownCallback onPanDown, GestureDragStartCallback onPanStart, GestureDragUpdateCallback onPanUpdate, GestureDragEndCallback onPanEnd, GestureDragCancelCallback onPanCancel, GestureScaleStartCallback onScaleStart, GestureScaleUpdateCallback onScaleUpdate, GestureScaleEndCallback onScaleEnd, HitTestBehavior behavior, bool excludeFromSemantics: false, DragStartBehavior dragStartBehavior: DragStartBehavior.start })

常用属性

• dragStartBehavior → DragStartBehavior
  确定处理拖拽开始行为的方式

• excludeFromSemantics → bool 是否从语义树中排除这些手势。

  例如，用于显示工具提示的长按手势被排除，因为工具提示本身直接包含在语义树中，因此具有显示它的手势将导致信息的重复。

• onDoubleTap → GestureTapCallback 用户已快速连续两次在同一位置使用主按钮轻触屏幕。

• onForcePressEnd → GestureForcePressEndCallback 指针不再与屏幕接触。

• onForcePressPeak → GestureForcePressPeakCallback 指针与屏幕接触并以最大力按下。力量至少是 ForcePressGestureRecognizer.peakPressure。

• onForcePressStart → GestureForcePressStartCallback 指针与屏幕接触，并用足够的力按压以启动压力。力量至少是 ForcePressGestureRecognizer.startPressure。

• onForcePressUpdate → GestureForcePressUpdateCallback 指针与屏幕接触，之前已经通过了 ForcePressGestureRecognizer.startPressure，并且要么在屏幕的平面上移动，要么用不同的力按压屏幕，要么同时按两个屏幕。

• onHorizontalDragCancel → GestureDragCancelCallback
  先前触发onHorizontalDragDown的指针未完成触发了取消。

• onHorizontalDragDown → GestureDragDownCallback
  指针已通过主按钮与屏幕接触，并可能开始水平移动。

• onHorizontalDragEnd → GestureDragEndCallback
  之前与主屏幕接触并且水平移动的指针不再与屏幕接触，并且当它停止接触屏幕时以特定速度移动。

• onHorizontalDragStart → GestureDragStartCallback
  指针已通过主按钮与屏幕接触，并开始水平移动。

• onHorizontalDragUpdate → GestureDragUpdateCallback
  与主按钮接触并且水平移动的指针在水平方向上移动。

• onLongPress → GestureLongPressCallback
  当识别出具有主按钮的长按手势时调用。

• onLongPressEnd → GestureLongPressEndCallback
  使用主按钮触发长按的指针已停止接触屏幕。

• onLongPressMoveUpdate → GestureLongPressMoveUpdateCallback
  使用主按钮长按后，指针已被拖动。

• onLongPressStart → GestureLongPressStartCallback
  当识别出具有主按钮的长按手势时调用。

• onLongPressUp → GestureLongPressUpCallback
  使用主按钮触发长按的指针已停止接触屏幕。

• onPanCancel → GestureDragCancelCallback
  先前触发onPanDown的指针未完成。

• onPanDown → GestureDragDownCallback
  指针已通过主按钮与屏幕接触，并可能开始移动。

• onPanEnd → GestureDragEndCallback
  先前通过主按钮与屏幕接触并且移动的指针不再与屏幕接触，并且当它停止接触屏幕时以特定速度移动。

• onPanStart → GestureDragStartCallback
  触摸点与屏幕接触，并已开始移动。