在开发中,弹出提示框是必不可少的。这两天项目中统一对已经被iOS API废弃的UIAlertView和UIActionSheet进行替换,我们知道,UIAlertView和UIActionSheet都已经被iOS的API所废弃了。在两者的API中都建议用UIAlertController替代,并通过设置不同的类型风格来选择是原先的UIAlertView或UIActionSheet的形式。
之前项目中一直用的都是原先的UIAlertView和UIActionSheet风格,所以对UIAlertController的了解很少,这次也借着这次统一项目更新的机会对UIAlertController进行了一番学习和研究。UIAlertController是在iOS8.0中出现的一种统一的提示风格的界面,代替原来的UIAlertView和UIActionSheet两种类别。iOS中学习一个新知识最简单便捷的两种方法,一是看官网API,二是看应用示例代码。下面,我们也从这两个方面来学习一下UIAlertController。
一 UIAlertController的学习
UIAlertController的API很简单,其官网API戳这里。关于UIAlertController的API也非常简单,所有内容如下图所示。从图中我们可以看到UIAlertController的内容主要分为五个部分:创建对象、配置UIAlertController对象的属性、配置UIAlertController上面的按钮、配置UIAlertController上面的文本框、常量。下面,我们结合实例对这些方法和常量进行学习。
UIAlertController提示器的使用分为三步,创建UIAlertController提示器对象-->配置UIAlertController提示器上的按钮-->显示UIAlertController提示器。
1.1 UIAlertController提示器对象的创建
UIAlertController提示器的创建主要是通过类方法来进行创建的,其中第一个参数是标题,第二个参数是内容信息,第三个参数UIAlertControllerStyle则是选择所创建的UIAlertController对象的类型是UIAlertView 还是 UIActionSheet。UIAlertControllerStyle是一个枚举类型,其定义就是在UIAlertController.h文件中。
+ (instancetype)alertControllerWithTitle:(NSString *)title message:(NSString *)message preferredStyle:(UIAlertControllerStyle)preferredStyle;
typedef NS_ENUM(NSInteger, UIAlertControllerStyle) { UIAlertControllerStyleActionSheet = 0, UIAlertControllerStyleAlert } NS_ENUM_AVAILABLE_IOS(8_0);
创建常用代码如下:
//UIAlertView风格 UIAlertController* alert = [UIAlertController alertControllerWithTitle:@"My Alert" message:@"This is an alert." preferredStyle:UIAlertControllerStyleAlert]; //UIActionSheet风格 UIAlertController* alert = [UIAlertController alertControllerWithTitle:@"My Alert" message:@"This is an alert." preferredStyle:UIAlertControllerStyleActionSheet];
1.2 UIAlertController提示器的配置
在UIAlertController提示器中,我们常用的配置有两类,一是根据需要添加按钮,并味蕾个按钮添加点击事件;二是根据需要添加文本框,用于和用户进行更多的交互。
1.2.1 UIAlertController上添加按钮
UIAlertController上的每一个按钮都是一个UIAlertAction,与UIAlertController的类型是UIAlertView 还是 UIActionSheet无关。UIAlertAction的定义也是就在UIAlertController.h文件中,如下。我们需要在UIAlertController提示器添加一个按钮时,先创建一个UIAlertAction,然后通过UIAlertController的 addAction: 方法将创建的UIAlertAction对象添加就OK了。
NS_CLASS_AVAILABLE_IOS(8_0) @interface UIAlertAction : NSObject+ (instancetype)actionWithTitle:(nullable NSString *)title style:(UIAlertActionStyle)style handler:(void (^ __nullable)(UIAlertAction *action))handler; @property (nullable, nonatomic, readonly) NSString *title; @property (nonatomic, readonly) UIAlertActionStyle style; @property (nonatomic, getter=isEnabled) BOOL enabled; @end
创建UIAlertAction对象直接用UIAlertAction的类方法就可以创建了,其中第一个参数是按钮的标题;第二个参数UIAlertActionStyle是选择按钮的风格类型,有三种选择:常规、取消和销毁风格类型;第三个参数是一个Block,定义了按钮的点击响应事件。
+ (instancetype)actionWithTitle:(nullable NSString *)title style:(UIAlertActionStyle)style handler:(void (^ __nullable)(UIAlertAction *action))handler;
UIAlertActionStyle是一个枚举类型,其定义也是在UIAlertController.h文件中。
typedef NS_ENUM(NSInteger, UIAlertActionStyle) { UIAlertActionStyleDefault = 0, //常规类型,默认蓝色字体 UIAlertActionStyleCancel, //取消类型,默认蓝色字体 UIAlertActionStyleDestructive //销毁类型,默认红色字体,表示可能是要删除信息 } NS_ENUM_AVAILABLE_IOS(8_0);
常规用法示例如下:
//创建对象 UIAlertController *alert = [UIAlertController alertControllerWithTitle:nil message:nil preferredStyle:UIAlertControllerStyleActionSheet]; //添加销毁按钮 UIAlertAction* destructiveBtn = [UIAlertAction actionWithTitle:@"销毁按钮" style:UIAlertActionStyleDestructive handler:^(UIAlertAction * action) { NSLog(@"UIAlertActionStyleDestructive"); }]; [alert addAction: destructiveBtn]; //添加默认按钮 UIAlertAction* defaultBtn = [UIAlertAction actionWithTitle:@"常规按钮" style:UIAlertActionStyleDefault handler:^(UIAlertAction * action) { NSLog(@"UIAlertActionStyleDefault"); }]; [alert addAction:albumBtn]; //添加取消按钮 UIAlertAction* cancelBtn = [UIAlertAction actionWithTitle:@"取消按钮" style:UIAlertActionStyleCancel handler:^(UIAlertAction * action) { NSLog(@"UIAlertActionStyleCancel"); }]; [alert addAction:cancelBtn];
1.2.2 UIAlertController上添加文本框
上面我们讲到了如何在UIAlertController提示器上添加按钮,但是有时候,我们需要在提示器上添加一个或多个文本框让用户填写一些信息,在UIAlertController中也提供了一个方法直接可以在提示器上添加文本框。只有一个参数,就是一个Block,用于我们队该文本框进行配置,比喻说其字体大小,行数限制等等,都可以在该Block中进行设置。
- (void)addTextFieldWithConfigurationHandler:(void (^)(UITextField *textField))configurationHandler;
常见用法示例如下:
[alert addTextFieldWithConfigurationHandler:^(UITextField * _Nonnull textField) { NSLog(@"添加一个textField就会调用 这个block"); }];
但是,值得注意的有两点:
- 文本框的添加只能是在UIAlertController的风格类型为UIAlertView时才有
- 文本框的添加多个
我们可以看到,在配置文本框这里还有一个参数是textFields,这各参数是一个只读数组类型,用于获取UIAlertController提示器上所有的文本框对象,这个经常在我们点击按钮时用这个来获取到每一个文本框,并取得用户填写的信息。
@property(nonatomic, readonly) NSArray*textFields;
常见用法如下:
UIAlertController *alert = [UIAlertController alertControllerWithTitle:@"title" message:@"message" preferredStyle:UIAlertControllerStyleAlert]; //添加文本框 [alert addTextFieldWithConfigurationHandler:^(UITextField * _Nonnull textField) { //设置键盘输入为数字键盘 textField.keyboardType = UIKeyboardTypeNumberPad; textField.placeholder = @"请填写"; }]; UIAlertAction *cancelBtn = [UIAlertAction actionWithTitle:@"取消" style:UIAlertActionStyleCancel handler:^(UIAlertAction * _Nonnull action) { //取消 }]; [alert addAction: cancelBtn]; //添加确定按钮 UIAlertAction *confirmBtn = [UIAlertAction actionWithTitle:@"确定" style:UIAlertActionStyleDefault handler:^(UIAlertAction * _Nonnull action) { //文本框结束编辑,收起键盘 [[alertVC.textFields firstObject] endEditing:YES]; NSLog(@"%@", [alert.textFields firstObject].text); //获取文本框填写的内容 NSString *meetingId = [alertVC.textFields firstObject].text.trim; if(meetingId.length > 12){ [weakSelf showHUDWithText:@"会议号过长"]; }else{ [weakSelf enterVideoMeeting:meetingId]; } }]; [alert addAction: confirmBtn];
1.3 UIAlertController提示器的显示
UIAlertController提示器的显示则很简单,从提示器的类名UIAlertController可以看出,提示器是一个viewController,因此,要显示提示器,我们一般是是当前viewController的 presentViewController: animated: completion: 方法进行推出,我们创建的提示器。
[self presentViewController:alert animated:YES completion:nil];
1.4 UIAlertController提示器的使用
常规使用示例:
//创建对象 UIAlertController *alertController = [UIAlertController alertControllerWithTitle:@"显示的标题" message:@"标题的提示信息" preferredStyle:UIAlertControllerStyleAlert]; //添加取消类型按钮 [alertController addAction:[UIAlertAction actionWithTitle:@"取消" style:UIAlertActionStyleCancel handler:^(UIAlertAction * _Nonnull action) { NSLog(@"点击取消"); }]]; //添加常规类型按钮 [alertController addAction:[UIAlertAction actionWithTitle:@"确定" style:UIAlertActionStyleDefault handler:^(UIAlertAction * _Nonnull action) { NSLog(@"点击确认"); }]]; //添加销毁类型按钮 [alertController addAction:[UIAlertAction actionWithTitle:@"警告" style:UIAlertActionStyleDestructive handler:^(UIAlertAction * _Nonnull action) { NSLog(@"点击警告"); }]]; //添加文本框 [alertController addTextFieldWithConfigurationHandler:^(UITextField * _Nonnull textField) { NSLog(@"添加一个textField就会调用 这个block"); }]; //显示 [self presentViewController:alertController animated:YES completion:nil];
运行的效果图如下图所示,左边是UIAlertView类型的效果图,右边是UIActionSheet类型的效果图。
二 UIAlertController中自定义
在一般情况下,我们只要弹出系统自带的弹出框就可以。but,在某些情况下,万恶的UI会要求你修改显示文字的大小、颜色,虽然系统自带有一种红色字体的UIAlertAction,但是这种Action并不能放在Cancel位置,所以,更多时候,需要我们自己修改文字字体和颜色。可是在公开的API接口中好像并没有对应的方法,那么我们应该怎么做呢?主要的方法有两种:
- 利用第三方控件
- 利用KVC方法进行自定义修改
2.1 利用第三方控件进行UIAlertController属性的自定义
现在Github上有着众多的Alert控件(如SCLAlertView等),相信有很多都可以满足大家的需求,只要使用Cocoapods添加添加第三方库就可以了。在这里我们就不详细进行介绍了。
2.2 利用KVC方法进行UIAlertController属性的自定义
有时候使用第三方控件会带来很多不必要的代码量和bug,所以能用系统自带的UIAlertController解决是最好的办法,这样当然也是可以的。苹果公司并没有完全的封死对UIAlertController的定制,而是修改为使用KVC的方法进行定制。如果要自定义标题和内容,可以通过NSAttributedString把字体和颜色设置好,然后在通过KVC的方法进行设置,就可以了。
- (void) test{ UIAlertController *alertController = [UIAlertController alertControllerWithTitle:@"提示" message:@"提示内容" preferredStyle:UIAlertControllerStyleAlert]; // UIAlertController *alertController = [UIAlertController alertControllerWithTitle:@"提示" message:@"提示内容" preferredStyle:UIAlertControllerStyleActionSheet]; //修改title NSMutableAttributedString *alertControllerStr = [[NSMutableAttributedString alloc] initWithString:@"提示"]; [alertControllerStr addAttribute:NSForegroundColorAttributeName value:[UIColor redColor] range:NSMakeRange(0, 2)]; [alertControllerStr addAttribute:NSFontAttributeName value:[UIFont systemFontOfSize:17] range:NSMakeRange(0, 2)]; [alertController setValue:alertControllerStr forKey:@"attributedTitle"]; //修改message NSMutableAttributedString *alertControllerMessageStr = [[NSMutableAttributedString alloc] initWithString:@"提示内容"]; [alertControllerMessageStr addAttribute:NSForegroundColorAttributeName value:[UIColor greenColor] range:NSMakeRange(0, 4)]; [alertControllerMessageStr addAttribute:NSFontAttributeName value:[UIFont systemFontOfSize:20] range:NSMakeRange(0, 4)]; [alertController setValue:alertControllerMessageStr forKey:@"attributedMessage"]; //常规按钮 UIAlertAction *defaultAction = [UIAlertAction actionWithTitle:@"Default" style:UIAlertActionStyleDefault handler:nil]; //销毁按钮 UIAlertAction *destructiveAction = [UIAlertAction actionWithTitle:@"Destructive" style:UIAlertActionStyleDestructive handler:nil]; //取消按钮 UIAlertAction *cancelAction = [UIAlertAction actionWithTitle:@"Cancel" style:UIAlertActionStyleCancel handler:nil]; [alertController addAction:defaultAction]; [alertController addAction:destructiveAction]; [alertController addAction:cancelAction]; [self presentViewController:alertController animated:YES completion:nil]; }
效果如下图所示:
除了可以修改提示器的标题和内容信息的颜色和字号,我们还可以修改按钮控件的颜色和字号,具体方法如下:
//修改按钮 if (cancelAction valueForKey:@"titleTextColor") { [cancelAction setValue:[UIColor redColor] forKey:@"titleTextColor"]; }
效果图如下图所示: