RHPlaceholder
πΎ
Because traditional loading view like UIActivityIndicatorView or similar one are no longer so trendy (Facebook or Instagram apps are moving away from these approaches), I decided to create very simple library which will give you oportunity to have Facebook or Instagram 'view loading state' in your great project without big effort
Play with it
π
Installation
You can install library using Cocoapods:
pod 'RHPlaceholder'
or using Carthage:
add
github "robertherdzik/RHPlaceholder"
to your Cartfile and perform carthage update --platform iOS.
Usage
WOW... it is soo easy to use
Base Usage
just create instance const of Placeholder in your ViewController:
private let placeholderMarker = Placeholder() // By default you will have Insta like gradient animation
bear in mind, that you can choose between couple of predefined animations (like e.g. RainbowAnimatorGradient):
private let placeholderMarker = Placeholder(layerAnimator: RainbowAnimatorGradient.self)
... and then just bind up library with your views which needs to be animated:
private func addPlaceholder() {
let viewElements: [UIView] = [
name,
surname,
age,
email,
birthDate
]
placeholderMarker.register(viewElements)
}
call addPlaceholder() method in viewDidLoad(). Boom
all what left, is to controll showing 'loading state' animation on your views using startAnimation() and remove()
func fetchUserData() {
placeholderMarker.startAnimation()
apiManager.fetchUser() { [weak self] user in
self?.placeholderMarker.remove()
// .. rest of the method
}
}
List of available animatotrs:
(default) InstaLayerAnimatorGradient
| BackAndForthLayerAnimatorGradient | BlinkAnimator | RainbowAnimatorGradient |
|---|---|---|
 |
 |
 |
Customization
You can add your own Animators, by conforming to the LayerAnimating protocol and passing your new Animator as a param to the Placeholder init.
Swift support
| Library ver | Swift ver | Note |
|---|---|---|
| 0.0.3 | 4.1 | Very early version, API may change |
| 0.0.5 | 4.2 | Very early version, API may change |
| 0.0.6 | 5.0 | Very early version, API may change |
Check the Demo project
Please check out the demo project, you can see there how Library has been implemented in details.
Layout Inspiration
Layout inspiration has been taken from one of the Dribbble projects, unfortunately I cannot find now this project anymore, because of that I cannot annotate creator in here
Assets
- Great
π tab bar icons from:
- Cool
π profile icon from:
583 Dec 6, 2022
79 Apr 18, 2022
340 Dec 16, 2022
161 Dec 5, 2022
1.3k Jan 6, 2023
10 Oct 26, 2022
0 Dec 26, 2021
352 Dec 4, 2022
992 Dec 3, 2022
4 May 27, 2021
11.7k Jan 6, 2023
16 Mar 3, 2022
5 Nov 23, 2022
7 Oct 17, 2022
225 Dec 30, 2022
1 Jan 17, 2022
630 Dec 13, 2022
Image from 
940 Dec 22, 2022
46 Aug 12, 2022
160 Nov 2, 2022
968 Jan 8, 2023
10.3k Jan 5, 2023
72 Jul 2, 2022
791 Dec 26, 2022
419 Dec 16, 2022
668 Nov 2, 2022