Skip to content

UIGestureRecognizerEvent ​

UIGestureRecognizerEvent 表示手势识别器的一次事件:手势要开始、开始、变化、结束、被取消。

它带着手势的位置和参与的手指个数。拖动、捏合、旋转三种识别器的 began、changed、ended、cancelled 是它的子类,多带几个字段:UIPanGestureRecognizerEvent、UIPinchGestureRecognizerEvent、UIRotationGestureRecognizerEvent。

继承关系:Event → UIGestureRecognizerEvent

构造函数 ​

UIGestureRecognizerEvent()

创建一个 UIGestureRecognizerEvent。运行时派发下面这些事件时自己创建它;App 的代码可以用它建一个事件对象,用 dispatchEvent() 派发出去,试一试监听器。

实例属性 ​

还继承 Event 的属性,最常用的是 type 和 target。下表的属性都是只读的,给它们赋值抛 TypeError。

属性说明
location 只读手势的位置,在识别器所在视图的坐标系里
numberOfTouches 只读参与手势的手指个数

这些属性在原型上,不在事件对象自己身上:Object.keys(event) 和 { ...event } 拿不到它们,要一个一个读。见带字段的事件。

哪些事件是这个类 ​

对象事件
UIGestureRecognizer 和它的全部子类beforebegin
UITapGestureRecognizer、UILongPressGestureRecognizer、UISwipeGestureRecognizerbegan、changed、ended、cancelled

beforebegin 可以取消:cancelable 是 true,调了 preventDefault(),这一次手势不开始。其余的不能取消。

拖动、捏合、旋转识别器的 beforebegin 也是这个类,不是子类:手势还没开始,没有移动的距离、缩放的倍数这些值。

示例 ​

js
const page = new UIViewController();
const tap = new UITapGestureRecognizer();
tap.addEventListener('beforebegin', (e) => {
  if (e.location !== null && e.location.y < 100) {
    e.preventDefault();
  }
});
tap.addEventListener('ended', (e) => {
  console.log(e instanceof UIGestureRecognizerEvent, e.location?.y);
});
page.view.addGestureRecognizer(tap);

效果:点页面顶部 100 pt 以内,手势不开始,什么都不输出。点别处,输出 true 和点的纵坐标。

对应的 iOS API ​

原生的 action 方法收到识别器本身,从识别器上读位置和手指个数。这里两样是事件发生那一刻的值,在事件对象上。

ObjCJS
[recognizer locationInView:recognizer.view]event.location
recognizer.numberOfTouchesevent.numberOfTouches
gestureRecognizerShouldBegin: 返回 NO在 beforebegin 里调 preventDefault()

参见 ​