iOS App 上极易于使用的 HUD。
- 增加 setMaskBackgroundAlpha 方法, 自定义背景的不透明度;
- 增加 setMargin 方法,用于自定义内容间距;
- 适配 Swift 5
- 增加 isShowing 属性,用于判断是否已经显示
- 增加 onlyOnceFont 参数,用于临时显示一次的字体,不影响全局默认字体;
- 增加 autoDismissDelay 参数,用于临时使用自动消失时间,不影响全局默认自动消失时间;
- 显示加载和文字信息
- 显示 Gif 加载和文字信息
- 显示进度
- 显示图片和文字信息
- 显示情景信息(info、success、error)
- 显示 Toast 样式信息
- 遮罩自定义显示
- 显示动画
- 自定义(背景色、前景色、字体、自动消失间隔秒、遮罩、动画类型、毛玻璃效果...),满足极大多数场景
- 显示完成回调
- 临时显示字体
- 临时使用自动消失时间
- iOS 8.0 +
- Xcode 8 +
- Swift 3.0 +
https://github.com/WangWenzhuang/ZKProgressHUD.git
你可以使用 CocoaPods 安装 ZKProgressHUD
,在你的 Podfile
中添加:
platform :ios, '8.0'
use_frameworks!
target 'MyApp' do
pod 'ZKProgressHUD'
end
如果使用 Swift 5 请使用最新版5.0.1
pod 'ZKProgressHUD', '5.0.1'
如果使用 Swift 4.2 请使用最新版3.5版本
pod 'ZKProgressHUD', '3.5'
如果使用 Swift 4.0 请使用3.1版本
pod 'ZKProgressHUD', '3.1'
如果使用 Swift 3.2 请使用1.5版本
pod 'ZKProgressHUD', '1.5'
- 拖动
ZKProgressHUD
文件夹到您的项目 - 将
ZKProgressHUD.bundle
添加到项目资源中Targets->Build Phases->Copy Bundle Resources
import ZKProgressHUD
ZKProgressHUD.showMessage("开始使用 ZKProgressHUD 吧", completion: {
// 输入代码
})
回调支持的函数有:
- showImage
- showMessage
- showInfo
- showSuccess
- showError
ZKProgressHUD.show()
ZKProgressHUD.show("正在拼命的加载中🏃🏃🏃")
ZKProgressHUD.showGif(gifUrl: Bundle.main.url(forResource: "loding", withExtension: "gif"), gifSize: 80)
ZKProgressHUD.showGif(gifUrl: Bundle.main.url(forResource: "loding", withExtension: "gif"), gifSize: 80, status: "正在拼命的加载中🏃🏃🏃")
ZKProgressHUD.showProgress(1 / 10)
ZKProgressHUD.showImage(UIImage(named: "image"))
ZKProgressHUD.showImage(UIImage(named: "image"), status: "图片会自动消失😏😏😏")
ZKProgressHUD.showInfo("Star 一下吧😙😙😙")
ZKProgressHUD.showSuccess("操作成功👏👏👏")
ZKProgressHUD.showError("出现错误了😢😢😢")
ZKProgressHUD.showMessage("开始使用 ZKProgressHUD 吧")
ZKProgressHUD.dismiss()
ZKProgressHUD.dismiss(delay: 3)
setMargin (_ margin: CGFloat)
/// 隐藏
/// hide
/// 显示
/// visible
setMaskStyle (_ maskStyle: ZKProgressHUDMaskStyle)
/// 淡入/淡出(默认)
/// fade
/// 缩放
/// zoom
/// 飞入
/// flyInto
setAnimationShowStyle (_ animationShowStyle: ZKProgressHUDAnimationShowStyle)
setMaskBackgroundColor(_ color: UIColor)
setMaskBackgroundAlpha(_ alpha: CGFloat)
设置前景色,默认值:.white(前景色在设置 effectStyle 值时会自动适配,如果要使用自定义前景色,在调用 setEffectStyle 方法后调用 setForegroundColor 方法即可)
setForegroundColor(_ color: UIColor)
setEffectStyle(_ hudEffectStyle: ZKProgressHUDEffectStyle)
setEffectAlpha(_ effectAlpha: CGFloat)
设置 HUD 背景色(与 effectStyle 互斥,如果设置背景色,effectStyle = .none),默认值:UIColor(red: 0 / 255.0, green: 0 / 255.0, blue: 0 / 255.0, alpha: 0.8)
setBackgroundColor(_ color: UIColor)
setFont(_ font: UIFont)
setCornerRadius(_ cornerRadius: CGFloat)
/// 圆圈
/// circle
/// 系统样式(菊花)
/// system
setAnimationStyle(_ animationStyle: ZKProgressHUDAnimationStyle)
setAutoDismissDelay(_ delay: Int)