快速入门

王朝学院·作者佚名  2016-08-27
窄屏简体版  字體: 小  |  中  |  大  |  超大  

简介

SVPRogressHUD是简单易用的显示器,用于指示一个持续进行的任务的进度.

项目主页:SVProgressHUD

最新示例:点击下载快速入门安装通过Cocoapodspod 'SVProgressHUD'

手动安装拖拽SVProgressHUD/SVProgressHUD文件 到你的项目.

注意把SVProgressHUD.bundle添加进Targets->Build Phases->Copy Bundle Resources.

添加QuartzCoreframework 到你的项目.使用(参见Xcode项目文档/Demo)

SVProgressHUD作为一个单例(也就是说,它并不需要创建和实例化,你直接调用, 如[SVProgressHUD method]).

使用SVProgressHUD是非常明智的!常用场景:下拉刷新,无限滚动,发送消息

使用SVProgressHUD在您的应用程序通常看起来简单:

[SVProgressHUD show];

dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{

// time-consuming task

dispatch_async(dispatch_get_main_queue(), ^{

[SVProgressHUD dismiss];

});

});

显示 HUD您可以使用下面的方法中的任意一个来显示HUD,以及指示任务的状态:

+ (void)show;

+ (void)showWithStatus:(NSString*)string;

如果您想在HUD指示任务的进度,请使用下列操作之一:

+ (void)showProgress:(CGFloat)progress;

+ (void)showProgress:(CGFloat)progress status:(NSString*)status;

隐藏 HUDHUD可以用以下方法隐藏:

+ (void)dismiss;

+ (void)dismissWithDelay:(NSTimeInterval)delay;

如果你想显示多个HUD ,可以使用使用一下方法:

+ (void)popActivity;

该HUD将自动消失,popActivity将与显示的次数匹配。

显示一个提示消息也可以用于显示一个提示信息。所述显示时间取决于给定的字符串的长度( 0.5至5秒)。

+ (void)showInfoWithStatus:(NSString *)string;

+ (void)showSuccessWithStatus:(NSString*)string;

+ (void)showErrorWithStatus:(NSString *)string;

+ (void)showImage:(UIImage*)image status:(NSString*)string;

自定义SVProgressHUD可通过下列方法进行个性化定制:

+ (void)setDefaultStyle:(SVProgressHUDStyle)style; // 默认是SVProgressHUDStyleLight

+ (void)setDefaultMaskType:(SVProgressHUDMaskType)maskType; // 默认是SVProgressHUDMaskTypeNone

+ (void)setDefaultAnimationType:(SVProgressHUDAnimationType)type; // 默认是 SVProgressHUDAnimationTypeFlat

+ (void)setRingThickness:(CGFloat)width; // 默认是 2 pt

+ (void)setCornerRadius:(CGFloat)cornerRadius; // 默认是 14 pt

+ (void)setFont:(UIFont*)font; // 默认是 [UIFont preferredFontForTextStyle:UIFontTextStyleSubheadline]

+ (void)setForegroundColor:(UIColor*)color; // 默认是 [UIColor blackColor], 仅对 SVProgressHUDStyleCustom 有效

+ (void)setBackgroundColor:(UIColor*)color; // 默认是 [UIColor whiteColor], 仅对 SVProgressHUDStyleCustom 有效

+ (void)setInfoImage:(UIImage*)image; //默认是bundle文件夹中的提示图片.

+ (void)setSuccessImage:(UIImage*)image; // 默认是bundle文件夹中的成功图片.

+ (void)setErrorImage:(UIImage*)image; // 默认是bundle文件夹中的错误图片.

+ (void)setViewForExtension:(UIView*)view; // 默认是nil,仅当设置了 #define SV_APP_EXTENSIONS 时有效.

通知SVProgressHUD通过NSNotificationCenter注册4份通知,以响应正在显示/消失:

SVProgressHUDWillAppearNotification提示框即将出现

SVProgressHUDDidAppearNotification提示框已经出现

SVProgressHUDWillDisappearNotification提示框即将消失

SVProgressHUDDidDisappearNotification提示框已经消失每个通知传递一个userInfo字典,字典中包含HUD的状态字符串(如果有的话) ,可通过SVProgressHUDStatusUserInfoKey作为键来获取。

SVProgressHUD还发送通知:

SVProgressHUDDidReceiveTouchEventNotification当用户触摸整体屏幕上 和

' SVProgressHUDDidTouchDownInsideNotification当用户直接在HUD接触。这两个通知没有userInfo参数,但包含了有关的触摸的UIEvent` 参数.

App 扩展(App Extension)当在应用程序中使用SVProgressHUD时, 要定义常量#define SV_APP_EXTENSIONS避免使用不可用的API。然后从你的扩展视图控制器中通过self.view调用setViewForExtension:即可。

注意: 此处指的是"App Extension",不是类目."File->New->Target...-> iOS -> App Extension->Photo Editing Extension". 如果未用到,可忽略. 更多细节参考:https://github.com/TransitApp/SVProgressHUD/issues/390

 
 
免责声明:本文为网络用户发布,其观点仅代表作者个人观点,与本站无关,本站仅提供信息存储服务。文中陈述内容未经本站证实,其真实性、完整性、及时性本站不作任何保证或承诺,请读者仅作参考,并请自行核实相关内容。
 
© 2005- 王朝網路 版權所有 導航