TTProgressHUD
TTProgressHUD is a light weight HUD written in SwiftUI meant to display the progress of an ongoing task on iOS. TTProgressHUD (left) was designed to look as similar as possible to the Apple HUD (example from Podcast.app, right).
Installation
Xcode 11 and iOS 13 is required.
Swift Package Manager
- Xcode: File -> Swift Packages -> Add Package Dependency
- Paste https://github.com/honkmaster/TTProgressHUD
Manually
Drag TTProgressHUD.swift and TTProgressHUDConfig.swift into your project.
Usage
Use TTProgressHUD wisely! Only use it if you absolutely need to perform a task before taking the user forward. Bad use case examples: pull to refresh, infinite scrolling, sending message.
Import
Import the TTProgressHUD package:
import TTProgressHUD
Instantiate and show the HUD view
struct ContentView: View {
@State var hudVisible = true
@State var hudConfig = TTProgressHUDConfig()
var body: some View {
TTProgressHUD($hudVisible, config: hudConfig)
}
}
Customization
TTProgressHUD can be customized via the TTProgressHUDConfig struct. The default values were chosen so that TTProgressHUD looks as similar as possible to the Apple HUD.
public init(
type: TTProgressHUDType = .loading,
title: String? = nil,
caption: String? = nil,
minSize: CGSize = CGSize(width: 100.0, height: 100.0),
cornerRadius: CGFloat = 12.0,
backgroundColor: Color = .clear,
titleForegroundColor: Color = .primary,
captionForegroundColor: Color = .secondary,
shadowColor: Color = .clear,
shadowRadius: CGFloat = 0.0,
borderColor: Color = .clear,
borderWidth: CGFloat = 0.0,
lineWidth: CGFloat = 10.0,
imageViewSize: CGSize = CGSize(width: 100, height: 100),
imageViewForegroundColor: Color = .primary,
successImage: String = "checkmark.circle",
warningImage: String = "exclamationmark.circle",
errorImage: String = "xmark.circle",
shouldAutoHide: Bool = false,
allowsTapToHide: Bool = false,
autoHideInterval: TimeInterval = 10.0,
hapticsEnabled: Bool = true
){...}
Haptic Feedback
TTProgressHUD will automatically trigger haptic feedback depending on which HUD is being displayed. The feedback maps as follows:
TTProgressHUDType.success<->UINotificationFeedbackTypeSuccessTTProgressHUDType.warning<->UINotificationFeedbackTypeWarningTTProgressHUDType.error<->UINotificationFeedbackTypeError
Contributing to this project
If you have feature requests or bug reports, feel free to help out by sending pull requests or by creating new issues. Please take a moment to review the guidelines written by Nicolas Gallagher:
License
TTProgressHUD is distributed under the terms and conditions of the MIT license.
Credits
TTProgressHUD is brought to you by Tobias Tiemerding and based on SVProgressHUD. If you're using TTProgressHUD in your project, attribution would be very appreciated.
1.5k Dec 28, 2022
1.4k Dec 22, 2022
2 Jul 3, 2022
4 Mar 31, 2022
242 Nov 21, 2022
634 Dec 5, 2022
327 Nov 8, 2022
86 Aug 18, 2022
76 Nov 14, 2022
143 Dec 23, 2022
202 Dec 22, 2022
44 Oct 25, 2021
23 Apr 21, 2022
10 Nov 19, 2022
2.3k Dec 20, 2022
287 Nov 19, 2022
939 Dec 21, 2022
8 Sep 22, 2022
8 May 7, 2022
41 Dec 20, 2022
10 Nov 11, 2022
0 Dec 6, 2021
12 Oct 2, 2022
78 Dec 21, 2022
956 Dec 26, 2022
29 Jul 28, 2022
982 Nov 16, 2022