1、UIGestureRecognizer 介绍
手势识别在 iOS 中非常重要,他极大地提高了移动设备的使用便捷性。
iOS 系统在 3.2 以后,他提供了一些常用的手势(UIGestureRecognizer 的子类),开发者可以直接使用他们进行手势操作。
-
UIPanGestureRecognizer(拖动)
-
UIPinchGestureRecognizer(捏合)
-
UIRotationGestureRecognizer(旋转)
-
UITapGestureRecognizer(点按)
-
UILongPressGestureRecognizer(长按)
-
UISwipeGestureRecognizer(轻扫)
另外,可以通过继承 UIGestureRecognizer 类,实现自定义手势(手势识别器类)。
PS:自定义手势时,需要 #import <UIKit/UIGestureRecognizerSubclass.h>,一般需实现如下方法:
1 - (void)reset; 2 3 - (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event; 4 - (void)touchesMoved:(NSSet *)touches withEvent:(UIEvent *)event; 5 - (void)touchesEnded:(NSSet *)touches withEvent:(UIEvent *)event; 6 - (void)touchesCancelled:(NSSet *)touches withEvent:(UIEvent *)event; 7 //以上方法在分类 UIGestureRecognizer (UIGestureRecognizerProtected) 中声明,更多方法声明请自行查看
UIGestureRecognizer 的继承关系如下:
2、手势状态
在六种手势识别中,只有一种手势是离散型手势,他就是 UITapGestureRecognizer。
离散型手势的特点就是:一旦识别就无法取消,而且只会调用一次手势操作事件(初始化手势时指定的回调方法)。
换句话说其他五种手势是连续型手势,而连续型手势的特点就是:会多次调用手势操作事件,而且在连续手势识别后可以取消手势。从下图可以看出两者调用操作事件的次数是不同的:
手势状态枚举如下:
1 typedef NS_ENUM(NSInteger, UIGestureRecognizerState) { 2 UIGestureRecognizerStatePossible, // 尚未识别是何种手势操作(但可能已经触发了触摸事件),默认状态 3 UIGestureRecognizerStateBegan, // 手势已经开始,此时已经被识别,但是这个过程中可能发生变化,手势操作尚未完成 4 UIGestureRecognizerStateChanged, // 手势状态发生转变 5 UIGestureRecognizerStateEnded, // 手势识别操作完成(此时已经松开手指) 6 UIGestureRecognizerStateCancelled, // 手势被取消,恢复到默认状态 7 UIGestureRecognizerStateFailed, // 手势识别失败,恢复到默认状态 8 UIGestureRecognizerStateRecognized = UIGestureRecognizerStateEnded // 手势识别完成,同UIGestureRecognizerStateEnded 9 };
- 对于离散型手势 UITapGestureRecgnizer 要么被识别,要么失败,点按(假设点按次数设置为1,并且没有添加长按手势)下去一次不松开则此时什么也不会发生,松开手指立即识别并调用操作事件,并且状态为3(已完成)。
-
但是连续型手势要复杂一些,就拿旋转手势来说,如果两个手指点下去不做任何操作,此时并不能识别手势(因为我们还没旋转)但是其实已经触发了触摸开始事件,此时处于状态0;如果此时旋转会被识别,也就会调用对应的操作事件,同时状态变成1(手势开始),但是状态1只有一瞬间;紧接着状态变为2(因为我们的旋转需要持续一会),并且重复调用操作事件(如果在事件中打印状态会重复打印2);松开手指,此时状态变为3,并调用1次操作事件。
3、使用手势的步骤
使用手势很简单,分为三步:
-
创建手势识别器对象实例。创建时,指定一个回调方法,当手势开始,改变、或结束时,执行回调方法。
-
设置手势识别器对象实例的相关属性(可选部分)
-
添加到需要识别的 View 中。每个手势只对应一个 View,当屏幕触摸在 View 的边界内时,如果手势和预定的一样,那就会执行回调方法。
PS:一个手势只能对应一个 View,但是一个 View 可以有多个手势。建议在真机上测试这些手势,模拟器操作不太方便,可能导致认为手势失效的情况。(模拟器测试捏合和旋转手势时,按住 option 键,再用触摸板或鼠标操作)
4、举例说明
功能描述:
附加到两个图片视图 UIImageView 的有『拖动』、『捏合』、『旋转』、『点按』;
而『轻扫』和『自定义手势 KMGestureRecognizer』附加在根视图 UIView 中。
-
拖动:进行当前图片视图位置移动
-
捏合:进行当前图片视图缩放
-
旋转:进行当前图片视图角度旋转
-
点按:双击恢复当前图片视图的缩放、角度旋转、不透明度
-
长按:设置当前图片视图的不透明度为0.7
-
轻扫:左右轻扫设置两个图片视图为居中,同时以垂直居中的特定偏移量定位
-
自定义手势:挠痒功能,左右扫动共3次或以上,设置两个图片视图为居中,同时以水平居中的特定偏移量定位
效果如下:
KMGestureRecognizer.h
1 #import <UIKit/UIKit.h> 2 3 typedef NS_ENUM(NSUInteger, Direction) { 4 DirectionUnknown, 5 DirectionLeft, 6 DirectionRight 7 }; 8 9 @interface KMGestureRecognizer : UIGestureRecognizer 10 @property (assign, nonatomic) NSUInteger tickleCount; //挠痒次数 11 @property (assign, nonatomic) CGPoint currentTickleStart; //当前挠痒开始坐标位置 12 @property (assign, nonatomic) Direction lastDirection; //最后一次挠痒方向 13 14 @end
KMGestureRecognizer.m
1 #import "KMGestureRecognizer.h" 2 #import <UIKit/UIGestureRecognizerSubclass.h> 3 4 @implementation KMGestureRecognizer 5 #define kMinTickleSpacing 20.0 6 #define kMaxTickleCount 3 7 8 - (void)reset { 9 _tickleCount = 0; 10 _currentTickleStart = CGPointZero; 11 _lastDirection = DirectionUnknown; 12 13 if (self.state == UIGestureRecognizerStatePossible) { 14 self.state = UIGestureRecognizerStateFailed; 15 } 16 } 17 18 - (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event { 19 UITouch *touch = [touches anyObject]; 20 _currentTickleStart = [touch locationInView:self.view]; //设置当前挠痒开始坐标位置 21 } 22 23 - (void)touchesMoved:(NSSet *)touches withEvent:(UIEvent *)event { 24 //『当前挠痒开始坐标位置』和『移动后坐标位置』进行 X 轴值比较,得到是向左还是向右移动 25 UITouch *touch = [touches anyObject]; 26 CGPoint tickleEnd = [touch locationInView:self.view]; 27 CGFloat tickleSpacing = tickleEnd.x - _currentTickleStart.x; 28 Direction currentDirection = tickleSpacing < 0 ? DirectionLeft : DirectionRight; 29 30 //移动的 X 轴间距值是否符合要求,足够大 31 if (ABS(tickleSpacing) >= kMinTickleSpacing) { 32 //判断是否有三次不同方向的动作,如果有则手势结束,将执行回调方法 33 if (_lastDirection == DirectionUnknown || 34 (_lastDirection == DirectionLeft && currentDirection == DirectionRight) || 35 (_lastDirection == DirectionRight && currentDirection == DirectionLeft)) { 36 _tickleCount++; 37 _currentTickleStart = tickleEnd; 38 _lastDirection = currentDirection; 39 40 if (_tickleCount >= kMaxTickleCount && self.state == UIGestureRecognizerStatePossible) { 41 self.state = UIGestureRecognizerStateEnded; 42 //NSLog(@"自定义手势成功,将执行回调方法"); 43 } 44 } 45 } 46 } 47 48 - (void)touchesEnded:(NSSet *)touches withEvent:(UIEvent *)event { 49 [self reset]; 50 } 51 52 - (void)touchesCancelled:(NSSet *)touches withEvent:(UIEvent *)event { 53 [self reset]; 54 } 55 56 @end
ViewController.h
1 #import <UIKit/UIKit.h> 2 #import "KMGestureRecognizer.h" 3 4 @interface ViewController : UIViewController 5 @property (strong, nonatomic) UIImageView *imgV; 6 @property (strong, nonatomic) UIImageView *imgV2; 7 @property (strong, nonatomic) KMGestureRecognizer *customGestureRecognizer; 8 9 @end
ViewController.m
1 #import "ViewController.h" 2 3 @interface ViewController () 4 - (void)handlePan:(UIPanGestureRecognizer *)recognizer; 5 - (void)handlePinch:(UIPinchGestureRecognizer *)recognizer; 6 - (void)handleRotation:(UIRotationGestureRecognizer *)recognizer; 7 - (void)handleTap:(UITapGestureRecognizer *)recognizer; 8 - (void)handleLongPress:(UILongPressGestureRecognizer *)recognizer; 9 - (void)handleSwipe:(UISwipeGestureRecognizer *)recognizer; 10 - (void)handleCustomGestureRecognizer:(KMGestureRecognizer *)recognizer; 11 12 - (void)bindPan:(UIImageView *)imgVCustom; 13 - (void)bindPinch:(UIImageView *)imgVCustom; 14 - (void)bindRotation:(UIImageView *)imgVCustom; 15 - (void)bindTap:(UIImageView *)imgVCustom; 16 - (void)bindLongPress:(UIImageView *)imgVCustom; 17 - (void)bindSwipe; 18 - (void)bingCustomGestureRecognizer; 19 - (void)layoutUI; 20 @end 21 22 @implementation ViewController 23 24 - (void)viewDidLoad { 25 [super viewDidLoad]; 26 27 [self layoutUI]; 28 } 29 30 - (void)didReceiveMemoryWarning { 31 [super didReceiveMemoryWarning]; 32 // Dispose of any resources that can be recreated. 33 } 34 35 #pragma mark - 处理手势操作 36 /** 37 * 处理拖动手势 38 * 39 * @param recognizer 拖动手势识别器对象实例 40 */ 41 - (void)handlePan:(UIPanGestureRecognizer *)recognizer { 42 //视图前置操作 43 [recognizer.view.superview bringSubviewToFront:recognizer.view]; 44 45 CGPoint center = recognizer.view.center; 46 CGFloat cornerRadius = recognizer.view.frame.size.width / 2; 47 CGPoint translation = [recognizer translationInView:self.view]; 48 //NSLog(@"%@", NSStringFromCGPoint(translation)); 49 recognizer.view.center = CGPointMake(center.x + translation.x, center.y + translation.y); 50 [recognizer setTranslation:CGPointZero inView:self.view]; 51 52 if (recognizer.state == UIGestureRecognizerStateEnded) { 53 //计算速度向量的长度,当他小于200时,滑行会很短 54 CGPoint velocity = [recognizer velocityInView:self.view]; 55 CGFloat magnitude = sqrtf((velocity.x * velocity.x) + (velocity.y * velocity.y)); 56 CGFloat slideMult = magnitude / 200; 57 //NSLog(@"magnitude: %f, slideMult: %f", magnitude, slideMult); //e.g. 397.973175, slideMult: 1.989866 58 59 //基于速度和速度因素计算一个终点 60 float slideFactor = 0.1 * slideMult; 61 CGPoint finalPoint = CGPointMake(center.x + (velocity.x * slideFactor), 62 center.y + (velocity.y * slideFactor)); 63 //限制最小[cornerRadius]和最大边界值[self.view.bounds.size.width - cornerRadius],以免拖动出屏幕界限 64 finalPoint.x = MIN(MAX(finalPoint.x, cornerRadius), 65 self.view.bounds.size.width - cornerRadius); 66 finalPoint.y = MIN(MAX(finalPoint.y, cornerRadius), 67 self.view.bounds.size.height - cornerRadius); 68 69 //使用 UIView 动画使 view 滑行到终点 70 [UIView animateWithDuration:slideFactor*2 71 delay:0 72 options:UIViewAnimationOptionCurveEaseOut 73 animations:^{ 74 recognizer.view.center = finalPoint; 75 } 76 completion:nil]; 77 } 78 } 79 80 /** 81 * 处理捏合手势 82 * 83 * @param recognizer 捏合手势识别器对象实例 84 */ 85 - (void)handlePinch:(UIPinchGestureRecognizer *)recognizer { 86 CGFloat scale = recognizer.scale; 87 recognizer.view.transform = CGAffineTransformScale(recognizer.view.transform, scale, scale); //在已缩放大小基础下进行累加变化;区别于:使用 CGAffineTransformMakeScale 方法就是在原大小基础下进行变化 88 recognizer.scale = 1.0; 89 } 90 91 /** 92 * 处理旋转手势 93 * 94 * @param recognizer 旋转手势识别器对象实例 95 */ 96 - (void)handleRotation:(UIRotationGestureRecognizer *)recognizer { 97 recognizer.view.transform = CGAffineTransformRotate(recognizer.view.transform, recognizer.rotation); 98 recognizer.rotation = 0.0; 99 } 100 101 /** 102 * 处理点按手势 103 * 104 * @param recognizer 点按手势识别器对象实例 105 */ 106 - (void)handleTap:(UITapGestureRecognizer *)recognizer { 107 UIView *view = recognizer.view; 108 view.transform = CGAffineTransformMakeScale(1.0, 1.0); 109 view.transform = CGAffineTransformMakeRotation(0.0); 110 view.alpha = 1.0; 111 } 112 113 /** 114 * 处理长按手势 115 * 116 * @param recognizer 点按手势识别器对象实例 117 */ 118 - (void)handleLongPress:(UILongPressGestureRecognizer *)recognizer { 119 //长按的时候,设置不透明度为0.7 120 recognizer.view.alpha = 0.7; 121 } 122 123 /** 124 * 处理轻扫手势 125 * 126 * @param recognizer 轻扫手势识别器对象实例 127 */ 128 - (void)handleSwipe:(UISwipeGestureRecognizer *)recognizer { 129 //代码块方式封装操作方法 130 void (^positionOperation)() = ^() { 131 CGPoint newPoint = recognizer.view.center; 132 newPoint.y -= 20.0; 133 _imgV.center = newPoint; 134 135 newPoint.y += 40.0; 136 _imgV2.center = newPoint; 137 }; 138 139 //根据轻扫方向,进行不同控制 140 switch (recognizer.direction) { 141 case UISwipeGestureRecognizerDirectionRight: { 142 positionOperation(); 143 break; 144 } 145 case UISwipeGestureRecognizerDirectionLeft: { 146 positionOperation(); 147 break; 148 } 149 case UISwipeGestureRecognizerDirectionUp: { 150 break; 151 } 152 case UISwipeGestureRecognizerDirectionDown: { 153 break; 154 } 155 } 156 } 157 158 /** 159 * 处理自定义手势 160 * 161 * @param recognizer 自定义手势识别器对象实例 162 */ 163 - (void)handleCustomGestureRecognizer:(KMGestureRecognizer *)recognizer { 164 //代码块方式封装操作方法 165 void (^positionOperation)() = ^() { 166 CGPoint newPoint = recognizer.view.center; 167 newPoint.x -= 20.0; 168 _imgV.center = newPoint; 169 170 newPoint.x += 40.0; 171 _imgV2.center = newPoint; 172 }; 173 174 positionOperation(); 175 } 176 177 178 #pragma mark - 绑定手势操作 179 /** 180 * 绑定拖动手势 181 * 182 * @param imgVCustom 绑定到图片视图对象实例 183 */ 184 - (void)bindPan:(UIImageView *)imgVCustom { 185 UIPanGestureRecognizer *recognizer = [[UIPanGestureRecognizer alloc] initWithTarget:self 186 action:@selector(handlePan:)]; 187 [imgVCustom addGestureRecognizer:recognizer]; 188 } 189 190 /** 191 * 绑定捏合手势 192 * 193 * @param imgVCustom 绑定到图片视图对象实例 194 */ 195 - (void)bindPinch:(UIImageView *)imgVCustom { 196 UIPinchGestureRecognizer *recognizer = [[UIPinchGestureRecognizer alloc] initWithTarget:self 197 action:@selector(handlePinch:)]; 198 [imgVCustom addGestureRecognizer:recognizer]; 199 //[recognizer requireGestureRecognizerToFail:imgVCustom.gestureRecognizers.firstObject]; 200 } 201 202 /** 203 * 绑定旋转手势 204 * 205 * @param imgVCustom 绑定到图片视图对象实例 206 */ 207 - (void)bindRotation:(UIImageView *)imgVCustom { 208 UIRotationGestureRecognizer *recognizer = [[UIRotationGestureRecognizer alloc] initWithTarget:self 209 action:@selector(handleRotation:)]; 210 [imgVCustom addGestureRecognizer:recognizer]; 211 } 212 213 /** 214 * 绑定点按手势 215 * 216 * @param imgVCustom 绑定到图片视图对象实例 217 */ 218 - (void)bindTap:(UIImageView *)imgVCustom { 219 UITapGestureRecognizer *recognizer = [[UITapGestureRecognizer alloc] initWithTarget:self 220 action:@selector(handleTap:)]; 221 //使用一根手指双击时,才触发点按手势识别器 222 recognizer.numberOfTapsRequired = 2; 223 recognizer.numberOfTouchesRequired = 1; 224 [imgVCustom addGestureRecognizer:recognizer]; 225 } 226 227 /** 228 * 绑定长按手势 229 * 230 * @param imgVCustom 绑定到图片视图对象实例 231 */ 232 - (void)bindLongPress:(UIImageView *)imgVCustom { 233 UILongPressGestureRecognizer *recognizer = [[UILongPressGestureRecognizer alloc] initWithTarget:self action:@selector(handleLongPress:)]; 234 recognizer.minimumPressDuration = 0.5; //设置最小长按时间;默认为0.5秒 235 [imgVCustom addGestureRecognizer:recognizer]; 236 } 237 238 /** 239 * 绑定轻扫手势;支持四个方向的轻扫,但是不同的方向要分别定义轻扫手势 240 */ 241 - (void)bindSwipe { 242 //向右轻扫手势 243 UISwipeGestureRecognizer *recognizer = [[UISwipeGestureRecognizer alloc] initWithTarget:self 244 action:@selector(handleSwipe:)]; 245 recognizer.direction = UISwipeGestureRecognizerDirectionRight; //设置轻扫方向;默认是 UISwipeGestureRecognizerDirectionRight,即向右轻扫 246 [self.view addGestureRecognizer:recognizer]; 247 [recognizer requireGestureRecognizerToFail:_customGestureRecognizer]; //设置以自定义挠痒手势优先识别 248 249 //向左轻扫手势 250 recognizer = [[UISwipeGestureRecognizer alloc] initWithTarget:self 251 action:@selector(handleSwipe:)]; 252 recognizer.direction = UISwipeGestureRecognizerDirectionLeft; 253 [self.view addGestureRecognizer:recognizer]; 254 [recognizer requireGestureRecognizerToFail:_customGestureRecognizer]; //设置以自定义挠痒手势优先识别 255 } 256 257 /** 258 * 绑定自定义挠痒手势;判断是否有三次不同方向的动作,如果有则手势结束,将执行回调方法 259 */ 260 - (void)bingCustomGestureRecognizer { 261 //当 recognizer.state 为 UIGestureRecognizerStateEnded 时,才执行回调方法 handleCustomGestureRecognizer: 262 263 //_customGestureRecognizer = [KMGestureRecognizer new]; 264 _customGestureRecognizer = [[KMGestureRecognizer alloc] initWithTarget:self 265 action:@selector(handleCustomGestureRecognizer:)]; 266 [self.view addGestureRecognizer:_customGestureRecognizer]; 267 } 268 269 - (void)layoutUI { 270 //图片视图 _imgV 271 UIImage *img = [UIImage imageNamed:@"Emoticon_tusiji_icon"]; 272 CGFloat cornerRadius = img.size.width; 273 _imgV = [[UIImageView alloc] initWithImage:img]; 274 _imgV.frame = CGRectMake(20.0, 20.0, 275 cornerRadius * 2, cornerRadius * 2); 276 _imgV.userInteractionEnabled = YES; 277 _imgV.layer.masksToBounds = YES; 278 _imgV.layer.cornerRadius = cornerRadius; 279 _imgV.layer.borderWidth = 2.0; 280 _imgV.layer.borderColor = [UIColor grayColor].CGColor; 281 [self.view addSubview:_imgV]; 282 283 //图片视图 _imgV2 284 img = [UIImage imageNamed:@"Emoticon_tusiji_icon2"]; 285 cornerRadius = img.size.width; 286 _imgV2 = [[UIImageView alloc] initWithImage:img]; 287 _imgV2.frame = CGRectMake(20.0, 40.0 + _imgV.frame.size.height, 288 cornerRadius * 2, cornerRadius * 2); 289 _imgV2.userInteractionEnabled = YES; 290 _imgV2.layer.masksToBounds = YES; 291 _imgV2.layer.cornerRadius = cornerRadius; 292 _imgV2.layer.borderWidth = 2.0; 293 _imgV2.layer.borderColor = [UIColor orangeColor].CGColor; 294 [self.view addSubview:_imgV2]; 295 296 297 [self bindPan:_imgV]; 298 [self bindPinch:_imgV]; 299 [self bindRotation:_imgV]; 300 [self bindTap:_imgV]; 301 [self bindLongPress:_imgV]; 302 303 [self bindPan:_imgV2]; 304 [self bindPinch:_imgV2]; 305 [self bindRotation:_imgV2]; 306 [self bindTap:_imgV2]; 307 [self bindLongPress:_imgV2]; 308 309 //为了处理手势识别优先级的问题,这里需先绑定自定义挠痒手势 310 [self bingCustomGestureRecognizer]; 311 [self bindSwipe]; 312 } 313 314 @end