SwiftUIAsyncContentView

A SwiftUI view for dynamically rendering content based upon "loading", "error", and "completed" data loading states..

Installation

Xcode Projects

Select File -> Swift Packages -> Add Package Dependency and enter https://github.com/CypherPoet/SwiftUIAsyncContentView.

Swift Package Manager Projects

You can add SwiftUIAsyncContentView as a package dependency in your Package.swift file:

let package = Package(
    //...
    dependencies: [
        .package(
            name: "SwiftUIAsyncContentView",
            url: "https://github.com/CypherPoet/SwiftUIAsyncContentView",
            .upToNextMinor(from: "0.1.0")
        ),
    ],
    //...
)

From there, refer to the SwiftUIAsyncContentView "product" delivered by the SwiftUIAsyncContentView "package" inside of any of your project's target dependencies:

targets: [
    .target(
        name: "YourLibrary",
        dependencies: [
            .product(
                name: "SwiftUIAsyncContentView",
                package: "SwiftUIAsyncContentView"
            ),
        ],
        ...
    ),
    ...
]

Then simply import SwiftUIAsyncContentView wherever you’d like to use it.

📝 Note: To make the library available to your entire project, you could also leverage the functionality of the @_exported keyword by placing the following line somewhere at the top level of your project:

@_exported import SwiftUIAsyncContentView

Usage

🗺 Roadmap

• World Domination

Contributing

Contributions to SwiftUIAsyncContentView are most welcome. Check out some of the issue templates for more info.

💻 Developing

Requirements

• Xcode 13.0+

📜 Creating & Building Documentation

Documentation is built with Xcode's DocC. See Apple's guidance on how to build, run, and create DocC content.

For now, the best way to view the docs is to open the project in Xcode and run the Build Documentation command. At some point in the future, I'm hoping to leverage the tooling the develops for generating/hosting DocC documentation. (Please feel free to let me know if you have any ideas or tooling recommendations around this 🙂).

🏷 License

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