Skip to content

UI element showing a growing circle, reminiscent of a ripple in a pond

License

Notifications You must be signed in to change notification settings

jeanetienne/Rippl

Repository files navigation

Rippl

GitHub license Carthage compatible CocoaPods Compatible Platform

UI element showing a growing circle, reminiscent of a ripple in a pond.

A Rippl is a simple UIView sublcass which draws an ellipse (in most cases a circle) within its frame and has 2 built-in animations. An "impact ripple" animation to create an additional growing ellipse behind the original one, and a "gain" animation that grows the original view according to the value of the gain.

Impact Ripple animation Gain animation

Features

Rippl is IBDesignable and IBInspectable, making it very easy to use in Interface Builder.

Usage

Use a UIView of subclass Rippl and call any of the two provided methods:

class ViewController: UIViewController {

    @IBOutlet var ripplView: Rippl!

    @IBAction func animateImpactButtonDidTouchUpInside(_ sender: AnyObject, forEvent event: UIEvent) {
        ripplView.animateImpact(strength: 2.5, duration: 1.5)
    }

    @IBAction func animateGainButtonDidTouchUpInside(_ sender: AnyObject, forEvent event: UIEvent) {
        ripplView.animateGain(value: 3)
    }

}

Installation

Cocoapods

CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

$ gem install cocoapods

To integrate Rippl into your Xcode project using CocoaPods, specify it in your Podfile:

  pod 'Rippl'

Then, run the following command:

$ pod install

Carthage

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate Rippl into your Xcode project using Carthage, specify it in your Cartfile:

github "jeanetienne/Rippl"

Run carthage update to build the framework and drag the built Rippl.framework into your Xcode project.

Manually

If you prefer not to use either of the aforementioned dependency managers, you can integrate Rippl into your project manually.

Sample project

Clone this repo and run the project, it contains a sound recorder to help you visualise the "gain" animation. You can also trigger the "impact ripple" animation with a button.

The mic image in the sample project is by Michal Beno, from the Noun Project.

About

UI element showing a growing circle, reminiscent of a ripple in a pond

Resources

License

Stars

Watchers

Forks

Packages

No packages published