Skip to content
forked from cmtrounce/SwURL

Lightweight asynchronous image loading in SwiftUI. Fetch and display images from URLs. Supports placeholders, persistent storage, and more!

License

Notifications You must be signed in to change notification settings

changhee123/SwURL

 
 

Repository files navigation

SwURL

Build Status License: MIT contributions welcome

Declarative-style SwiftUI wrapper around asyncronous image views including smooth transitions and caching options.

RemoteImageView

Asyncrounously download and display images declaratively. Supports placeholders and image transitions.

Flexible caching and image fetching done in background. Currently tested with basic List as seen in Example

As everyone gets to understand SwiftUI more, this project will evolve and get more features.

Fading Transition!

Configuration

Enable or disable debug logging

SwURLDebug.loggingEnabled = true

Choose between global persistent or in-memory (default) caching

SwURL.setImageCache(type: .inMemory)
SwURL.setImageCache(type: .persistent)

... or provide your own caching implementation by using ImageCacheType

SwURL.setImageCache(type: .custom(ImageCacheType))

Usage

RemoteImageView is initialised with a URL, placeholder Image (default nil) and a .custom ImageTransitionType (default .none).

Upon initialisation, a resized image will be downloaded in the background and placeholder displayed as the image is loading, transitioning to the downloaded image when complete.

LandmarkRow is used in a List

struct LandmarkRow: View {
	var landmark: Landmark
	
	var body: some View {
		HStack {
			RemoteImageView(
				url: landmark.imageURL,
				placeholderImage: Image.init("placeholder_avatar"),
				transition: .custom(transition: .opacity, animation: .easeOut(duration: 0.5))
			).imageProcessing({ image in
				return image
					.resizable()
					.renderingMode(.template)
					.aspectRatio(contentMode: .fit)
			})
			Text(verbatim: landmark.name)
			Spacer()
		}
	}
}

Available Parameters

Name Description Default
url URL of the remote source image. none
placeholderImage (optional)
Image to display whilst remote image data is being fetched and decoded.
nil
transition (optional)
transition to occur when showing the loaded image.
nil

Image Processing

Using function .imageProcessing . Process your placeholder and loaded images once they've been loaded. Apply resizing, aspect ratio, clipping and more! Call imageProcessing on your RemoteImageView and return some View

Example

).imageProcessing({ image in    
    return image
        .resizable()
        .renderingMode(.template)
        .aspectRatio(contentMode: .fit)
})

This gives you the power to return any View you want. RemoteImageView applies resizable() on all images by default.

Get it

SwURL is available only through Swift Package Manager

  • Open Xcode
  • Go to File > Swift Packages > Add Package Dependency...
  • Paste this Github Repo URL ( https://github.com/cmtrounce/SwURL ) into the search bar.
  • Select the SwURL repo from the search results.
  • Choose the branch/version you want to clone. The most recent release is the most stable but you can choose branches master and develop for the most up to date changes.
  • Confirm and enjoy!

Contact

Join the SwURL Gitter community at https://gitter.im/SwURL-package/community and message me directly. Recommended for quicker response time.

You can also follow/message me on Twitter at https://twitter.com/ctrounce94

About

Lightweight asynchronous image loading in SwiftUI. Fetch and display images from URLs. Supports placeholders, persistent storage, and more!

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Swift 100.0%