LoadingView
LoadingView is an highly customizable and easy to use UI element for showing loading status written in Swift.
Features
- Show animated loading
- Show an information message
- Show an error message with repeat button
- Customize colors, fonts, animations
- Import your own loading animation
- Use in code or from interface builder
Requirements
- iOS 10.0+
- Xcode 11+
- Swift 5.1+
Installation
Swift Package Manager
The Swift Package Manager is a tool for automating the distribution of Swift code and is integrated into the swift
compiler.
Use Xcode’s new Swift Packages option, which is located within the File menu.
Usage example
import LoadingView
class ViewController: UIViewController {
@IBOutlet weak var loadingView: LoadingView!
override func viewDidLoad() {
super.viewDidLoad()
loadingView.repeatTouchUpHandler = { button in
// handle repeatButton touches
}
loadingView.state = .loading // set loadingView state
}
}
States
hidden
View is fully hidden
loading
View is showing loading animation
info
View is showing information with the given message
error
View is showing error with the given messsage and repeat button
Advanced
Use your own animations instead of default PulsingCircleAnimation
Create an animation and conform it to the Animation protocol. Set the loadingAnimation property.
loadingView.loadingAnimation = MyAnimation() // must conform to Animation protocol
Turn on state change logging
loadingView.logStateChanges = true // enable logging if needed
Credits
Example photo by Jason Leung on Unsplash
License
LoadingView is released under the MIT license. See LICENSE for details.