由于3.0版本的重大更新，此文档有新链接:https://www.jianshu.com/p/f55b98c352a7
SPAlertController的github地址:https://github.com/SPStore/SPAlertController
前言
- 本框架采用VFL布局，不依赖任何框架，用起来和系统的UIAlertController极为相似，最终的显示效果和微信一致。
- 适配了iPhoneX，支持旋转，支持毛玻璃效果。
如何导入
版本2.5.0
platform:ios,'8.0'
target 'MyApp' do
pod 'SPAlertController', '~> 2.5.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就行了.
- 自定义整个弹出视图
MyView *myView = [MyView shareMyView];
SPAlertController *alertController = [SPAlertController alertControllerWithTitle:@"这是大标题" message:@"这是小标题" preferredStyle:SPAlertControllerStyleAlert animationType:SPAlertAnimationTypeAlpha customView:myView];
[self presentViewController:alertController animated:YES completion:nil];
说明:
自定义整个弹出视图时,添加action或textField没有任何作用，因为已经自定义了整个视图，自带的内部布局将不起作用
- 自定义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便会帮你显示在对话框的顶部
- 自定义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均不会显示
- 自定义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];
- 讲一下对话框的宽高 :
- SPAlertControllerStyleAlert样式下对话框的默认宽度恒为屏幕
宽-40,高度最大为屏幕高-40,如果想设置对话框的宽度以及修改最大高度,可以通过调整maxMarginForAlert属性来设置,高度上只要没有超出最大高度，会自适应内容. - SPAlertControllerStyleActionSheet样式下对话框的默认宽度 恒为屏幕宽,高度最大为屏幕高,外界无法通过任何属性修改宽度,最大高度可通过maxTopMarginForActionSheet属性来修改,高度上只要没超出最大高度,会自适应内容.
- 关于自定义的view的宽高如何让给定？
1、如果自定义的view本身采用的是自动布局，如果自定义的view的大小是由内部子控件自动撑起，那么SPAlertController内部会获取到这个撑起后的大小去设置，此时自定义的view如果另行设置frame是无效也是无意义的；如果自定义的view的大小不是由子控件撑起，内部会调用layoutIfNeed计算自动布局后的frame, 如果是xib布的局不手动设置frame的话，那么SPAlertController会获取xib中默认的frame
2、如果采用的是非自动布局,那么外界应该对自定义的view手动设置frame
3、如果自定义的view重写了intrinsicContentSize，那么SPAlertController将会用intrinsicContentSize去设置自定义view的大小，也就是intrinsicContentSize优先级最高，无论哪种布局，都以它为先
难点属性
/** 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;
对话框毛玻璃实现原理
2.5.0版本之前，毛玻璃效果为了不受到背景遮罩的影响，采用的方式是对遮罩进行镂空，对话框多大，镂空的范围就多大；然而这样有各种弊端：比如对话框的大小和位置不好确定，比如屏幕旋转时，或者含有textView/textField时，对话框的位置都会发生变化，这时背景的镂空方位也得变，而这种变化的过程很难同步。2.5.0版本开始摈弃这种思路，新思路是，首先对背景遮罩后面的背景进行截图，即：[[UIScreen mainScreen] snapshotViewAfterScreenUpdates:NO]得到一张屏幕快照，然后将该快照作为对话框的第一个子视图，再对该快照添加模糊效果，即添加UIVisualEffectView，这样一来，毛玻璃效果就不会受到背景遮罩的影响
效果图
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
