在 iOS 早期版本中,偵測滑動手勢往往要自己監聽 touchesMoved 系列事件、手動比對起點與終點座標,程式碼冗長又容易出錯。從 iOS 3.2 起,蘋果引進了 UIGestureRecognizer 家族,把這些繁瑣的判斷內建化,UISwipeGestureRecognizer 就是其中最直覺的一個。
使用方式非常精簡:建立辨識器時傳入目標物件與回呼的 selector,設定要偵測的方向,再把辨識器掛到 view 上即可。
- (void)viewDidLoad {
[super viewDidLoad];
UISwipeGestureRecognizer *recognizer = nil;
// 向右滑動
recognizer = [[UISwipeGestureRecognizer alloc]
initWithTarget:self action:@selector(handleSwipeFrom:)];
[recognizer setDirection:UISwipeGestureRecognizerDirectionRight];
[self.view addGestureRecognizer:recognizer];
[recognizer release];
// 向左滑動
recognizer = [[UISwipeGestureRecognizer alloc]
initWithTarget:self action:@selector(handleSwipeFrom:)];
[recognizer setDirection:UISwipeGestureRecognizerDirectionLeft];
[self.view addGestureRecognizer:recognizer];
[recognizer release];
}
同一個 handler 可以服務多個辨識器,透過 recognizer 的 direction 屬性即可分辨是哪個方向被觸發。
- (void)handleSwipeFrom:(UISwipeGestureRecognizer *)recognizer {
if (recognizer.direction == UISwipeGestureRecognizerDirectionRight) {
// TODO: 處理右滑
}
else if (recognizer.direction == UISwipeGestureRecognizerDirectionLeft) {
// TODO: 處理左滑
}
}
一個辨識器只對應一個方向。UISwipeGestureRecognizer 的 direction 是單值屬性,不像 UISegmentedControl 那樣可以組合。若要同時支援上下左右四個方向,就必須建立四個獨立的辨識器實例。
預設手勢條件是「快速且短距離」。系統要求滑動必須夠快,位移也要超過一定門檻才會觸發;慢慢拖曳通常不會被認定為 swipe。若需要自訂門檻,可以搭配 stVelocity 或改用 UIPanGestureRecognizer。
記得管理記憶體。在 MRC 年代,addGestureRecognizer 之後 view 會 retain 辨識器,因此需要 release 一次以平衡引用計數;若改用 ARC 則完全不需要這一步。
辨識器之間會競爭。如果同一個 view 上同時掛了 swipe 與 tap、pan,可能出現多個辨識器同時觸發的情況,這時可用 requireGestureRecognizerToFail: 或實作 gestureRecognizer:shouldRecognizeSimultaneouslyWithGestureRecognizer: 來排定優先順序。
相較於過去手寫座標判斷的做法,用辨識器實作滑動不僅程式碼短少一半以上,也自動獲得了系統在觸控取消、多指判斷上的處理,是絕對值得採用的寫法。