版本
Xcode 9.1
继承关系:
UIButton : UIControl : UIView : UIResponder : NSObject
一、创建方法
通常,我们创建一个对象会使用[[class alloc] init];方法,但对于UIButton是不推荐使用此方法的。原因有二:
- UIButton有个按钮样式属性buttonType需要在初始化的时候设定好,代码后期无法改变。假如使用alloc创建,那么buttonType默认为Custom模式。(关于buttonType详见后文)
- MRC下,如果使用 [[UIButton alloc] init]的方式,需要进行release释放操作;如果使用[UIButton buttonWithType:(UIButtonType)]这种方式,不需要进行release操作。
所以,代码创建UIButton方法为:
[UIButton buttonWithType:(UIButtonType)]
二、按钮样式(UIButtonType)
UIButtonType有六种枚举类型,对应外观如下:
之所以选择样式,是为了使用该样式下已经默认设置好的一些属性。
如Add Contact是一个“+”添加图形。而Detail Disclosure、Info Light及Info Dark都是一个“i”信息图形,Info Light和Info Dark这俩货之间我实在找不到有什么异样,但是这俩货与Detail Disclosure或者其他样式的区别是:这俩货默认属性showsTouchWhenHighlighted=YES,这就使得在点击按钮的时候(高亮状态),这俩货会散发出白色的光芒!将背景色调成黑色看看效果:
最后来说说System和Custom这两个样式。对于System样式,系统为我们预设了一些属性(详见下文对比部分)。Custom顾名思义是自定义的,可设置更多属性。如果我们在storyboard中设置Detail Disclosure、Info Light、Info Dark或者Add Contact按钮的title、backgroundImage等属性,会发现他们马上变成Custom样式;而如果设置了所有非Custom按钮的image(前景图片)属性,那么这些按钮也都将变成Custom样式。说明Custom可操作的属性还是比较多的。
System和Custom样式对比:
1. 对于字体颜色
System默认普通状态下为蓝色;Custom默认白色。
2. 对于前景image
Custom样式下可以显示前景图片,见图Custom;System样式不能显示前景图片,变成了图System这衰样...
3. 对于属性adjustsImageWhenHighlighted
@property(nonatomic) BOOL adjustsImageWhenHighlighted; // default is YES. if YES, image is drawn darker when highlighted(pressed)
从官方注释中可以看到,adjustsImageWhenHighlighted为YES时,使得高亮状态(按钮按下)前景图片和背景图片均会变暗。如果将这个属性值设为NO,按下按钮图片就不会变暗了。
经我亲测,System样式下adjustsImageWhenHighlighted默认为NO,而Custom样式下adjustsImageWhenHighlighted默认才为YES,即此default值说的是Custom样式。
按道理按下System样式的按钮,图片应该不会变暗才对(因为adjustsImageWhenHighlighted默认值为NO),但是它还是变暗了!这是为什么呢?还请接着看第4点。
4. 对于高亮状态下
如果是System样式,高亮状态下(即按下按钮)不止图片变暗,文字也跟着变暗了。即使设置了adjustsImageWhenHighlighted=NO,或者设置了高亮状态图片与普通状态图片一致,也是不行。说明System在高亮状态下还会改变另外一个属性使得按钮变暗。但是笔者却找不出是哪个属性改变了,估计看官已经气愤难当磨刀霍霍了...
如果是Custom,文字不管在哪种状态都不会变暗。而图片会因为adjustsImageWhenHighlighted默认值为YES变暗,设置为NO就不变暗了。
三、按钮属性
一般来说,我们设置对象属性都会使用点语法,但对于UIButton来说,有些属性是不能使用点语法的。
设置属性注意事项
1. UIButton的非私有属性(继承而来的属性),可以使用点语法。
如:
btn.frame = CGRectMake(100, 100, 200, 50); // 设置位置尺寸
btn.backgroundColor = [UIColor purpleColor]; // 设置背景颜色
btn.alpha = 1.0f; // 设置透明度
btn.layer.cornerRadius = 5.0; // 设置圆角(5.0是圆角的弧度)
btn.layer.borderWidth = 1.0f; // 设置边框宽度
btn.layer.borderColor = [UIColor blackColor].CGColor; //设置边框颜色
btn.contentVerticalAlignment = UIControlContentVerticalAlignmentCenter; // 设置垂直方向对齐方式
btn.contentHorizontalAlignment = UIControlContentHorizontalAlignmentCenter; // 设置水平方向对齐模式
2. UIButton的私有属性大多为只读,不能使用点语法进行set设置。
UIButton中所有只读属性:
@property(nonatomic,readonly) UIButtonType buttonType;
@property(nullable, nonatomic,readonly,strong) NSString *currentTitle; // normal/highlighted/selected/disabled. can return nil
@property(nonatomic,readonly,strong) UIColor *currentTitleColor; // normal/highlighted/selected/disabled. always returns non-nil. default is white(1,1)
@property(nullable, nonatomic,readonly,strong) UIColor *currentTitleShadowColor; // normal/highlighted/selected/disabled.
@property(nullable, nonatomic,readonly,strong) UIImage *currentImage; // normal/highlighted/selected/disabled. can return nil
@property(nullable, nonatomic,readonly,strong) UIImage *currentBackgroundImage; // normal/highlighted/selected/disabled. can return nil
@property(nullable, nonatomic,readonly,strong) NSAttributedString *currentAttributedTitle NS_AVAILABLE_IOS(6_0); // normal/highlighted/selected/disabled. can return nil
@property(nullable, nonatomic,readonly,strong) UILabel *titleLabel NS_AVAILABLE_IOS(3_0);
@property(nullable, nonatomic,readonly,strong) UIImageView *imageView NS_AVAILABLE_IOS(3_0);
3. UIButton有几种显示状态(普通、高亮、选中等),每种状态对应的某些属性是不同的,如果使用点语法就无法指明是哪种状态下的属性
比如设置以下属性的时候需同时表明是在哪个状态(State):
// 设置标题
- (void)setTitle:(nullable NSString *)title forState:(UIControlState)state; // default is nil. title is assumed to be single line
// 设置标题颜色
- (void)setTitleColor:(nullable UIColor *)color forState:(UIControlState)state UI_APPEARANCE_SELECTOR; // default if nil. use opaque white
// 设置标题阴影颜色
- (void)setTitleShadowColor:(nullable UIColor *)color forState:(UIControlState)state UI_APPEARANCE_SELECTOR; // default is nil. use 50% black
// 设置前景图片
- (void)setImage:(nullable UIImage *)image forState:(UIControlState)state; // default is nil. should be same size if different for different states
// 设置背景图片
- (void)setBackgroundImage:(nullable UIImage *)image forState:(UIControlState)state UI_APPEARANCE_SELECTOR; // default is nil
// 设置带属性的标题(NSAttributedString类型),设置麻烦不常用。
- (void)setAttributedTitle:(nullable NSAttributedString *)title forState:(UIControlState)state NS_AVAILABLE_IOS(6_0); // default is nil. title is assumed to be single line
读取属性
1. 获取当前状态的属性
使用点语法获取只读属性,如:
btn. currentTitle、btn. currentImage等等
2. 获取指定状态的属性
使用对象方法返回属性:
- (nullable NSString *)titleForState:(UIControlState)state; // these getters only take a single state value
- (nullable UIColor *)titleColorForState:(UIControlState)state;
- (nullable UIColor *)titleShadowColorForState:(UIControlState)state;
- (nullable UIImage *)imageForState:(UIControlState)state;
- (nullable UIImage *)backgroundImageForState:(UIControlState)state;
- (nullable NSAttributedString *)attributedTitleForState:(UIControlState)state NS_AVAILABLE_IOS(6_0);
内容对齐方式
因为UIButton继承自UIControl,而UIControl提供两个属性UIControlContentHorizontalAlignment和UIControlContentVerticalAlignment分别用来设置水平方向和垂直方向的对齐方式,对应效果如下:
UIButton中image与backgroundImage区别
由于System样式的按钮不显示前景图片(前文有演示),因此以下均是对Custom样式按钮进行探讨。
1. 层级关系
创建一个带有标题title,前景图片image和背景图片backgroundImage的按钮如下:
运行代码,然后捕捉视图的层级关系:
或者直接点击Xcode底部红框内按钮,然后可以查看当前视图的层级关系:
小结一下:
- 视图Z轴方向由里向外依次为backgroundImage--> image-->title
- image默认居左,title默认居右
2. 内容模式
backgroundImage的内容模式(contentMode)默认为UIViewContentModeScaleToFill,backgroundImage会跟随按钮的大小的改变而改变,也就是说背景图片始终等于按钮尺寸。
对于image就比较怪:当图片的宽(或高)小于按钮尺寸时,image显示的是原始宽(或高);当图片宽(或高)大于按钮尺寸时,image被压缩到与button等宽(或高)的尺寸。这种内容模式我叫不上名儿来。。。
对于image或者backgroundImage的contentMode属性,苹果没有提供修改的途径(至少我没找到)。所以当我们使用image的时候,最好先调好尺寸,对于比较大的图片,先进行必要的压缩裁切。(不过笔者通常不会这么干,如果需要自定义比较高的button,我就直接用view来做外观显示,然后再套上一个透明的button~)
总结
- 按钮的Z轴方向由里向外依次为backgroundImage--> image-->title
- image默认居左,title默认居右
- backgroundImage尺寸永远等于按钮尺寸
- 对于image:当图片的宽(或高)小于按钮尺寸时,image显示的是原始宽(或高);当图片宽(或高)大于按钮尺寸时,image被压缩到与button等宽(或高)的尺寸。
- image和backgroundImage的contentMode属性无法修改。
四、控制状态(UIControlState)
在set按钮的私有属性的时候,通常会一并forState指明在哪个控制状态。那么UIButton总共有几个状态呢?以下是UIControlState枚举值:
typedef NS_OPTIONS(NSUInteger, UIControlState) {
UIControlStateNormal = 0, // 普通状态(按下之前)
UIControlStateHighlighted = 1 << 0, // 高亮状态(按下ing)
UIControlStateDisabled = 1 << 1, // 失效状态(enable=NO)
UIControlStateSelected = 1 << 2, // 选中状态(selected=YES)
UIControlStateFocused NS_ENUM_AVAILABLE_IOS(9_0) = 1 << 3, // 聚焦状态(iOS9.0开始引入,应该和3D Touch有关)
UIControlStateApplication = 0x00FF0000, // additional flags available for application use(不明觉厉)
UIControlStateReserved = 0xFF000000 // 苹果预留位,憋管它。。。
};
我们看到,与普通的枚举不同,UIControlState是位枚举。也就是说,按钮可以同时拥有不止一个状态!
- if(isSelected == NO),有两种状态:UIControlStateNormal 和 UIControlStateHighlighted
- if(isSelected == YES),也有两种状态 UIControlStateSelected 和 UIControlStateSelected | UIControlStateHighlighted
也就是说:当没有选中状态下,按下的时候对应高亮模式(UIControlStateHighlighted);而当按钮已经是选中状态,此时再按下按钮即对应高亮模式位和选中模式(UIControlStateSelected | UIControlStateHighlighted)。
五、添加事件
前面铺垫了这么多,接下来该讲讲UIButton的主要作用了——响应事件。要响应事件,首先需给button添加对指定事件的监听机制(add target/action),即添加事件。
UIButton能响应的事件(UIControlEvents)有很多,枚举值如下:
UIControlEventTouchDown // 单点触摸按下(用户点触屏幕,或者又有新手指落下的时候)
UIControlEventTouchDownRepeat // 多点触摸按下(点触计数大于1:用户按下第二、三、或第四根手指的时候)
UIControlEventTouchDragInside // 当一次触摸在控件内拖动
UIControlEventTouchDragOutside // 当一次触摸在控件外拖动
UIControlEventTouchDragEnter // 当一次触摸从控件外拖动到内部
UIControlEventTouchDragExit // 当一次触摸从控件内部拖动到外部
UIControlEventTouchUpInside // 所有在控件之内触摸抬起
UIControlEventTouchUpOutside // 所有在控件之外触摸抬起(点触起始必须落在控件内部才会发送通知)
UIControlEventTouchCancel // 所有触摸取消事件(如一次触摸因为放上了太多手指而被取消,或者被上锁或者电话呼入打断)
UIControlEventValueChanged // 当控件的值发生改变
UIControlEventPrimaryActionTriggered NS_ENUM_AVAILABLE_IOS(9_0) // 当控件的首要行为被触发,例如button的点击事件,slider的滑动事件(iOS9.0引入)
UIControlEventEditingDidBegin // 当控件中文本开始编辑时
UIControlEventEditingChanged // 当控件中文本发生改变时
UIControlEventEditingDidEnd // 当控件中文本编辑结束时
UIControlEventEditingDidEndOnExit // 当文本控件内通过按下回车键(或等价行为)结束编辑时
UIControlEventAllTouchEvents // 所有触摸事件均触发通知
UIControlEventAllEditingEvents // 所有文本编辑事件均触发通知
UIControlEventApplicationReserved // 苹果预留给应用使用,不去理会
UIControlEventSystemReserved // 苹果预留给内部框架使用,不去理会
UIControlEventAllEvents // 所有事件均触发通知
添加事件:
/**
添加点击事件
addTarget:(参数1) 响应目标(由谁来执行响应方法)
action:(参数2) 调用方法(即响应事件)
forControlEvents:(参数3) 事件的类型
*/
[btn addTarget:self action:@selector(btnAction:) forControlEvents:UIControlEventTouchUpInside];
响应方法:
#pragma mark - 按钮响应方法
- (void)btnAction:(UIButton *)btn {
NSLog(@"点击了按钮");
}
示例
#import "ViewController.h"
@interface ViewController ()
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
// 实例化一个UIButton
UIButton *btn = [UIButton buttonWithType:UIButtonTypeCustom];
/* 设置属性 */
btn.frame = CGRectMake(0, 0, 100, 80 ); // 设置位置尺寸
btn.center = CGPointMake([UIScreen mainScreen].bounds.size.width/2, [UIScreen mainScreen].bounds.size.height/2);
btn.backgroundColor = [UIColor purpleColor]; // 设置背景颜色
btn.alpha = 1.0f; // 设置透明度
btn.layer.cornerRadius = 5.0; // 设置圆角(5.0是圆角的弧度)
btn.layer.borderWidth = 1.0f; // 设置边框宽度
btn.layer.borderColor = [UIColor blackColor].CGColor; //设置边框颜色
btn.contentVerticalAlignment = UIControlContentVerticalAlignmentCenter; // 设置垂直方向对齐方式
btn.contentHorizontalAlignment = UIControlContentHorizontalAlignmentCenter; // 设置水平方向对齐模式
// 设置标题文字
[btn setTitle:@"普通" forState:UIControlStateNormal];
[btn setTitle:@"高亮" forState:UIControlStateHighlighted];
[btn setTitle:@"选中" forState:UIControlStateSelected];
[btn setTitle:@"选中状态下的高亮" forState:UIControlStateHighlighted|UIControlStateSelected];
// 设置前景图
// [btn setImage:[UIImage imageNamed:@"11"] forState:UIControlStateNormal];
// 设置背景图
[btn setBackgroundImage:[UIImage imageNamed:@"red"] forState:UIControlStateNormal];
[btn setBackgroundImage:[UIImage imageNamed:@"goodFilling"] forState:UIControlStateHighlighted];
[btn setBackgroundImage:[UIImage imageNamed:@"red"] forState:UIControlStateHighlighted|UIControlStateSelected];
[btn setBackgroundImage:[UIImage imageNamed:@"red"] forState:UIControlStateSelected];
/**
添加点击事件
addTarget:(参数1) 响应目标(由谁来执行响应方法)
action:(参数2) 调用方法(即响应事件)
forControlEvents:(参数3) 事件的类型
*/
[btn addTarget:self action:@selector(btnAction:) forControlEvents:UIControlEventTouchUpInside];
// 添加btn到self.view
[self.view addSubview:btn];
}
#pragma mark - 按钮响应方法
- (void)btnAction:(UIButton *)btn {
NSLog(@"点击了按钮");
}
@end