SPAlertController

[x] 采用VFL布局，3.0版本开始核心控件为UIStackView，风格与微信几乎零误差
[x] 3.0版本开始对话框头部新增图片设置
[x] 3.0版本开始action支持图片设置
[x] 3.0版本开始，iOS11及其以上系统可单独设置指定action后的间距
[x] 3.0版本开始支持富文本
[x] action的排列可灵活设置垂直排列和水平排列
[x] 每个action的高度自适应
[x] 支持旋转(横竖屏)
[x] 可以自定义各种UIView
[x] 支持对话框毛玻璃和背景蒙层毛玻璃
[x] 全面适配iPhoneX，iPhoneXR，iPhoneXS，iPhoneXS MAX

Swift版本新增功能

[x] 对话框抖动效果
[x] 对话框拖拽退出动画
[x] 适配了iOS13 dark模式
[x] 增加了自定义背景
[x] 适配Swift5

直接使用

把SPAlertController文件夹拖拽到项目中直接使用

cathage

版本1.0

#git "https://github.com/dongxiexidu/SPAlertController.git" "master"

使用示例

import SPAlertController

let alertController = SPAlertController.alertController(withTitle: "我是主标题", message: "我是副标题", preferredStyle: .actionSheet)
let action1 = SPAlertAction.action(withTitle: "Default", style: .default) { (action) in
    print("点击了Default")
}
let action2 = SPAlertAction.action(withTitle: "Destructive", style: .destructive) { (action) in
    print("点击了Destructive")
}
let action3 = SPAlertAction.action(withTitle: "Cancel", style: .cancel) { (action) in
    print("点击了Cancel------")
}
alertController.addAction(action: action1)
alertController.addAction(action: action3)
alertController.addAction(action: action2)
self.present(alertController, animated: true, completion: nil)

API及属性详解

创建SPAlertController

public class func alertController(withTitle title: String?,
                                       message: String?,
                                       preferredStyle: SPAlertControllerStyle)
                                       ->SPAlertController

public class func alertController(withTitle title: String?,
                                       message: String?,
                                       preferredStyle: SPAlertControllerStyle,
                                       animationType: SPAlertAnimationType)
                                       ->SPAlertController

上面2种创建方式唯一的区别就是：第2种方式多了一个animationType参数，该参数可以设置弹出动画。如果以第一种方式创建，会采用默认动画，默认动画跟preferredStyle 有关，如果是SPAlertControllerStyle.actionSheet样式，默认动画为从底部弹出，如果是SPAlertControllerStyle.alert样式，默认动画为从中间弹出

SPAlertController的头部配置

title，对话框的主标题
message，对话框的副标题
attributedTitle，对话框的主标题，富文本
attributedMessage，对话框的副标题，富文本
image，对话框的头部上的图标，位置处于主标题之上
titleColor，对话框主标题的颜色
titleFont，对话框主标题的字体
messageColor，对话框副标题的颜色
messageFont，对话框副标题的字体
textAlignment，对话框标题的对齐方式（标题指主标题和副标题）
imageLimitSize，对话框头部图标的限制大小，默认是无穷大

SPAlertController的action配置

// 添加action，actions里面存放的就是添加的所有action

public func addAction(action: SPAlertAction)
//MARK: TODO: readonly
public var actions: [SPAlertAction] = [SPAlertAction]()

// 添加文本输入框，textFields存放的就是添加的所有textField

public func addTextFieldWithConfigurationHandler(handler: ((UITextField)->Void)?)

var textFields = [UITextField]()

// SPAlertControllerStyleActionSheet样式下：默认为UILayoutConstraintAxisVertical(垂直排列),
如果设置为UILayoutConstraintAxisHorizontal(水平排列)，则除去取消样式action之外的其余action将水平排列；
SPAlertControllerStyleAlert样式下：当actions的个数大于2，或者某个action的title显示不全时
为UILayoutConstraintAxisVertical(垂直排列)，
否则默认为UILayoutConstraintAxisHorizontal(水平排列)，此样式下设置该属性可以修改所有action的排列方式；
不论哪种样式，只要外界设置了该属性，永远以外界设置的优先

public var actionAxis: NSLayoutConstraint.Axis?

SPAlertControllerStyleActionSheet样式下的垂直排列和水平排列

SPAlertControllerStyleAlert样式下的垂直排列和水平排列

// 该属性配置的是距离屏幕边缘的最小间距；SPAlertControllerStyleAlert样式下该属性是指
对话框四边与屏幕边缘之间的距离，此样式下默认值随设备变化，SPAlertControllerStyleActionSheet
样式下是指弹出边的对立边与屏幕之间的距离，比如如果从右边弹出，
那么该属性指的就是对话框左边与屏幕之间的距离，此样式下默认值为70

public var minDistanceToEdges: CGFloat = 70

图中红色画线都是指minDistanceToEdges

// 该属性是制造对话框的毛玻璃效果，采用的是系统私有类_UIDimmingKnockoutBackdropView所实现

public var needDialogBlur: Bool = false

// SPAlertControllerStyleAlert下的偏移量配置 ,CGPoint类型，y值为正向下偏移，
为负向上偏移；x值为正向右偏移，为负向左偏移，该属性只对SPAlertControllerStyleAlert样式有效,
键盘的frame改变会自动偏移，如果外界手动设置偏移只会取手动设置的

public var offsetForAlert: CGPoint = .zero

public func setOffsetForAlert(_ offsetForAlert: CGPoint, animated: Bool)

// 该API是设置和获取指定action后面的间距，如图中箭头所指，iOS11及其以上才支持

@objc @available(iOS 11.0, *)
public func setCustomSpacing(spacing: CGFloat, aferAction action: SPAlertAction?)

internal func customSpacingAfterActionIndex(_ index: Int) -> CGFloat

 // 该API是设置背景蒙层的样式，分为半透明和毛玻璃效果，毛玻璃又细分为Dark，ExtraLight，Light3种样式
 
public func setBackgroundViewAppearanceStyle(_ style: SPBackgroundViewAppearanceStyle, alpha: CGFloat)

// 单击背景蒙层是否退出对话框，默认YES

public var tapBackgroundViewDismiss: Bool = true

// 圆角半径
public var cornerRadius: CGFloat = 6.0

创建action

// 其中，title为action的标题，创建的时候仅支持普通文本，如果要使用富文本，
// 可以另外设置action的属性attributedTitle，设置后会覆盖普通文本

public class func action(withTitle title: String?,
                    style: SPAlertActionStyle,
                    handler: @escaping (SPAlertAction)->Void) -> SPAlertAction

配置action

title，action的标题
attributedTitle，action的富文本标题，普通文本和富文本同时设置时，只会显示富文本
image，action上的图片，文字和图片都存在时，图片在左，文字在右
imageTitleSpacing，图片与文字之间的间距
titleColor，action标题的颜色
titleFont，action标题的字体
titleEdgeInsets，action标题的内边距，此属性能够改变action的高度
isEnabled，action是否能被点击

自定义各大View

自定义对话框的头部

public class func alertController(withCustomHeaderView customHeaderView: UIView,
                                              preferredStyle: SPAlertControllerStyle,
                                              animationType: SPAlertAnimationType)
    ->SPAlertController {

}

自定义整个对话框

public class func alertController(withCustomAlertView customAlertView: UIView,
                                              preferredStyle: SPAlertControllerStyle,
                                              animationType: SPAlertAnimationType)
       ->SPAlertController {
}

自定义对话框的action部分

public class func alertController(withCustomActionSequenceView customActionSequenceView: UIView,
                                                       title: String,
                                                       message: String,
                                                       preferredStyle: SPAlertControllerStyle,
                                                       animationType: SPAlertAnimationType) -> SPAlertController{

}

关于自定义view的大小

非自动布局，在传入自定义view之前，应该为自定义的view设置好frame，也可以在传入自定义view之后，调用API- public func updateCustomViewSize(size: CGSize)设置其大小；
自动布局，如果宽度和高度都能由子控件撑起来，那么你不需要设置frame，否则，宽度和高度只要有其中一个无法由子控件撑起，那么就必须设置其值，比如高度能被子控件撑起来，而宽度不能，那么你就必须手动设置一个宽度，高度可以不用设置或者设置为0都可。如果是xib或者storyboard，若自定义的view无法由子控件撑起来，SPAlertController会读取xib/storyboard中的默认frame，如果不合适，那么你应该修改xib/storyboard中的默认frame或者用纯代码重新设置frame。如果自定义view的宽度能够被子控件撑起，但同时又手动设置了自定义view的宽度，那么SPAlertController会取自动撑起的宽度和手动设置的宽度中较大的那个，高度同理。有一种情况要值得注意：如果子控件类似按钮这种不设置大小就自动会产生大小的子控件，同时该按钮设置了左右间距，那么它就能将自定义的view的宽度撑起，但是这种撑起来的宽度可能并非你想要的，因为按钮宽度是由内容自动产生，不是你设置的，这时你应该手动设置按钮的宽度，以便自定义的view的宽度被撑起的恰到好处，或者手动设置自定义view的宽度，这个手动设置的宽度，应该要比没有手动设置宽度的按钮将自定义view撑起来的宽度要大。
当自定义的view的大小在对话框显示期间发生了变化，你应该调用- public func updateCustomViewSize(size: CGSize)通知SPAlertController更新其大小

具体示例,可以下载demo查看

历史版本

版本	更新日期	支持最低系统版本	更新内容
v1.0	2020.01.15	iOS9
回到顶部