luohancc / xnprogresshud

XNProgressHUD

一个丝滑、灵活的HUD

一款支持各种自定义的轻量级HUD，支持垂直、水平两种样式。XNProgressHUD非常灵活，所见的部分都可根据自己的要求进行自定义，包括自义动画效果或图片，只需要实现相关协议方法。

安装使用

 pod 'XNProgressHUD'

使用说明

// 设置显示位置
[XNHUD setPosition:CGPointMake(self.view.bounds.size.width/2, self.view.bounds.size.height * 0.7)];
// 设置主色调
[XNHUD setTintColor:[UIColor colorWithRed:38/255.0 green:50/255.0 blue:56/255.0 alpha:0.8]];
// 设置相应的maskType状态下的颜色（16进制颜色值）
[XNHUD setMaskType:(XNProgressHUDMaskTypeBlack)  hexColor:0x00000044];
[XNHUD setMaskType:(XNProgressHUDMaskTypeCustom) hexColor:0xff000044];

在UIWindow上显示：

[XNHUD showLoadingWithTitle:@"正在登录"];
[XNHUD showWithTitle:@"这是一个支持自定义的轻量级HUD"];
[XNHUD showInfoWithTitle:@"邮箱地址不能为空"];
[XNHUD showErrorWithTitle:@"拒绝访问"];
[XNHUD showSuccessWithTitle:@"操作成功"];

在UIViewController上显示（maskType.enable=true时，导航栏依然可以接受点击事件）

// 引入'UIViewController+XNProgressHUD.h'
[self.hud showLoadingWithTitle:@"正在登录"];
[self.hud showWithTitle:@"这是一个支持自定义的轻量级HUD"];
[self.hud showInfoWithTitle:@"邮箱地址不能为空"];
[self.hud showErrorWithTitle:@"拒绝访问"];
[self.hud showSuccessWithTitle:@"操作成功"];

在UIView上显示

UIView *view = [[UIView alloc] initWithFrame:CGRectMake(0, 0, 300, 300)];
[self.view addSubview:view];
// 设置显示的目标View并传入显示位置
[XNHUD setTargetView:view position:CGPointMake(view.bounds.size.width/2,  view.bounds.size.height/2)];
[XNHUD showLoadingWithTitle:@"指定显示在某个View上"];

属性和方法说明

显示时长minimumDelayDismissDuration作用于非加载样式的视图：XNAnimationViewStyleInfoImage、XNAnimationViewStyleError、XNAnimationViewStyleSuccess； 显示时长maximumDelayDismissDuration作用与加载样式的视图：XNAnimationViewStyleLoading、XNAnimationViewStyleProgress。

@property (nonatomic, assign) NSTimeInterval minimumDelayDismissDuration; //default:1.5f
@property (nonatomic, assign) NSTimeInterval maximumDelayDismissDuration; //default:20.f

延时显示时间和延时消失时间，该方法只对下一次HUD显示生效（只生效一次）。

[XNHUD setDisposableDelayResponse:1.0f delayDismiss:2.0f];

设置排列方向，默认为垂直方向

[XNHUD setOrientation:XNProgressHUDOrientationHorizontal];

自定义XNProgressHUD

你可以自定义某一个状态下的动画，步骤非常简单，喜欢XNAnimationView中相应的Layer就行了，如果你想替换所有状态下的动画，请重写XNAnimationView。

这里就介绍这么多，其他功能自行探索。

GitHub地址

https://github.com/LuohanCC/XNProgressHUD

如果你觉得不错，请给我Star ★★★★★★★★★★

xnprogresshud's Issues

好用。

希望提供dismiss后的回调

您好，添加UIView上显示的分类

远程仓库已经更新了 但pod search XNProgressHUD 查询不到

支持最小宽度

非常感谢大力支持！谢谢！

在vertical的情况下，如果标题过于短，而自定义的图标和padding都比较大的话，就会显示成瘦的长方形。可否支持下最小宽度，让他看起来没那么扁？

流程问题

网络请求中习惯 [self.targetHud show];
结束后 [self.targetHud dismiss];
需要文字提示的时候showWithTitle
[self.targetHud show];
[self.targetHud dismiss];
[self.targetHud showWithTitle:@"这是一个支持自定义的轻量级HUD"];
这样的效果提示框会一闪而过，dismiss中有个animate延迟问题

setDisposableDelayResponse 马上dismiss后卡住

[[XNProgressHUD shared] setDisposableDelayResponse:0.3 delayDismiss:60];
[[XNProgressHUD shared] dismiss];
我想避免多次弹框问题，网络请求前延迟展示loading,请求后取消loading，如果0.3秒内返回了，就导致消失不掉的问题
被return了，里边玄虚弹出时候定时器处理也有点混乱

• (void)didDismissOnMainQueue {
  BOOL showing = self.showing;

  __block UIView *targetView = self.targetView;
  if (!showing && [self isWindowAndIsNotKeyWindow:(targetView)]) {
  targetView.hidden = YES;
  }
  if(!showing) return;

状态的过渡动画问题

尝试如下操作：

            XNProgressHUD.shared()?.show()
            Async.main(after: 5) {
                XNProgressHUD.shared()?.showError(withTitle: "请求失败")
                Async.main(after: 5) {
                    XNProgressHUD.shared()?.showSuccess(withTitle: "请求成功")
                }
            }

在loading > error的过程中，titleLabel的动画是从左上角下来的，有点儿奇怪。

加载中突然转变为弹出文字提示，文字出现的时候视图点击不动

// maskView
if(self.isMaskEnable) {
self.maskView.backgroundColor = [self maskColorWithMaskType:self.maskType];
[self addSubviewIfNotContain:self.maskView superView:targetView];
}else{//需要重置回来
[self removeFromSuperview:self.maskView];
}

为什么每次update后都会报错？

要重新删除库后，再添加，才可以，这是为什么？

loading样式时如何关掉视图的交互呢?

在ipad上，旋转屏幕后，hud将不再居中了。

使用的是全局的shared实例。

现在竖屏模式显示一次，然后再切换横屏之后再显示，就错位了。

能否设置显示的层级UIWindowLevel？

现在如果有个弹窗model，则hud可能会被隐藏在后面显示。

如何设置优先级UIWindowLevel为：statusBar的等？

增加阴影的属性设置

目前好像只能设置颜色，不能设置阴影位置什么的

支持自定义设置_padding属性？

支持自定义设置_padding属性？