KRProgressHUD

KRProgressHUD is a beautiful and easy-to-use progress HUD for your iOS written by Swift 2.

This library is inspired by SVProgressHUD.

KRActivityIndicatorView is used for loading view.

DEMO

To run the example project, clone the repo, and open KRProgressHUDDemo.xcodeproj from the DEMO directory.

or appetize.io

Installation

KRProgressHUD is available through CocoaPods and Carthage. To install it, simply add the following line to your Podfile or Cartfile:

# CocoaPods
pod "KRProgressHUD"

# Carthage
github "Krimpedance/KRProgressHUD"

Usage

(see sample Xcode project in /Demo)

Caution :

Only use it if you absolutely need to perform a task before taking the user forward.

If you want to use it with other cases (ex. pull to refresh), I suggest using KRActivityIndicatorView.

　　

KRProgressHUD is created as a singleton.

At first, import KRProgressHUD in your swift file.

Show simple HUD (using GCD) :

KRProgressHUD.show()

let delay = dispatch_time(DISPATCH_TIME_NOW, Int64(1.0 * Double(NSEC_PER_SEC)))
dispatch_after(delay, dispatch_get_main_queue()) {
    KRProgressHUD.dismiss()
}

Showing the HUD

You can show HUD with some args. You can appoint only the args which You want to appoint. (Args is reflected only this time.)

// progressHUDStyle : background color of progressView
// maskType : background color of maskView
// activityIndicatorStyle : style of KRActivityIndicatorView
// message : Text to display together
// image : Image that display instead of activity indicator
class func show(
    progressHUDStyle progressStyle :KRProgressHUDStyle? = nil,
    maskType type:KRProgressHUDMaskType? = nil,
    activityIndicatorStyle indicatorStyle :KRProgressHUDActivityIndicatorStyle? = nil,
    message :String? = nil,
    font :UIFont? = nil,
    image :UIImage? = nil,
    completion: (()->())? = nil
)

// Example
KRProgressHUD.show()
KRProgressHUD.show(message: "Loading...")
KRProgressHUD.show(progressHUDStyle: .Black, message: "Loading...")
...

Update the HUD's message

The HUD can update message.

class func updateLabel(text: String)

// Example
KRProgressHUD.updateLabel("20%")

Dismissing the HUD

The HUD can be dismissed using:

class func dismiss(completion: (()->())?)

Show a confirmation glyph before getting dismissed a little bit later. (The display time is 1 sec.)

These can appoint some args like show(), too.

class func showSuccess()
class func showInfo()
class func showWarning()
class func showError()

Customization

KRProgressHUD can be customized via the following methods.

public class func setDefaultMaskType(type :KRProgressHUDMaskType)  // Default is .Black
public class func setDefaultStyle(style :KRProgressHUDStyle)  // Default is .White
public class func setDefaultActivityIndicatorStyle(style :KRProgressHUDActivityIndicatorStyle)  // Default is .Black
public class func setDefaultFont(font :UIFont)  // Default is Hiragino Sans W3 13px (When it can't be used, system font 13px)
public class func setDefaultCenterPosition(position :CGPoint)  // Default is center of device screen.

KRActivityIndicatorView's style, please refer to here.

Contributing to this project

I'm seeking bug reports and feature requests. (And please teach me if my English is wrong :| )

Release Note

• 1.6.1 : Fixed bug which HUD doesn't respect status bar style.
• 1.6.0 : Changed center position of HUD to UIScreen's center. And, added function to which the position can be changed.
• 1.5.2 : Add KRProgressHUD.isVisible parameter.
• 1.5.1 : Fixed bug from which keyWindow doesn't switch when call dismiss().
• 1.5.0 : Add completion handler to dismiss() and show().
• 1.4.3 : Fixed bug which infinite recursion prefersStatusBarHidden().
• 1.4.2 : Fixed bug which HUD doesn't respect status bar appearance.
• 1.4.1 : Add Carthage. And, fixed bug which HUD mask view isn't switched over.
• 1.4.0 : Add the update function of message label.

License

KRProgressHUD is available under the MIT license. See the LICENSE file for more info.