Skip to content

UITapGestureRecognizer ​

UITapGestureRecognizer 表示一个点按识别器:手指按下后很快抬起时认出手势。要连点几下、要几根手指,都可以设,默认是单指点一下。

点按是离散手势:认出来就结束,只派发一次 ended。

继承关系:EventTarget → NSObject → UIGestureRecognizer → UITapGestureRecognizer

怎么用它,见指南响应手势。

构造函数 ​

UITapGestureRecognizer()

创建一个识别单指点一下的识别器。

实例属性 ​

还继承 UIGestureRecognizer 的属性,常用的是 isEnabled、view、cancelsTouchesInView。方法也都继承自它:addEventListener()、removeEventListener()、requireGestureRecognizerToFail()。

属性说明
numberOfTapsRequired要连点几下才算。2 是双击
numberOfTouchesRequired要几根手指同时点

事件 ​

事件来自 UIGestureRecognizer,用 addEventListener() 监听。它 派发的是:

事件什么时候派发
ended点按被认出时。点按只派发这一个事件

示例 ​

js
const card = new UIView();
const tap = new UITapGestureRecognizer();
tap.addEventListener('ended', (e) => {
  const { location } = /** @type {UIGestureRecognizerEvent} */ (e);
  if (location !== null) {
    console.log('点在', location.x, location.y);
  }
});
card.addGestureRecognizer(tap);

效果:点 card,控制台输出点在 card 里的坐标。

对应的 iOS API ​

ObjCJS
[[UITapGestureRecognizer alloc] initWithTarget:self action:@selector(onTap:)]new UITapGestureRecognizer(),再 addEventListener('ended', onTap)
tap.numberOfTapsRequired = 2tap.numberOfTapsRequired = 2
tap.numberOfTouchesRequired = 2tap.numberOfTouchesRequired = 2

参见 ​