JGProgressHUD

现代且功能丰富的iOS风格的进度HUD。

概述

iOS终极进度HUD已到来：JGProgressHUD！
• 设计良好，易于使用。
• 功能丰富。
• 可扩展和可定制（自定义动画、指示视图等）。
• 使用iOS的最新功能：模糊HUD（iOS 8+）、视差效果（iOS 7+）。
• 与iOS 6后向兼容。
• 文档齐全并得到良好的维护。
• 当键盘出现/消失时检测并重新定位。
• 支持Voice Over/UIAccessibility。
• 最重要的是，它看起来很好！

示例项目包含了所有不同类型的JGProgressHUD用法。查看代码，看看JGProgressHUD能做什么！

自定义

样式

JGProgressHUD可以以3种样式显示
• 超轻
• 轻
• 暗

指示视图

默认情况下，HUD将显示一个不确定的进度指示器。您可以通过将indicatorView属性设置为nil来不显示任何指示视图。这些指示视图包括以下几种：
• 不确定的进度指示器
• 饼形进度指示器
• 环形进度指示器
• 成功指示器
• 错误指示器
• 图片指示器
通过子类化JGProgressHUDIndicatorView，您可以创建一个自定义指示视图！

动画

默认情况下，HUD将使用淡入淡出动画。可以根据动画持续时间或动画曲线等多个参数进行更改。可以不使用动画显示HUD，也可以使用不同的动画。默认内置以下动画：
• 淡入淡出
• 缩放和淡入淡出

通过继承 JGProgressHUDAnimation，您可以创建自定义动画！

要灰化HUD后面的内容，请将您的灰化颜色设置为 JGProgressHUD 实例的 backgroundColor。

要求

• iOS 8 或更高版本的基 SDK。
• iOS 6.0 或更高版本的部署目标。
• ARC。

JGProgressHUD 也可以由 Swift 编写的项目使用。有关详细信息，请参阅 安装。

文档

详细文档可以在 CocoaDocs 上找到。

每个方法都有详细文档，这使得快速了解 JGProgressHUD 变得容易。要开始，请查看 JGProgressHUD.h。

示例

显示不确定的进度条

JGProgressHUD *HUD = [JGProgressHUD progressHUDWithStyle:JGProgressHUDStyleDark];
HUD.textLabel.text = @"Loading";
[HUD showInView:self.view];
[HUD dismissAfterDelay:3.0];

这将显示一个带有旋转器和标题“正在加载”的黑色 HUD，它以淡入动画呈现，并且在 3 秒后以淡出动画消失。

显示错误消息

JGProgressHUD *HUD = [JGProgressHUD progressHUDWithStyle:JGProgressHUDStyleDark];
HUD.textLabel.text = @"Error";
HUD.indicatorView = [[JGProgressHUDErrorIndicatorView alloc] init]; //JGProgressHUDSuccessIndicatorView is also available
[HUD showInView:self.view];
[HUD dismissAfterDelay:3.0];

显示自定义图片

JGProgressHUD *HUD = [JGProgressHUD progressHUDWithStyle:JGProgressHUDStyleDark];
HUD.indicatorView = [[JGProgressHUDImageIndicatorView alloc] initWithImage:[UIImage imageNamed:@"my_image.png"]];
[HUD showInView:self.view];
[HUD dismissAfterDelay:3.0];

显示确定进度条

JGProgressHUD *HUD = [JGProgressHUD progressHUDWithStyle:JGProgressHUDStyleDark];
HUD.indicatorView = [[JGProgressHUDPieIndicatorView alloc] initWithHUDStyle:HUD.style]; //Or JGProgressHUDRingIndicatorView
[HUD showInView:self.view];
[HUD dismissAfterDelay:3.0];

重要：您应该在 UIViewController 的视图中显示 HUD。

有关更多示例实现的示例，请参阅 示例 项目。

安装

CocoaPods
请将其添加到您的 Podfile

pod 'JGProgressHUD'

或者

框架（仅限 iOS >= 8.0）
1. 将 JGProgressHUD.xcodeproj 文件拖动到您的 Xcode 项目中。
2. 将 JGProgressHUD.framework 添加到项目的目标中的“通用”选项卡的“嵌入的二进制文件”。
3. 将 -ObjC 标志添加到项目目标的“构建设置”选项卡中的“其他链接器标志”。

请参阅 示例 项目以了解 JGProgressHUD 作为框架的示例实现。

将 JGProgressHUD 作为框架包含后，可以像这样导入 JGProgressHUD.h

#import <JGProgressHUD/JGProgressHUD.h>

Swift 项目

import JGProgressHUD

或者

静态库
1. 将 JGProgressHUD.xcodeproj 文件拖动到您的 Xcode 项目中。
2. 将 JGProgressHUD 和 JGProgressHUD Resources 添加到项目目标的“构建阶段”选项卡中的“目标依赖”。
3. 将 libJGProgressHUD.a添加到“链接二进制文件与库”。
4. 从 JGProgressHUD.xcodeproj 的“产品”目录中拖动 JGProgressHUD Resources.bundle 到“复制捆绑资源”部分。
5. 将 -ObjC 标志添加到项目目标的“构建设置”选项卡中的“其他链接器标志”。

请参阅 示例 项目以了解 JGProgressHUD 作为静态库的示例实现。

将 JGProgressHUD 作为静态库包含后，可以像这样导入 JGProgressHUD.h

#import "JGProgressHUD.h"

Swift 项目需要在 Objective-C 互联络头中导入 JGProgressHUD。

RubyMotion

您可以在 此处 找到 RubyMotion 项目中 JGProgressHUD 的示例。

屏幕截图

许可协议

MIT 许可协议。
© 2014-2016, Jonas Gessner。

致谢

由 Jonas Gessner 创建和维护，© 2014-2016。