Skip to content

UIPanGestureRecognizer ​

UIPanGestureRecognizer 表示一个拖动识别器:手指按下并移动时认出手势。用它让视图跟着手指移动,或者在松手时根据速度做惯性动画。

拖动是连续手势:手指移动了一小段距离时派发 began,之后每次移动派发 changed,全部手指抬起时派发 ended。事件对象带从手势开始累计的位移 translation 和速度 velocity。

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

UIScrollView 自己就是用一个拖动识别器来滚动的,它的 gestureRecognizers 里有一个 UIPanGestureRecognizer(验收用例里核对过)。子类 UIScreenEdgePanGestureRecognizer 只认从屏幕边缘开始的拖动。

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

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

构造函数 ​

UIPanGestureRecognizer()

创建一个识别单指及以上拖动的识别器。

实例属性 ​

还继承 UIGestureRecognizer 的属性,常用的是 isEnabled、view、cancelsTouchesInView。

属性说明
minimumNumberOfTouches最少要几根手指按着才算拖动
maximumNumberOfTouches最多能有几根手指按着
allowedScrollTypesMask哪几种滚动输入(鼠标滚轮、触控板)也算拖动

实例方法 ​

还继承 UIGestureRecognizer 的方法。

方法说明
translationInView()从手势开始到现在手指移动了多少,换算到指定视图的坐标系里
setTranslation()把累计的位移改成指定的值
velocityInView()手指此刻的移动速度,换算到指定视图的坐标系里

在事件回调里调这三个方法,读到和改到的是回调执行那一刻的值。事件发生那一刻的位移和速度在事件对象上。

事件 ​

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

事件什么时候派发
began手指移动了一小段距离、拖动被认出时
changed之后手指每移动一次
ended全部手指抬起时。velocity 是松手那一刻的速度
cancelled被打断时

示例 ​

js
const card = new UIView();
const drag = new UIPanGestureRecognizer();
let start = card.center;
drag.addEventListener('began', () => {
  start = card.center;
});
drag.addEventListener('changed', (e) => {
  const { translation } = /** @type {UIPanGestureRecognizerEvent} */ (e);
  card.center = new CGPoint(start.x + translation.x, start.y + translation.y);
});
card.addGestureRecognizer(drag);

效果:按住 card 并移动手指,card 跟着手指移动。松手后停在松手的位置。未在模拟器验证。

对应的 iOS API ​

ObjCJS
[pan translationInView:view]事件对象的 translation,或 pan.translationInView(view)
[pan velocityInView:view]事件对象的 velocity,或 pan.velocityInView(view)
[pan setTranslation:CGPointZero inView:view]pan.setTranslation(new CGPoint(0, 0), { inView: view })
pan.maximumNumberOfTouches = 2pan.maximumNumberOfTouches = 2
pan.allowedScrollTypesMask = UIScrollTypeMaskAllpan.allowedScrollTypesMask = ['discrete', 'continuous']

参见 ​