WangWenzhuang / ZKProgressHUD翻译 / 编辑

最近提交:5天前
创建时间:2017.03.10

语言构成

Swift97.9%
Ruby2.1%

README

(logo)

ZKProgressHUD

license build CocoaPods platform

iOS App 上极易于使用的 HUD。

demo

近期更新

  • 适配 Swift 4.2
  • 增加 onlyOnceFont 参数,用于临时显示一次的字体,不影响全局默认字体;
  • 增加 autoDismissDelay 参数,用于临时使用自动消失时间,不影响全局默认自动消失时间;

实现功能

  • 显示加载和文字信息
  • 显示 Gif 加载和文字信息
  • 显示进度
  • 显示图片和文字信息
  • 显示情景信息(info、success、error)
  • 显示 Toast 样式信息
  • 遮罩自定义显示
  • 显示动画
  • 自定义(背景色、前景色、字体、自动消失间隔秒、遮罩、动画类型、毛玻璃效果...),满足极大多数场景
  • 显示完成回调
  • 临时显示字体
  • 临时使用自动消失时间

运行环境

  • iOS 8.0 +
  • Xcode 8 +
  • Swift 3.0 +

安装

CocoaPods

你可以使用 CocoaPods 安装 ZKProgressHUD,在你的 Podfile 中添加:

platform :ios, '8.0'
use_frameworks!

target 'MyApp' do
    pod 'ZKProgressHUD'
end

如果使用 Swift 4.2 请使用最新版3.2

pod 'ZKProgressHUD', '3.2'

如果使用 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

快速使用

导入 ZKProgressHUD

import ZKProgressHUD

显示完成回调(新增)

ZKProgressHUD.showMessage("开始使用 ZKProgressHUD 吧", completion: {
    // 输入代码
})

回调支持的函数有:

  • showImage
  • showMessage
  • showInfo
  • showSuccess
  • showError

显示加载

ZKProgressHUD.show()

显示加载和文字

ZKProgressHUD.show("正在拼命的加载中🏃🏃🏃")

显示 Gif 加载

ZKProgressHUD.showGif(gifUrl: Bundle.main.url(forResource: "loding", withExtension: "gif"), gifSize: 80)

显示 Gif 和文字加载

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("出现错误了😢😢😢")

显示 Toast 样式信息

ZKProgressHUD.showMessage("开始使用 ZKProgressHUD 吧")

隐藏

ZKProgressHUD.dismiss()

延迟隐藏

ZKProgressHUD.dismiss(delay: 3)

自定义显示样式

style1 style2 style3 style4 style5 style6

设置遮罩样式,默认值:.visible

/// 隐藏
/// hide
    
/// 显示
/// visible
setMaskStyle (_ maskStyle: ZKProgressHUDMaskStyle)

设置动画显示/隐藏样式,默认值:.fade

/// 淡入/淡出(默认)
/// fade

/// 缩放
/// zoom

/// 飞入
/// flyInto
setAnimationShowStyle (_ animationShowStyle: ZKProgressHUDAnimationShowStyle)

设置遮罩背景色,默认值:.black

setMaskBackgroundColor(_ color: UIColor)

设置前景色,默认值:.white(前景色在设置 effectStyle 值时会自动适配,如果要使用自定义前景色,在调用 setEffectStyle 方法后调用 setForegroundColor 方法即可)

setForegroundColor(_ color: UIColor)

设置 HUD 毛玻璃效果(与 backgroundColor 互斥,如果设置毛玻璃效果不是.none,则根据样式自动设置前景色),默认值:.dark

setEffectStyle(_ hudEffectStyle: ZKProgressHUDEffectStyle)

设置 HUD 毛玻璃透明度,默认值:1

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)

设置字体,默认值:UIFont.boldSystemFont(ofSize: 15)

setFont(_ font: UIFont)

设置圆角,默认值:6

setCornerRadius(_ cornerRadius: CGFloat)

设置加载动画样式动画样式,默认值:circle

/// 圆圈
/// circle

/// 系统样式(菊花)
/// system
setAnimationStyle(_ animationStyle: ZKProgressHUDAnimationStyle)

设置自动隐藏延时秒数,默认值:2

setAutoDismissDelay(_ delay: Int)

讨论区

说说你的看法