https://github.com/shndrs/ezprogresshud
A very cool and easy to use activity indicator for iOS Application ;) Hope you fellas enjoy it 😊😊
https://github.com/shndrs/ezprogresshud
activity activity-indicator ezprogresshud heads-up-display hud indicator instagram-indicator ios progress progress-bar progress-bar-swift progress-hud shndrs spinner spinner-swift swift
Last synced: 3 months ago
JSON representation
A very cool and easy to use activity indicator for iOS Application ;) Hope you fellas enjoy it 😊😊
- Host: GitHub
- URL: https://github.com/shndrs/ezprogresshud
- Owner: shndrs
- License: mit
- Created: 2019-07-08T07:35:10.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2021-11-06T04:07:11.000Z (about 4 years ago)
- Last Synced: 2025-10-20T13:53:37.097Z (3 months ago)
- Topics: activity, activity-indicator, ezprogresshud, heads-up-display, hud, indicator, instagram-indicator, ios, progress, progress-bar, progress-bar-swift, progress-hud, shndrs, spinner, spinner-swift, swift
- Language: Swift
- Homepage:
- Size: 4.3 MB
- Stars: 13
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# EZProgressHUD
[](https://codebeat.co/projects/github-com-shndrs-ezprogresshud-master)
[](https://github.com/Carthage/Carthage)
As we said in short description, this is a very cool customizable and easy to use activity indicator for iOS applications
How to use?
=======
If you wanna use the default `EZProgressHUD` just follow this👇🏻:
```Swift
import EZProgressHUD
```
```Swift
let options = EZProgressOptions()
let hud = EZProgressHUD.setProgress(with: options)
```
And now you can show or dismiss the hud by :
```Swift
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
```Swift
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
```Swift
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 |  |
| EZAnimationOptions.heartBeat |  |
| EZAnimationOptions.antColony |  |
| EZAnimationOptions.lineLayer |  |
| EZAnimationOptions.xyRotation |  |
| EZAnimationOptions.lordOfTheRings |  |
| EZAnimationOptions.yRotation |  |
| EZAnimationOptions.xRotation |  |
Requirements
=======
iOS 9.3+
Xcode 10.2 or later
Swift 4.2 or later
Installation
=======
EZProgressHUD is available through [CocoaPods](https://cocoapods.org/pods/EZProgressHUD). To install
the latest version, simply add the following line to your Podfile:
```ruby
pod `EZProgressHUD`
```
And then on your terminal run 👇🏻:
```bash
pod install
```
To get the latest version of library using [Carthage](https://github.com/Carthage/Carthage), you can add following line to your Cartfile.
```bash
github "shndrs/EZProgressHUD"
```
And then on your terminal run 👇🏻:
```bash
carthage update
```
Author
=======
sahandraeisi1994@gmail.com, sahandraeisi@yahoo.com, [shndrs](https://linkedin.com/in/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](https://github.com/shndrs)