rhp

RHPlaceholder

Show pleasant loading view for your users 😍

Showing:

Popularity

Downloads/wk

0

GitHub Stars

235

Maintenance

Last Commit

2yrs ago

Contributors

5

Package

Dependencies

0

License

MIT

Categories

Readme

Build Status Version License Platform Language Twitter

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 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 BackAndForthLayerAnimatorGradient BackAndForthLayerAnimatorGradient

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 verSwift verNote
0.0.34.1Very early version, API may change
0.0.54.2Very early version, API may change
0.0.65.0Very 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



Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100