DMProgressHUD iOS进度加载提示工具开源项目

我要开发同款
DamonMok2017年11月10日
89阅读
所属分类Objective-C、iOS代码库、进度条(Progress)
授权协议MIT

作品详情

一、简介

DMProgressHUD是一款用于显示异步操作任务进度状态的视图工具。该工具包含了目前较为主流的加载状态视图类型,后续会根据具体情况或需求进行迭代。DMProgressHUD从设计层次的角度来看,其包含了5种展示模式:

Loading(加载中相关);

Progress(进度具体值相关);

Status(状态相关,例如成功、失败等提示);

Text(文字提示相关);

Custom(自定义视图相关)。

二、导入(Platform:ios>=8.0)方案1:CocoaPods

在Podfile文件加入 pod'DMProgressHUD';

在终端输入 podinstall;

在需要使用的地方导入头文件 #import<DMProgressHUD.h>。

方案2:直接导入到工程

把DMProgressHUD.h、DMProgressHUD.m和DMProgressImgs.bundle(图片资源bundle)导入到工程目录下;

在需要使用的地方导入头文件 #import"DMProgressHUD.h"。

三、快捷调用

注意:快捷调用使用默认的样式(Style-Dark)、动画(Animation-gradient)、遮盖(Mask-None)。

1.LoadingMode

1.1Loading-Indicator

loading_indicator.gif

    DMProgressHUD *hud = [DMProgressHUD showLoadingHUDAddedTo:self.view];    //hud.loadingType = DMProgressHUDLoadingTypeIndicator;//默认    hud.text = @"Here's info";        dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{        //异步耗时操作        [self doSomething];                dispatch_async(dispatch_get_main_queue(), ^{            //返回主线程隐藏HUD            [hud dismiss];        });    });

1.2Loading-Circle

loading_circle_.gif

    DMProgressHUD *hud = [DMProgressHUD showLoadingHUDAddedTo:self.view];    hud.loadingType = DMProgressHUDLoadingTypeCircle;    hud.text = @"Here's info";        dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{        //异步耗时操作        [self doSomething];                dispatch_async(dispatch_get_main_queue(), ^{            //返回主线程隐藏HUD            [hud dismiss];        });    });2.ProgressMode

2.1Progress-Circle

progress_circle.gif

    DMProgressHUD *hud = [DMProgressHUD showProgressHUDAddedTo:self.view];    //hud.progressType = DMProgressHUDProgressTypeCircle;//默认    hud.text = @"Here's info";        dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{        //异步耗时操作        [self doSomething];                dispatch_async(dispatch_get_main_queue(), ^{            //返回主线程隐藏HUD            [hud dismiss];        });    });

2.2Progress-Sector

progress_sector.gif

    DMProgressHUD *hud = [DMProgressHUD showProgressHUDAddedTo:self.view];    hud.progressType = DMProgressHUDProgressTypeSector;    hud.text = @"Here's info";        dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{        //异步耗时操作        [self doSomething];                dispatch_async(dispatch_get_main_queue(), ^{            //返回主线程隐藏HUD            [hud dismiss];        });    });3.StatusMode

3.1Success

status_success.gif

    DMProgressHUD *hud = [DMProgressHUD showStatusHUDAddedTo:self.view statusType:DMProgressHUDStatusTypeSuccess];    hud.text = @"Here's info";        dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{        //异步耗时操作        [self doSomething];                dispatch_async(dispatch_get_main_queue(), ^{            //返回主线程隐藏HUD            [hud dismiss];        });    });

3.2Fail

status_fail.gif

    DMProgressHUD *hud = [DMProgressHUD showStatusHUDAddedTo:self.view statusType:DMProgressHUDStatusTypeFail];    hud.text = @"Here's info";        dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{        //异步耗时操作        [self doSomething];                dispatch_async(dispatch_get_main_queue(), ^{            //返回主线程隐藏HUD            [hud dismiss];        });    });

3.3Warning

status_warning.gif

    DMProgressHUD *hud = [DMProgressHUD showStatusHUDAddedTo:self.view statusType:DMProgressHUDStatusTypeWarning];    hud.text = @"Here's info";        dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{        //异步耗时操作        [self doSomething];                dispatch_async(dispatch_get_main_queue(), ^{            //返回主线程隐藏HUD            [hud dismiss];        });    });4.TextMode

4.1Text

text.gif

    DMProgressHUD *hud = [DMProgressHUD showTextHUDAddedTo:self.view];    hud.text = @"Here's info";        dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{        //异步耗时操作        [self doSomething];                dispatch_async(dispatch_get_main_queue(), ^{            //返回主线程隐藏HUD            [hud dismiss];        });    });5.CustomMode

5.1Custom

custom.gif

    DMProgressHUD *hud = [DMProgressHUD showHUDAddedTo:self.view];    hud.mode = DMProgressHUDModeCustom;//指定模式为自定义模式    hud.text = @"Here's info";    UIView *custom = [[UIImageView alloc] initWithImage:[UIImage imageNamed:@"person"]];    [hud setCustomView:custom width:180.0 height:180.0];//自定义View        dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{        //异步耗时操作        [self doSomething];                dispatch_async(dispatch_get_main_queue(), ^{            //返回主线程隐藏HUD            [hud dismiss];        });    });四、更多

关于调用:DMProgressHUD为调用者提供了快捷调用的方法,另外还提供了一些与额外功能相关的初始化方法供调用者使用;

关于外观:DMProgressHUD提供两种外观样式,对应分别是Dark/Light;

关于动画:DMProgressHUD默认使用颜色渐变(alpha)动画进行显示/隐藏,另外还有增量式动画和弹性动画供使用者选择;

关于遮盖:DMProgressHUD默认不使用遮盖,另外提供透明遮盖和灰色遮盖供使用者选择;

以上所列举关于DMProgressHUD的功能介绍,用户都可以 运行Demo 查看到相应的效果。除此之外,用户还可以对HUD的 图文间距、颜色等 进行自定义,可以在 DMProgressHUD.h 文件查看更多的API详细介绍。

由于时间仓促,本人技术水平有限,出现错误或疏漏之处请批评指正,也可以在下方留言或发送Email至damonmok1216@gmail.com。

Github地址:DMProgressHUD

声明:本文仅代表作者观点,不代表本站立场。如果侵犯到您的合法权益,请联系我们删除侵权资源!如果遇到资源链接失效,请您通过评论或工单的方式通知管理员。未经允许,不得转载,本站所有资源文章禁止商业使用运营!
下载安装【程序员客栈】APP
实时对接需求、及时收发消息、丰富的开放项目需求、随时随地查看项目状态

评论