UIPinchGestureRecognizer
UIPinchGestureRecognizer 表示一个捏合识别器:两根手指张开或捏拢时认出手势。用它做两指缩放。
捏合是连续手势,派发 began、changed、ended、cancelled。事件对象带两指间距相对手势开始时的倍数 scale 和它的变化速度 velocity。每次手势的 scale 都从 1 开始。
捏合还没有用真实触摸核对过,手势本身和事件带的数据都未在模拟器验证。
继承关系:EventTarget → NSObject → UIGestureRecognizer → 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
| ObjC | JS |
|---|---|
pinch.scale | 事件对象的 scale,或 pinch.scale |
pinch.velocity | 事件对象的 velocity,或 pinch.velocity |
参见
- 响应手势
CGAffineTransform:把倍数应用到视图上的CGAffineTransformUIGestureRecognizer:父类,事件和共同的属性