原理:
Target-Action 事件传递机制
UIEvent.timestamp 用于标识事件唯一性,解决单个按钮绑定多个事件问题
参考:Cocoa China - Target-Action
思路
1.自定义按钮,继承自UIButton,覆写以下方法:
-(void)sendAction:(SEL)action to:(id)target forEvent:(UIEvent *)event;
2.UIButton 添加分类,实现的过程中有与代码实现一般规范相违背的地方,不是非常建议使用
第一种同样是覆盖下列方法:
-(void)sendAction:(SEL)action to:(id)target forEvent:(UIEvent *)event;
第二种是将以下两个方法交换,由于替换后下面的方法任然需要在分类里实现【否则会导致UIControl中的方法被替换】,所以可以直接用第一种,Demo中为了演示使用了第二种
-(void)sendAction:(SEL)action to:(id)target forEvent:(UIEvent *)event;
-(void)xlSendAction:(SEL)action to:(id)target forEvent:(UIEvent *)event;
不合理的地方:分类中覆盖了父类UIControl中的方法,从目前调试结果看,UIButton中似乎没有实现UIControl的方法【sendAction:to:forEvent:】,如果UIButton中有实现该方式会导致UIButotn中的方法不能执行。
两种方式【sendAction:to:forEvent:】方法中都需要调用如下方法
[super sendAction:action to:target forEvent:event];
- UIControl添加分类,替换方法【sendAction:to:forEvent:】
以上三种方式可结合APP的实际情况选择使用
实现
定义全局变量,用于存储按钮的时间间隔
// 全局变量,用于按钮点击判断
static CGFloat xlSingleClickButtonTimeInterval;
1.自定义按钮
- 添加属性,保存最近一次有效点击时间戳
// 最近一次点击时间戳
@property (nonatomic, assign) NSTimeInterval lastClickTimestamp;
- 配置单次点击时间间隔
/**
配置单次点击按钮间隔:需要继承至XLSingleClickButton才会有效
*/
+(void)singleClickButtonWithTimeInterval:(CGFloat)interval{
xlSingleClickButtonTimeInterval = interval;
}
- 方法覆盖:
event.timestamp相同,则标识为同一事件,理论上来说连续的两次点击事件,timestamp是不会相同的。
/**
覆盖父类方法
@param action <#action description#>
@param target <#target description#>
@param event <#event description#>
*/
-(void)sendAction:(SEL)action to:(id)target forEvent:(UIEvent *)event{
// event.timestamp 系统从开机到事件触发时的时间
if (self.lastClickTimestamp == event.timestamp) {
// 时间戳相同,同一个点击事件,不做快速点击判断
[super sendAction:action to:target forEvent:event];
} else if(event.timestamp - self.lastClickTimestamp > xlSingleClickButtonTimeInterval){
// 两个事件相隔时间戳大于设置时间
// 此处如果只是需要屏蔽系统双击或者更多连击的话,也可以判断event事件中UITouch.tapCount点击次数,
// 屏蔽数值大于1的点击事件
[super sendAction:action to:target forEvent:event];
// 时间戳更新
self.lastClickTimestamp = event.timestamp;
} else {
// 如果是需要连续两次的点击时间间隔不能超过设定值,则时间戳在此处也需要更新
// self.lastClickTimestamp = event.timestamp;
NSLog(@"短时间内多次点击");
}
}
2.添加分类
- 分类添加属性
// 绑定属性
static const char XLSingleClickTimeIntervalKey = '\0';
-(NSTimeInterval)lastClickTimestamp{
NSNumber *number = objc_getAssociatedObject(self, &XLSingleClickTimeIntervalKey);
if (!number) {
number = [NSNumber numberWithDouble:0];
}
return [number doubleValue];
}
-(void)setLastClickTimestamp:(NSTimeInterval)lastClickTimestamp{
NSNumber *number = [NSNumber numberWithDouble:lastClickTimestamp];
objc_setAssociatedObject(self, &XLSingleClickTimeIntervalKey, number, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
}
- UIButton添加分类时方法覆盖
/**
重要:该方法一定要实现,否则替换的就是父类UIControl中的方法,
则系统中其他继承自UIButton的类可能也会执行xlSendAction:to:forEvent:方法导致访问lastClickTimestamp出现异常
从调试的现象看,UIButton似乎没有重写改方法,添加该方法不会导致Button中方法覆盖,但后续不知是否有问题
@param action <#action description#>
@param target <#target description#>
@param event <#event description#>
*/
-(void)sendAction:(SEL)action to:(id)target forEvent:(UIEvent *)event{
[super sendAction:action to:target forEvent:event];
}
- UIButotn添加分类替换方法的实现
/**
全局按钮配置后,用于替换按钮自身的 sendAction:to:forEvent: 方法
@param action action description
@param target <#target description#>
@param event <#event description#>
*/
-(void)xlSendAction:(SEL)action to:(id)target forEvent:(UIEvent *)event{
// event.timestamp 系统从开机到事件触发时的时间
if (self.lastClickTimestamp == event.timestamp) {
// 时间戳相同,同一个点击事件,不做快速点击判断
[self xlSendAction:action to:target forEvent:event];
} else if(event.timestamp - self.lastClickTimestamp > xlSingleClickButtonTimeInterval){
// 两个事件相隔时间戳大于设置时间
// 此处如果只是需要屏蔽系统双击或者更多连击的话,也可以判断event事件中UITouch.tapCount点击次数,
// 屏蔽数值大于1的点击事件
[self xlSendAction:action to:target forEvent:event];
// 时间戳更新
self.lastClickTimestamp = event.timestamp;
} else {
// 如果是需要连续两次的点击时间间隔不能超过设定值,则时间戳在此处也需要更新
// self.lastClickTimestamp = event.timestamp;
NSLog(@"短时间内多次点击");
}
}
- UIControl添加分类替换方法的实现
此时不需要在分类中覆盖【sendAction:to:forEvent:】方法,但需要在方法中做类型判断,否者会影响到其他继承自UIControl的控件,也可以通过添加判断条件,让其他控件屏蔽连续点击事件,如系统导航栏的返回按钮,右侧按钮等
/**
全局按钮配置后,用于替换按钮自身的 sendAction:to:forEvent: 方法
@param action action description
@param target <#target description#>
@param event <#event description#>
*/
-(void)xlSendAction:(SEL)action to:(id)target forEvent:(UIEvent *)event{
// 此处添加判断,避免其他控件点击事件被错误处理
if ([self isKindOfClass:[UIButton class]]) {
// event.timestamp 系统从开机到事件触发时的时间
if (self.lastClickTimestamp == event.timestamp) {
// 时间戳相同,同一个点击事件,不做快速点击判断
[self xlSendAction:action to:target forEvent:event];
} else if(event.timestamp - self.lastClickTimestamp > xlSingleClickButtonTimeInterval){
// 两个事件相隔时间戳大于设置时间
// 此处如果只是需要屏蔽系统双击或者更多连击的话,也可以判断event事件中UITouch.tapCount点击次数,
// 屏蔽数值大于1的点击事件
[self xlSendAction:action to:target forEvent:event];
// 时间戳更新
self.lastClickTimestamp = event.timestamp;
} else {
// 如果是需要连续两次的点击时间间隔不能超过设定值,则时间戳在此处也需要更新
// self.lastClickTimestamp = event.timestamp;
NSLog(@"短时间内多次点击");
}
} else {
[self xlSendAction:action to:target forEvent:event];
}
}
GitHub地址:
XLCustomWidget
Demo 工程目录中【XLCustomWidget/XLSingleClickButton】文件夹下包含了三中实现方式,如果想正常验证Demo中的任一种实现方式,需要将其他两种实现方式中的函数方法注释了,否则会相互影响,导致按钮事件不能响应甚至是运行异常。
如您看到这篇文章中有任何疑问或者错误的地方欢迎随时留言指正,我会及时改正,谢谢。