RHPlaceholder - SwiftGit

Activity Indicator

RHPlaceholder

October 3, 2023

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 integration with your storyboard VC will take couple minutes 💥

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 😲 library has been associated with your views 👏

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 😦…

GitHub

View Github

#animation #cocoapods #facebook #facebookanimation #gradient #instagram #instagramanimation #ios #iosanimation #ioslib #iosswift #iosui #iosuiview #loader #loaders #loadinganimations #placeholder #swift #swiftlibrary

YOU MIGHT ALSO LIKE...

July 26, 2025
SwiftUI

🧭 NavigationKit

NavigationKit is a lightweight library which makes SwiftUI navigation super easy to use. 💻 Installation 📦 Swift Package Manager Using Swift Package Manager, add ...

July 26, 2025
SwiftUI

swiftui-navigation-stack

An alternative SwiftUI NavigationView implementing classic stack-based navigation giving also some more control on animations and programmatic navigation. NavigationStack Installation ...