jonasgessner/jgprogresshud-swiftui

Easily show HUDs with SwiftUI! Lightweight SwiftUI wrapper for JGProgressHUD for iOS, tvOS, Catalyst.

JGProgressHUD-SwiftUI

This is a lightweight and easy-to-use SwiftUI wrapper for JGProgressHUD, giving you access to the large and proven feature set of JGProgressHUD. Supports iOS, macCatalyst and tvOS 14.0+.

Installation

JGProgressHUD-SwiftUI can only be used with the Swift Package Manager.

In Xcode, use the menu File > Swift Packages > Add Package Dependency... and enter the package URL https://github.com/JonasGessner/JGProgressHUD-SwiftUI.git.

Usage

This package builds on top of the UIKit-based JGProgressHUD and provides a trivial way of showing HUDs in SwiftUI code.

You use the view JGProgressHUDPresenter as a canvas, which can display HUDs over its contents. Generally you want to use a single JGProgressHUDPresenter view as the root view of your application, such that full screen HUDs can be displayed.

To show a HUD from any contained view, define the environment object of type JGProgressHUDCoordinator in your view struct. This object is automatically available in the environment via JGProgressHUDPresenter. Call its showHUD(constructor:handleExistingHUD:) method, providing a constructor closure that returns the HUD to show. The returned HUD will be shown automatically, hence you do not need to call the show() method on the HUD. You may already schedule the HUD to disappear using the dismiss(afterDelay:) method.

The handleExistingHUD closure is only called in case a HUD is already presented. You can, for example, dismiss the current HUD and return true to continue showing the new HUD. By returning false (default), you prevent the new HUD from being shown.

You may furthermore access, modify or dismiss a HUD that is already presented by accessing the presentedHUD property of the JGProgressHUDCoordinator environment object. After a HUD dismisses, this property is automatically reset to nil.

Example

Also see the Example Project.

import SwiftUI
import JGProgressHUD_SwiftUI
 
struct NavigationBody: View {
    // This environment object is automatically set by JGProgressHUDPresenter.
    @EnvironmentObject var hudCoordinator: JGProgressHUDCoordinator

    var body: some View {
        Button("Press Me") {
            // Simply call showHUD and return your HUD!
            hudCoordinator.showHUD {
                let hud = JGProgressHUD()
                hud.textLabel.text = "Hello!"
                hud.dismiss(afterDelay: 3)

                return hud
            }
        }
    }
}

struct ContentView: View {
    var body: some View {
        // This presenter can present a fullscreen HUD.
        JGProgressHUDPresenter {
            NavigationView {
                NavigationBody()
            }
        }
    }
}

Requirements

• Deployment target of iOS/tvOS/macCatalyst 14.0 or higher.

Detailed Documentation

Please see the JGProgressHUD project for documentation on JGProgressHUD itself.

See the doc strings in JGProgressHUD_SwiftUI.swift for more info.

License

MIT License.
© 2020, Jonas Gessner.

Credits

Created and maintained by Jonas Gessner, © 2020.

jgprogresshud-swiftui's Issues

How to show in .sheet pages?

The ContentView is wrapped with JGProgressHUDPresenter and showing some HUDs, presenting a .sheet page (eg.: some PreferencesView) which is also wrapped with another JGProgressHUDPresenter. Calling show() in the sheet page only shows the HUD in the content view, behind the sheet view itself. (observed from Xcode view hierarchy)
Passing the hudCoordinator from ContentView to .sheet(), instead of wrapping .sheet with JGProgressHUDPresenter, does not help.
Any ideas on this? Or is there another (correct) way to show the HUD? Thanks!
(Falling back to use objc JGProgressHUD now)

Reacting to state changes

As I see the current state of art, I need to do dismiss(afterDelay: ) with the hud. What about dismissing it with when there is a change in a property of a view model. Let's say I want to hide after fetching is completed. I am doing it this way, I don't know whether it is a good approach or not.

           hudCoordinator.showHUD {
                    let hud = JGProgressHUD()
                    hud.textLabel.text = "Fetching Profile Details....."
                    hud.textLabel.font = UIFont(name: FontConstants.poppinsMedium, size: 12)
                    hud.backgroundColor = UIColor(white: 0, alpha: 0.4)
                    viewModel.$fetchedCompleted.sink { completed in
                        if completed {
                            hud.dismiss()
                        }
                    }.store(in: &viewModel.subscription)
                    return hud
                }

Can anybody guide me with this?

Any plans to update this for Vision Pro native swift apps?

SPM : Cannot load as it says not a package

Can support ios 13?

As title.