ProgressHUD - SwiftGit

Animation Colour Image

ProgressHUD

September 23, 2023

WHAT’S NEW

Version :13.7.2

Any SF Symbols can be displayed directly by defining its name ProgressHUD.show(symbol: "car.fill")
The showFailed and showError methods can now handle Error? parameters as well. In this case the localizedDescription will be displayed.
The setupDelayTimer method is fixed. Now [weak self] is used within the timer’s closure to prevent potential retain cycles and avoid memory leaks.

Version: 13.7.1

The mediaSize and marginSize options are now available to adjust the HUD dimensions.

Version: 13.7.0

New AnimationType.none has been implemented. So you can display some text without animation.

Version: 13.6.2

We have the optional delay: parameter to set the timeout.
We have the .remove() function to dismiss the HUD immediately.

Version: 13.5 and 13.6

Bugfix related to iPad split screen.
Bugfix related to showProgress.

OVERVIEW

ProgressHUD is a convenient and intuitive HUD tool designed specifically for iOS. It enables seamless presentation of concise alerts or notifications to users of your app in a simple and non-disruptive way.

INSTALLATION

CocoaPods

CocoaPods is a dependency manager for Swift and Objective-C Cocoa projects.

To incorporate the ProgressHUD library into your Xcode project utilizing CocoaPods, please reference it within your Podfile as shown below:


                                              
                                                pod ‘ProgressHUD’

Swift Package Manager

Swift Package Manager is a tool for managing the distribution of Swift code.

Once you’ve configured your Package.swift manifest file, you may proceed to include ProgressHUD in the dependencies section of the same file.


                                              
                                                dependencies: [ .package(url: “https://github.com/relatedcode/ProgressHUD.git”, from: “13.7.2”) ]

Manually

If you prefer not to use any of the dependency managers, you can integrate ProgressHUD into your project manually. Just copy the ProgressHUD.swift file in your Xcode project.

QUICK START


                                              
                                                ProgressHUD.show(“Some text…”)


                                              
                                                ProgressHUD.show(“Some text…”, interaction: false)


                                              
                                                ProgressHUD.showSucceed()


                                              
                                                ProgressHUD.showSucceed(“Some text…”, delay: 1.5)


                                              
                                                ProgressHUD.showFailed()


                                              
                                                ProgressHUD.showFailed(“Some text…”)


                                              
                                                ProgressHUD.showProgress(0.15)


                                              
                                                ProgressHUD.showProgress(“Loading…”, 0.42)


                                              
                                                ProgressHUD.show(icon: .heart)


                                              
                                                ProgressHUD.show(“Some text…”, icon: .privacy, delay: 2.0)


                                              
                                                ProgressHUD.show(symbol: “box.truck”)


                                              
                                                ProgressHUD.show(“Some text…”, symbol: “figure.2.arms.open”)


                                              
                                                ProgressHUD.dismiss()


                                              
                                                ProgressHUD.remove()

REQUIREMENTS

iOS 13.0+

CUSTOMIZATION

You can customize attributes like color, font, image, animation type, size, and more by using these methods:


                                              
                                                ProgressHUD.animationType = .circleStrokeSpin


                                              
                                                ProgressHUD.colorHUD = .systemGray


                                              
                                                ProgressHUD.colorBackground = .lightGray


                                              
                                                ProgressHUD.colorAnimation = .systemBlue


                                              
                                                ProgressHUD.colorProgress = .systemBlue


                                              
                                                ProgressHUD.colorStatus = .label


                                              
                                                ProgressHUD.mediaSize = 100

ProgressHUD.marginSize = 50


                                              
                                                ProgressHUD.fontStatus = .boldSystemFont(ofSize: 24)


                                              
                                                ProgressHUD.imageSuccess = UIImage(named: “success.png”)


                                              
                                                ProgressHUD.imageError = UIImage(named: “error.png”)

A comprehensive list of the predefined animation and icon types:


                                              
                                                public enum AnimationType {

case none

case systemActivityIndicator

case horizontalCirclesPulse

case lineScaling

case singleCirclePulse

case multipleCirclePulse

case singleCircleScaleRipple

case multipleCircleScaleRipple

case circleSpinFade

case lineSpinFade

case circleRotateChase

case circleStrokeSpin

}


                                              
                                                public enum AnimatedIcon {

case succeed

case failed

case added

}


                                              
                                                public enum AlertIcon {

case heart

case doc

case bookmark

case moon

case star

case exclamation

case flag

case message

case question

case bolt

case shuffle

case eject

case card

case rotate

case like

case dislike

case privacy

case cart

case search

}

GitHub

View Github

#activityindicator #apple #hud #iosswift #progress #progressbar #progresscircle #progresshud #progressindicator #progressindicators #progresstracker #progressview #swift5 #swiftlibrary