Skip to content

UILongPressGestureRecognizer ​

UILongPressGestureRecognizer 表示一个长按识别器:手指按住不动一段时间时认出手势,默认是 0.5 秒。

长按是连续手势:按够时间时派发 began,之后手指每移动一次派发 changed,手指抬起时派发 ended,被打断时派发 cancelled。按够时间之前手指移动超过 allowableMovement 就不算长按,不派发任何事件。

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

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

构造函数 ​

UILongPressGestureRecognizer()

创建一个识别单指按住 0.5 秒的识别器。

实例属性 ​

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

属性说明
minimumPressDuration要按住多久才算,单位是秒
allowableMovement认出之前手指最多能移动多远,单位 pt
numberOfTapsRequired按住之前要先完整地点几下
numberOfTouchesRequired要几根手指同时按住

事件 ​

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

事件什么时候派发
began按够时间时
changed被认出之后手指移动时
ended被认出之后手指抬起时
cancelled被打断时,比如 App 退到后台

示例 ​

js
const card = new UIView();
const press = new UILongPressGestureRecognizer();
press.addEventListener('began', () => {
  console.log('按住了');
});
press.addEventListener('ended', () => {
  console.log('松手');
});
card.addGestureRecognizer(press);

效果:按住 card 0.5 秒,控制台输出 按住了;手指抬起时输出 松手。

对应的 iOS API ​

ObjCJS
[[UILongPressGestureRecognizer alloc] initWithTarget:self action:@selector(onPress:)]new UILongPressGestureRecognizer(),再 addEventListener('began', onPress)
press.minimumPressDuration = 1.0press.minimumPressDuration = 1
press.allowableMovement = 20press.allowableMovement = 20

参见 ​