QYProgressHUD 1.0.4

QYProgressHUD 1.0.4

×

由 Joeyoung 维护。

QYProgressHUD 1.0.4

  • 由
  • joeyoung

QYProgressHUD

使用方法

直接调用类方法 [QYProgressHUD show] 来展示加载动画，调用类方法 [QYProgressHUD dismiss] 隐藏动画。

  • 在展示和隐藏动画时无需关注线程问题，内部已做了相关处理；
  • 支持屏幕旋转，动画视图会随屏幕旋转；
  • 在加载动画期间 userInteractionEnabled = NO，默认禁止交互；
  • 由于在工程中使用频繁，该类是单例；
  • 相对于其他加载动画库，此类不扩展其他功能，实现简单，仅用于加载动画；
  • 所有加载动画相关参数都在.m文件头部宏定义处，尚未公开（如有需要可自行修改）。
/**
show loading request animation.
*/
+ (void)show;

/**
dismiss loading animation.
*/
+ (void)dismiss;

示例

// 显示加载动画
[QYProgressHUD show];
// 隐藏加载动画
[QYProgressHUD dismiss];

效果

浅析QYProgressHUD：

  • QYProgressHUD 继承自 UIWindow，整个视图设计分为3层：backgroundView 全屏背景，foregroundView HUD 动画背景，activityIndicator 小菊花动画。
  • backgroundView 全屏背景：因为背景修改了 alpha，直接把 self 当做背景的话，会影响其子视图透明度；
  • foregroundView HUD 动画背景：设计这一层是为了以后项目有新需求，可以直接在该视图层进行扩展；
  • activityIndicator 小菊花动画：采用的系统视图。

当调用类方法 show 展现动画时，先执行单例方法，返回单例对象；然后调用实例方法 qy_startAnimating 添加加载动画。

+ (void)show {
    [[self sharedInstance] qy_startAnimating];
}

因为实例方法 qy_startAnimating 中要进行视图添加、动画等操作，所以包裹在主线程中执行的。

    dispatch_async(dispatch_get_main_queue(), ^{
        ...
    });

单例新建一个 Window，无需 addSubview，默认创建是被添加到屏幕最上层的。只需要设置对应的 hidden = NO 即可显示出来。

调用类方法 dismiss 移除动画，先执行单例方法，返回单例对象；然后调用实例方法 qy_stopAnimating 移除加载动画；该方法主要做了移除视图等操作。

+ (void)dismiss {
    [[self sharedInstance] qy_stopAnimating];
}

如果我们创建出的 UIWindow 需要处理键盘事件，可以将其设置为KeyWindow。KeyWindow是被系统设计用来接收键盘和其他非触摸事件的UIWindow。可以通过 makeKeyWindow 和 resignKeyWindow 用来设置。

具体的实现细节请查看源码，如有不足，欢迎指正！

要求

安装

QYProgressHUD 可通过 CocoaPods 获取。要安装，只需将以下行添加到您的 Podfile 文件中

pod 'QYProgressHUD'

作者

qiaoyoung, [email protected]

许可

QYProgressHUD 在 MIT 许可下可用。有关更多信息，请参阅 LICENSE 文件。