FEEAlert - Swift 版 LEEAlert - 优雅的Alert ActionSheet
- 链式语法 结构优雅
- 支持alert类型与actionsheet类型
- 默认样式为Apple风格 可自定义其样式
- 支持自定义标题与内容 可动态调整其样式
- 支持自定义视图添加 同时可设置位置类型等 自定义视图size改变时会自动适应.
- 支持输入框添加 自动处理键盘相关的细节
- 支持屏幕旋转适应 同时可自定义横竖屏最大宽度和高度
- 支持自定义action添加 可动态调整其样式
- 支持内部添加的功能项的间距范围设置等
- 支持圆角设置 支持阴影效果设置
- 支持队列和优先级 多个同时显示时根据优先级顺序排队弹出 添加到队列的如被高优先级覆盖 以后还会继续显示等.
- 支持两种背景样式 1.半透明 (支持自定义透明度比例和颜色) 2.毛玻璃 (支持效果类型)
- 支持自定义UIView动画方法
- 支持自定义打开关闭动画样式(动画方向 渐变过渡 缩放过渡等)
- 支持iOS13 Dark样式
- 更多特性未来版本中将不断更新.
无论是Alert还是ActionSheet 这里我把它们内部的控件分为两类 一: 功能项类型 (Item) 二: 动作类型 (Action).
按照apple的风格设计 弹框分为上下两个部分 其中功能项的位置为 Header 既 头部, 而Action则在下部分.
功能项一般分为4种类型 1. 标题 2. 内容(也叫Message) 3.输入框 4.自定义的视图
Action一般分为3种类型 1. 默认类型 2. 销毁类型(Destructive) 3.取消类型(Cancel)
所以说 能添加的东西归根结底为两种 1. Item 2.Action 其余的都是一些设置等.
根据上面的概念 我来简单介绍一下API的结构:
所有添加的方法都是以 feeAddItem 和 feeAddAction 两个方法为基础进行的扩展.
查看源码 可以发现 无论是 feeTitle 还是 feeTextField 最终都是通过 feeAddItem 来实现的.
也就是说整个添加的结构是以他们两个展开的 , 这个仅作为了解即可.
// 完整结构
FEEAlert.alert.cofing.XXXXX.XXXXX.feeShow()
// 完整结构
FEEAlert.actionSheet.cofing.XXXXX.XXXXX.feeShow()
FEEAlert.alert.config
.feeTitle("标题") // 添加一个标题 (默认样式)
.feeContent("内容") // 添加一个标题 (默认样式)
.feeTextField { textField in // 添加一个输入框 (自定义设置)
// textfield设置Block
}
.feeCustomView(view) // 添加自定义的视图
.feeAction("默认Action") { //添加一个默认类型的Action (默认样式 字体颜色为蓝色)
// 点击事件Block
}
.feeDestructiveAction("销毁Action") { // 添加一个销毁类型的Action (默认样式 字体颜色为红色)
// 点击事件Block
}
.feeCancelAction("取消Action") { // 添加一个取消类型的Action (默认样式 alert中为粗体 actionsheet中为最下方独立)
// 点击事件Block
}
.feeShow() // 最后调用Show开始显示
FEEAlert.alert.config
.feeTitle { label in
// 自定义设置Block
// 关于UILabel的设置这里不多说了
label.text = "标题"
label.textColor = .red
}
.feeContent { label in
// 自定义设置Block
// 同标题一样
}
.feeTextField { textField in
// 自定义设置Block
// 关于UITextField的设置你们都懂的 这里textField默认高度为40.0f 如果需要调整可直接设置frame 当然frame只有高度是有效的 其他的均无效
textField.textColor = .red
}
.feeCustomView { custom in
// 自定义设置Block
// 设置视图对象
custom.view = view
// 设置自定义视图的位置类型 (包括靠左 靠右 居中 , 默认为居中)
custom.positionType = .left
// 设置是否自动适应宽度 (自适应宽度后 位置类型为居中)
custom.isAutoWidth = true
}
.feeAddAction { action in
// 自定义设置Block
// 关于更多属性的设置 请查看'LEEAction'类 这里不过多演示了
action.title = "确认"
action.titleColor = .blue
}
.feeShow()
FEEAlert.alert.config
.feeCornerRadius(10.0f) //弹框圆角曲率
.feeShadowOpacity(0.35f) //弹框阴影的不透明度 0.0 -- 1.0
.feeHeaderColor([UIColor whiteColor]) //弹框背景颜色
.feeBackGroundColor([UIColor whiteColor]) //屏幕背景颜色
.feeBackgroundStyleTranslucent(0.5f) //屏幕背景半透明样式 参数为透明度
.feeBackgroundStyleBlur(UIBlurEffectStyleDark) //屏幕背景毛玻璃样式 参数为模糊处理样式类型 `UIBlurEffectStyle`
.feeShow()
FEEAlert.alert.config
.feeHeaderInsets(UIEdgeInsetsMake(10, 10, 10, 10)) // 头部内间距设置 等于内部项的范围
.feeMaxWidth(280.0f) // 设置最大宽度 (固定数值 横竖屏相同)
.feeMaxHeight(400.0f) // 设置最大高度 (固定数值 横竖屏相同)
.feeConfigMaxWidth { (type, size) in // 设置最大宽度 (根据横竖屏类型进行设置 最大高度同理)
if type == .vertical {
// 竖屏类型
return 280.0
}
if type == .horizontal {
// 横屏类型
return 400.0
}
return 0.0
}
.feeShow()
FEEAlert.alert.config
.feeTitle("标题")
.feeItemInsets(UIEdgeInsets(top: 10, left: 0, bottom: 0, right: 0)) // 设置某一项的外边距范围 在哪一项后面 就是对哪一项进行设置
.feeContent("内容")
.feeItemInsets(UIEdgeInsets(top: 10, left: 0, bottom: 10, right: 0)) // 例如在设置标题后 紧接着添加一个feeItemInsets() 就等于为这个标题设置了外边距范围 以此类推
.feeShow()
/**
feeHeaderInsets 与 feeItemInsets 决定了所添加的功能项的布局 可根据需求添加调整.
*/
FEEAlert.alert.config
.feeOpenAnimationDuration(0.3) // 设置打开动画时长 默认为0.3秒
.feeCloseAnimationDuration(0.2) // 设置关闭动画时长 默认为0.2秒
.feeShow()
FEEAlert.alert.config
.feeOpenAnimationStyle([.orientationNone, .fade, .zoomEnlarge]) //设置打开动画样式的方向为上 以及淡入效果和缩放效果.
.feeCloseAnimationStyle([.orientationNone, .fade, .zoomShrink]) //设置关闭动画样式的方向为下 以及淡出效果和缩放效果.
.feeShow()
FEEAlert.alert.config
.feeOpenAnimationConfig { animatingBlock, animatedBlock in
// 可自定义UIView动画方法以及参数设置
UIView.animate(withDuration: 1.0, delay: 0, usingSpringWithDamping: 0.4, initialSpringVelocity: 1.0, options: .allowUserInteraction) {
animatingBlock() //调用动画中Block
} completion: { _ in
animatedBlock() //调用动画结束Block
}
}
.feeCloseAnimationConfig { animatingBlock, animatedBlock in
UIView.animate(withDuration: 0.5, delay: 0, options: .curveEaseOut, animations: {
animatingBlock()
}, completion: { finished in
animatedBlock()
})
}
.feeShow()
FEEAlert.alert.config
.feeQueue(true) // 设置添加到队列 默认不添加 (添加后 处于显示状态时 如果有新的弹框显示 会将它暂时隐藏 等新的弹框显示结束 再将其显示出来)
.feePriority(1) // 设置优先级 默认为0 按照优先级从高到低的顺序显示, 优先级相同时 优先显示最新的
.feeShow()
/**
优先级和队列结合使用会将其特性融合 具体效果请运行demo自行调试体验
*/
FEEAlert.alert.config
.feePresentation(FEEPresentation.windowLevel(.alert)) // 弹框window层级 默认UIWindowLevelAlert
.feeShouldAutorotate(true) // 是否支持自动旋转 默认为false
.feeSupportedInterfaceOrientations(.all) // 支持的旋转方向 默认为UIInterfaceOrientationMaskAll
.feeClickHeaderClose(true) // 点击弹框进行关闭 默认为false
.feeClickBackgroundClose(true) // 设置点击背景进行关闭 Alert默认 false , ActionSheet默认 true
.feeCloseComplete {
// 关闭回调事件
}
.feeShow()
// 关闭指定标识的Alert或ActionSheet
FEEAlert.close(identifier: "xxxx", completionBlock: {
// 关闭完成
})
// 关闭当前显示的Alert或ActionSheet
FEEAlert.close {
// 如果在关闭后需要做一些其他操作 建议在该Block中进行
}
- 在 AppDelegate 或 SceneDelegate 中设置主要Window:
FEEAlert.configMainWindow(window) - 添加的功能项顺序会决定显示的排列顺序.
- 当需要很复杂的样式时 如果默认提供的这些功能项无法满足, 建议将其封装成一个UIView对象 添加自定义视图来显示.
- ActionSheet中 取消类型的Action 显示的位置与原生位置相同 处于底部独立的位置.
- 设置最大宽度高度时如果使用
CGRectGetWidth([[UIScreen mainScreen] bounds])这类方法 请考虑iOS8以后屏幕旋转 width和height会变化的特性.
该库是由 LEEAlert 翻译为 Swift 版本，对于 Swift 进行一些适配，特别感谢 LEEAlert 的作者