提醒对话框SPAlertController剖析(iOS)

SPAlertController的github地址:https://github.com/SPStore/SPAlertController

前言

• 本框架采用VFL布局，不依赖任何框架，用起来和系统的UIAlertController极为相似，最终的显示效果和微信微博保持高度一致。
• 适配了iPhoneX，支持旋转，支持毛玻璃效果。

如何导入

版本2.0

platform:ios,'8.0'
target 'MyApp' do
  pod 'SPAlertController', '~> 2.0'
end
然后在终端输入命令:pod install 

如何使用

• 第一步：创建SPAlertController

SPAlertController *alertController = [SPAlertController alertControllerWithTitle:@"这是大标题" message:@"这是小标题" preferredStyle:SPAlertControllerStyleActionSheet animationType:SPAlertAnimationTypeDefault];

说明:
preferredStyle是提醒对话框的弹出样式，SPAlertControllerStyleActionSheet是从底部或者顶部弹出（顶部还是底部取决于animationType），SPAlertControllerStyleAlert从中间弹出，animationType是动画类型，有从底部往上弹出动画，从顶部往下弹出动画，从中间渐变弹出动画，缩放弹出动画等

• 第二步：创建action

SPAlertAction *actionOK = [SPAlertAction actionWithTitle:@"OK" style:SPAlertActionStyleDefault handler:^(SPAlertAction * _Nonnull action) {
        
    }];
    
说明:
方法参数中的style是action的样式，这里跟系统的一致，共有SPAlertActionStyleDefault、SPAlertActionStyleCancel(取消)、SPAlertActionStyleDestructive(默认红色)这3种样式，跟系统不一样的是，SPAlertController可以自定义action的相关属性，如文本颜色、字体等;
block块:当点击action的时候回调

• 第三步：添加action

[alertController addAction:actionOK];

• 第四步：modal出alertController

[self presentViewController:alertController animated:YES completion:nil];

以上这就是最基本的四步操作，当然你可以中间再设置alertController的属性或者action的属性，至于具体哪些属性干什么，示例程序中有非常详细的注释.

添加文本输入框

[alertController addTextFieldWithConfigurationHandler:^(UITextField * _Nonnull textField) {
        // 这个block只会回调一次，因此可以在这里自由定制textFiled，如设置textField的相关属性，设置代理，添加addTarget，监听通知等。注意，2.0版本后，直到present后textField才有superView
}];

自定义

自定义是本框架的一个侧重点，很多人封装类似这种对话框时，都是内部规定好了自定义的格局，那样基本是对他自己公司而言才有效，自定义的布局五花八门，我们不可能封装出一套布局满足所有需求，所以我的做法是，直接让开发者自由布局，布局好了之后将自定义好的view当作方法参数传给SPAlertController就行了.

• 1. 自定义整个弹出视图

MyView *myView = [MyView shareMyView];
    
SPAlertController *alertController = [SPAlertController alertControllerWithTitle:@"这是大标题" message:@"这是小标题" preferredStyle:SPAlertControllerStyleAlert animationType:SPAlertAnimationTypeAlpha customView:myView];
[self presentViewController:alertController animated:YES completion:nil];
    
说明:
自定义整个弹出视图时,添加action或textField没有任何作用，因为已经自定义了整个视图，自带的内部布局将不起作用

• 2. 自定义headerView

MyHeaderView *myHeaderView = [[MyHeaderView alloc] initWithFrame:CGRectMake(0, 0, 0, 200)];
SPAlertController *alertController = [SPAlertController alertControllerWithPreferredStyle:SPAlertControllerStyleAlert animationType:SPAlertAnimationTypeDefault customHeaderView:myHeaderView];
SPAlertAction *action1 = [SPAlertAction actionWithTitle:@"第1个" style:SPAlertActionStyleDefault handler:^(SPAlertAction * _Nonnull action) {
     NSLog(@"点击了第1个");
}];
    
SPAlertAction *action2 = [SPAlertAction actionWithTitle:@"第2个" style:SPAlertActionStyleDestructive handler:^(SPAlertAction * _Nonnull action) {
    NSLog(@"点击了第2个");
}];
[alertController addAction:action1];
[alertController addAction:action2];
[self presentViewController:alertController animated:YES completion:nil];

说明:
为什么要自定义headerView？有这样的的需求吗？答案是肯定的，因为SPAlertController自带的headerView只能显示文本且居中，如果想往里面添加图片则自带的就不管用了，这时便可以在外界自定义好一个headerView，创建时当参数传进去，SPAlertController便会帮你显示在对话框的顶部

• 3. 自定义centerView

MyCenterView *centerView = [[MyCenterView alloc] initWithFrame:CGRectMake(0, 0, 0, 200)];
    
SPAlertController *alertController = [SPAlertController alertControllerWithTitle:@"这是大标题" message:@"这是小标题" preferredStyle:SPAlertControllerStyleAlert animationType:SPAlertAnimationTypeDefault customCenterView:centerView];

SPAlertAction *action1 = [SPAlertAction actionWithTitle:@"第1个" style:SPAlertActionStyleDefault handler:^(SPAlertAction * _Nonnull action) {
    NSLog(@"点击了第1个");
}];
// 设置第1个action的颜色
action1.titleColor = [UIColor blueColor];

// SPAlertActionStyleDestructive默认文字为红色(可修改)
SPAlertAction *action2 = [SPAlertAction actionWithTitle:@"第2个" style:SPAlertActionStyleDestructive handler:^(SPAlertAction * _Nonnull action) {
    NSLog(@"点击了第2个");
}];
// 设置第2个action的颜色
action2.titleColor = [UIColor redColor];
[alertController addAction:action1];
[alertController addAction:action2];
[self presentViewController:alertController animated:YES completion:nil];

说明:
有时看见过这样的对话框，顶部是一个title，最底部有2个action，中间是一个tableView；这里自定义centerView就是解决这个需求。

先记作n = maxNumberOfActionHorizontalArrangementForAlert;(maxNumberOfActionHorizontalArrangementForAlert是本框架的一个属性：最大水平排列个数);

当自定义centerView时，如果是SPAlertControllerStyleAlert样式，action的个数最多只能是n个，超过n个将不显示，只显示最前面n个添加的；如果是SPAlertControllerStyleActionSheet样式，只有取消（SPAlertActionStyleCancel）样式才会显示，其余样式的action均不会显示

• 4. 自定义footerView

MyFooterView *footerView = [MyFooterView shareMyFooterView];
    SPAlertController *alertController = [SPAlertController alertControllerWithTitle:@"苹果logo" message:nil preferredStyle:SPAlertControllerStyleAlert animationType:SPAlertAnimationTypeDefault customFooterView:footerView];
    SPAlertAction *action2 = [SPAlertAction actionWithTitle:@"我是一个按钮" style:SPAlertActionStyleCancel handler:^(SPAlertAction * _Nonnull action) {
        NSLog(@"点击了 我是一个按钮");
    }];
[alertController addAction:action2];
[self presentViewController:alertController animated:YES completion:nil];

• 讲一下对话框的宽高 :

1. SPAlertControllerStyleAlert样式下对话框的默认宽度恒为屏幕
   宽-40,高度最大为屏幕高-40,如果想设置对话框的宽度以及修改最大高度,可以通过调整maxMarginForAlert属性来设置,高度上只要没有超出最大高度，会自适应内容.
2. SPAlertControllerStyleActionSheet样式下对话框的默认宽度 恒为屏幕宽,高度最大为屏幕高,外界无法通过任何属性修改宽度,最大高度可通过maxTopMarginForActionSheet属性来修改,高度上只要没超出最大高度,会自适应内容.

• 关于自定义的view的宽高如何让给定？
  当自定义view时,如果宽度小于等于0,或者大于等于对话框的默认宽度,内部会自动处理为等宽于对话框的默认宽,除此之外,自定义view的高度在对话框最大高度范围内的情况下:自定义view的大小是多大,显示出来就是多大;从这里也可以看出,如果自定义view时想用对话框的默认宽度,宽度设置为0或者足够大就行了. 稍微要注意的是假如你采用的是自动布局/xib/storyboard,宽度设置为0可能会有约束警告.

难点属性

/** alert样式下，弹窗的中心y值，为正向下偏移，为负向上偏移 */
@property (nonatomic, assign) CGFloat offsetYForAlert;

/** alert样式下,水平排列的最大个数,如果大于了这个数,则所有action将垂直排列,默认是2.
    由于水平排列的action都是排布在footerView上,所以如果自定义了footerView，该属性将失去效用
 */
@property (nonatomic, assign) NSInteger maxNumberOfActionHorizontalArrangementForAlert;

/** 是否需要对话框拥有毛玻璃,默认为YES----Dialog单词是对话框的意思 */
@property (nonatomic, assign) BOOL needDialogBlur;

/** 是否单击背景退出对话框,默认为YES */
@property (nonatomic, assign) BOOL tapBackgroundViewDismiss;

/** 设置蒙层的外观样式,可通过alpha调整透明度,如果设置了毛玻璃样式,设置alpha<1可能会有警告,警告是正常的 */
- (void)setBackgroundViewAppearanceStyle:(SPBackgroundViewAppearanceStyle)style alpha:(CGFloat)alpha;

效果图

1A20B204D250B3DBFE973A4EC0C5209F.jpg 2DB32E8A0446B214C5EDC97998B127BA.jpg 03A721F9F6A4F39346134F7EEE49FA2E.jpg 3DB1CF20C14DFE9103B827F06BE5ACE5.jpg 3E8019BA57F447785BD2561ECF95D234.jpg 4DB2CAFA218FEE08E36578C94F2A5B71.jpg 06A97B9DBDE3F07D2207BAA2085D25C6.jpg 9C6F94D5ECF90CE6A94D90D507DB18EC.jpg 19E17ECCD0C1A8CE7D0499CD8AF06A2F.jpg 30D02B422FC9CA27F5CBA37FF85BADE6.jpg 57DDD7273486D292452471FAFDDC9F18.jpg 36186FEFDD89D2356EFEF140093A28A7.jpg A76E51AC536052790CD80C184E803432.jpg CDD1F2ADE694932980AB1509921FB628.jpg EAEFB2EAA7932E456E7D85238E2C73C7.jpg F6C0259AFBAD7E5F651CB1FD41796DEF.jpg F62036E227097E7BA876A8594F25D643.jpg 1FE9B512B50D7E139B30E0BDB5B3FF6E.jpg 86C4035CB7097B99FA89706E3668055E.jpg 91B2F76B900C0EA9B5E34B8AE64CAB36.jpg 1776B8F36B3C3051C2C2FE3AE12D843F.jpg