Skip to content

UIPinchGestureRecognizer ​

UIPinchGestureRecognizer 表示一个捏合识别器:两根手指张开或捏拢时认出手势。用它做两指缩放。

捏合是连续手势,派发 began、changed、ended、cancelled。事件对象带两指间距相对手势开始时的倍数 scale 和它的变化速度 velocity。每次手势的 scale 都从 1 开始。

捏合还没有用真实触摸核对过,手势本身和事件带的数据都未在模拟器验证。

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

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

构造函数 ​

UIPinchGestureRecognizer()

创建一个识别两指捏合的识别器。

实例属性 ​

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

属性说明
scale两指的间距相对手势开始时的倍数
velocity 只读scale 每秒变化多少

事件 ​

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

事件什么时候派发
began捏合被认出时
changed之后两指间距每变化一次
ended手指抬起时
cancelled被打断时

示例 ​

js
const card = new UIView();
const pinch = new UIPinchGestureRecognizer();
let baseScale = 1;
pinch.addEventListener('changed', (e) => {
  const { scale } = /** @type {UIPinchGestureRecognizerEvent} */ (e);
  card.transform = CGAffineTransform.scale(baseScale * scale);
});
pinch.addEventListener('ended', (e) => {
  const { scale } = /** @type {UIPinchGestureRecognizerEvent} */ (e);
  baseScale = baseScale * scale;
});
card.addGestureRecognizer(pinch);

效果:两根手指在 card 上张开,card 变大;捏拢,变小。松手后保持大小,再次捏合时从当前大小继续。未在模拟器验证。

对应的 iOS API ​

ObjCJS
pinch.scale事件对象的 scale,或 pinch.scale
pinch.velocity事件对象的 velocity,或 pinch.velocity

参见 ​