Skip to content

A very cool and easy to use activity indicator for iOS Application ;) Hope you fellas enjoy it 😊😊

License

Notifications You must be signed in to change notification settings

shndrs/EZProgressHUD

Repository files navigation

EZProgressHUD-logo

EZProgressHUD

codebeat badge build-status swift-version version platform license Carthage Compatible cocoapods release-date

As we said in short description, this is a very cool customizable and easy to use activity indicator for iOS applications

AntColony-C HNK-C XYRotation-C LineLayer-C

How to use?

If you wanna use the default EZProgressHUD just follow thisπŸ‘‡πŸ»:

import EZProgressHUD
let options = EZProgressOptions()
let hud = EZProgressHUD.setProgress(with: options)        

And now you can show or dismiss the hud by :

hud.show()                   // for show it
hud.dismiss(completion: nil) // for dismiss it

Customization

There is two way to do the customizationπŸ‘‡πŸ»:

First Way: Creating an empty instance of EZProgressOptions

let options = EZProgressOptions()

options.radius = 120                                            // by default is 115
options.firstLayerStrokeColor = .lightGray                      // by default is UIColor(red: 220/255, green: 20/255, blue: 60/255, alpha: 1)
options.secondLayerStrokeColor = .white                         // by default is UIColor(red: 220/255, green: 20/255, blue: 60/255, alpha: 1), FYI it's always transparent ;)
options.thirdLayerStrokeColor = .darkGray                       // by default is .gray
options.strokeWidth = 12                                        // by default is 12.0
options.font =  UIFont(name: "AvenirNext-Regular", size: 18)!   // by default is Papyrus size 18
options.title = "EZProgressHUD"                                 // by default is "Please Wait..."
options.titleTextColor = .white                                 // by default is white
options.transViewBackgroundColor = .black                       // by default is black
options.animationOption = EZAnimationOptions.lordOfTheRings     // by default is EZAnimationOptions.heartBeat

Second Way: Using Closure

let options = EZProgressOptions { (option) in

    option.radius = 115                                                                               // by default is 115
    option.firstLayerStrokeColor = UIColor(red: 10/255, green: 101/255, blue: 171/255, alpha: 1.0)    // by default is UIColor(red: 220/255, green: 20/255, blue: 60/255, alpha: 1)
    option.secondLayerStrokeColor = UIColor(red: 10/255, green: 101/255, blue: 171/255, alpha: 1.0)   // by default is UIColor(red: 220/255, green: 20/255, blue: 60/255, alpha: 1), FYI it's always transparent ;)
    option.thirdLayerStrokeColor = .gray                                                              // by default is .gray
    option.strokeWidth = 2                                                                            // by default is 12.0
    option.font = UIFont(name: "Papyrus", size: 18)!                                                  // by default is Papyrus size 18
    option.title = "EZProgressHUD"                                                                    // by default is "Please Wait..."
    option.titleTextColor = .white                                                                    // by default is white
    option.transViewBackgroundColor = .black                                                          // by default is black
    option.animationOption = EZAnimationOptions.hnk                                                   // by default is EZAnimationOptions.heartBeat
}

Indicator Animation Options

In EZProgressHUD we brought to you 8 diffrent kind of indicators:

animationOption Example
EZAnimationOptions.hnk HNK-C
EZAnimationOptions.heartBeat HeartBeat-C
EZAnimationOptions.antColony AntColony-C
EZAnimationOptions.lineLayer LineLayer-C
EZAnimationOptions.xyRotation XYRotation-C
EZAnimationOptions.lordOfTheRings LordOfTheRings-C
EZAnimationOptions.yRotation YRotation-C
EZAnimationOptions.xRotation XRotation-C

Requirements

iOS 9.3+

Xcode 10.2 or later

Swift 4.2 or later

Installation

EZProgressHUD is available through CocoaPods. To install the latest version, simply add the following line to your Podfile:

pod `EZProgressHUD`

And then on your terminal run πŸ‘‡πŸ»:

pod install

To get the latest version of library using Carthage, you can add following line to your Cartfile.

github "shndrs/EZProgressHUD"

And then on your terminal run πŸ‘‡πŸ»:

carthage update

Author

[email protected], [email protected], shndrs

License

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

Credit

EZProgressHUD is brought to you in iOS Swift by Sahand Raeisi - shndrs