SVProgressHUD的详细使用

导库

pod 'SVProgressHUD'

使用CocoaPads安装第三方库


  • SVProgressHUD 都有什么特点呢?

  1. 提示当前的状态,如:网络传输、提交中、操作成功或失败等;

  2. 可设置提示的 pop layer 是否为 model,提示的时候是否允许用户做其他操作;

  3. 可以设置背景色和自定义提示的内容;

  4. iOS 提示信息使用比较广泛的有 SVProgressHUDMBProgressHUB 两种,MBProgressHUD比较全面,但是SVProgressHUD比较轻量级,使用起来非常简洁,代码量非常少。


使用:

因为都是类方法,引入头文件#import "SVProgressHUD.h",直接在控制器用类名引用就好,很方便

1. 经常使用的提示框方法:

 + (void)showSuccessWithStatus:(nullable NSString*)status;
效果图
+ (void)showErrorWithStatus:(nullable NSString*)status;
效果图
+ (void)showWithStatus:(nullable NSString*)status;
效果图
//也是加载中的提示框,不过没有文字
+ (void)show;
效果图
+ (void)showInfoWithStatus:(nullable NSString*)status;
效果图
+ (void)showProgress:(float)progress;

// 如果要在下方显示文字,可以用这个方法
+ (void)showProgress:(float)progress status:(nullable NSString*)status;
显示进度的,图为0.1的进度,满了为1
// 这个方法可以修改提示框上面的图标可以调用这个方法
+ (void)showImage:(UIImage*)image status:(NSString*)status

/* 这个方法还有一种用法就是提示纯文字,因为SVProgressHUD不支持直接提示纯文字,但可以通过调用这个方法来实现提示纯文字,就是不传image就行了,
因为参数image没有__nonNull修饰,所以不能直接传nil,会报警告,虽然不报错。我们可以传一张空图片进去,写法如下*/
[SVProgressHUD showImage:[UIImage imageNamed:@""] status:@"提示纯文字"];
提示纯文字

2.1 设置提示框背景和文字

     /*
        SVProgressHUDStyleLight,        // 白色半透明背景,字体黑色
        SVProgressHUDStyleDark,         // 黑色背景,字体白色
        SVProgressHUDStyleCustom        // 白色背景,字体黑色
     */
    //设置HUD的Style
    [SVProgressHUD setDefaultStyle:SVProgressHUDStyleDark];

    //设置HUD和文本的颜色
    [SVProgressHUD setForegroundColor:[UIColor greenColor]];

    //设置HUD背景颜色
    [SVProgressHUD setBackgroundColor:[UIColor magentaColor]];

    //设置提示框的边角弯曲半径
    [SVProgressHUD setCornerRadius:5];

以前HUD背景图层的样式可在提示框方法里面把参数穿进去,现在不行了


2.2 设置HUD背景图层的样式

/**
     *  SVProgressHUDMaskTypeNone:默认图层样式,当HUD显示的时候,允许用户交互。
     *
     *  SVProgressHUDMaskTypeClear:当HUD显示的时候,不允许用户交互。
     *
     *  SVProgressHUDMaskTypeBlack:当HUD显示的时候,不允许用户交互,且显示黑色背景图层。
     *
     *  SVProgressHUDMaskTypeGradient:当HUD显示的时候,不允许用户交互,且显示渐变的背景图层。
     *
     *  SVProgressHUDMaskTypeCustom:当HUD显示的时候,不允许用户交互,且显示背景图层自定义的颜色。
     */
    [SVProgressHUD setDefaultMaskType:SVProgressHUDMaskTypeCustom];

所谓背景图层样式就是,出现提示框,提示框外的背景的样式,比如背景红色调用SVProgressHUDMaskTypeGradient这个样式,就是这样的


渐变的

PS:显示提示框的时候,一般不允许用户交互,就是做其他操作,如点击其他按钮,因为默认就是允许交互,所以这个一定要设置下

2.3 设置加载中提示框的加载动画


     /*
        SVProgressHUDAnimationTypeFlat,     // 默认动画类型,自定义平面动画
        SVProgressHUDAnimationTypeNative    // iOS native UIActivityIndicatorView
     */
    //动画效果
    [SVProgressHUD setDefaultAnimationType:SVProgressHUDAnimationTypeFlat];
SVProgressHUDAnimationTypeFlat
SVProgressHUDAnimationTypeNative

3. 隐藏提示框的方法

 //设置多少秒后隐藏
    [SVProgressHUD dismissWithDelay:60.0];
 //这个相当于
 [self performSelector:@selector(dismiss) withObject:nil afterDelay:60];
- (void)dismiss{  
//这个是直接隐藏
    [SVProgressHUD dismiss];  
} 

4. 简单的封装

你在展示提示框设置了样式,在其他地方使用其他提示框即使不设置也是之前那个样式不是默认的样式,如果是在ViewController里面直接用self调用就行了,当然前提是导入文件。主要有四个方法,第一个是加载中,第二个是纯文字,第三个是失败,第四个是成功提示,三四可以在block里面编写在提示后要进行的操作,如跳转什么的,详细看demo

  • UIViewController+LYToast.h
#import <UIKit/UIKit.h>
#import "SVProgressHUD.h"

NS_ASSUME_NONNULL_BEGIN

typedef void(^__nullable completeAction)(void);

@interface UIViewController (LYToast)

/*
 隐藏hud
 */
- (void)hideLoadingHUD;
/*
 加载中+文字提示(文字可为空)
 */
- (void)showLoadingHUDWithMessage:(nullable NSString *)message;
/*
 纯文字提示
 */
- (void)showTextHUDWithMessage:(nonnull NSString *)message;
/*
 失败提示
 */
- (void)showWarningHUDWithMessage:(nullable NSString *)message completion:(completeAction)completion;
/*
 完成提示
 */
- (void)showCompletionHUDWithMessage:(nullable NSString *)message completion:(completeAction)completion;


@end

NS_ASSUME_NONNULL_END
  • UIViewController+LYToast.m
#import "UIViewController+LYToast.h"

@implementation UIViewController (LYToast)

- (void)hideLoadingHUD
{
    [SVProgressHUD dismiss];
}

- (void)showLoadingHUDWithMessage:(NSString *)message
{
    // 如果当前视图还有其他提示框,就dismiss
    [self hideLoadingHUD];
    
    [SVProgressHUD setDefaultStyle:SVProgressHUDStyleDark];
    [SVProgressHUD setCornerRadius:5];
    [SVProgressHUD setDefaultAnimationType:SVProgressHUDAnimationTypeNative];
    
    // 加载中的提示框一般不要不自动dismiss,比如在网络请求,要在网络请求成功后调用 hideLoadingHUD 方法即可
    if (message) {
        [SVProgressHUD showWithStatus:message];
    }else{
        [SVProgressHUD show];
    }
}

- (void)showTextHUDWithMessage:(NSString *)message
{
    [self hideLoadingHUD];
    
    [SVProgressHUD setDefaultStyle:SVProgressHUDStyleDark];
    [SVProgressHUD setCornerRadius:5];
    [SVProgressHUD setDefaultAnimationType:SVProgressHUDAnimationTypeNative];
    
    [SVProgressHUD showImage:[UIImage imageNamed:@""] status:message];
    
    [SVProgressHUD dismissWithDelay:2];
    
}


- (void)showCompletionHUDWithMessage:(NSString *)message completion:(completeAction)completion
{
    [self hideLoadingHUD];
    
    [SVProgressHUD setDefaultStyle:SVProgressHUDStyleDark];
    [SVProgressHUD setCornerRadius:5];
    [SVProgressHUD setDefaultAnimationType:SVProgressHUDAnimationTypeNative];
    
    [SVProgressHUD showSuccessWithStatus:message];
    
    [SVProgressHUD dismissWithDelay:2];
    if (completion) {
        dispatch_time_t popTime = dispatch_time(DISPATCH_TIME_NOW, 1 * NSEC_PER_SEC);
        dispatch_after(popTime, dispatch_get_main_queue(), ^{
            completion();
        });
    }
    
}

- (void)showWarningHUDWithMessage:(NSString *)message completion:(completeAction)completion
{
    [self hideLoadingHUD];
    
    [SVProgressHUD setDefaultStyle:SVProgressHUDStyleDark];
    [SVProgressHUD setCornerRadius:5];
    [SVProgressHUD setDefaultAnimationType:SVProgressHUDAnimationTypeNative];
    
    [SVProgressHUD showErrorWithStatus:message];
    
    [SVProgressHUD dismissWithDelay:2];
    if (completion) {
        dispatch_time_t popTime = dispatch_time(DISPATCH_TIME_NOW, 1 * NSEC_PER_SEC);
        dispatch_after(popTime, dispatch_get_main_queue(), ^{
            completion();
        });
    }
}

Demo地址

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,271评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,275评论 2 380
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,151评论 0 336
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,550评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,553评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,559评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,924评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,580评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,826评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,578评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,661评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,363评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,940评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,926评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,156评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,872评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,391评论 2 342