Latest 0.0.3
Homepage https://github.com/jeanetienne/rippl
License MIT
Platforms ios 8.0
Frameworks UIKit
Authors

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. You can call an "impact ripple" animation to create an additional growing ellipse behind the original one, or you can call 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.

Latest podspec

{
    "name": "Rippl",
    "version": "0.0.3",
    "summary": "UI element showing a growing circle, reminiscent of a ripple in a pond.",
    "description": "A Rippl is a simple UIView sublcass which draws an ellipsen(most probably a circle) within its frame and has 2 built-innanimations. You can call an "impact ripple" to create annadditional growing ellipse behind the original one, or youncan call a "gain" animation that grows the original viewnaccording to the value of the gain.",
    "homepage": "https://github.com/jeanetienne/rippl",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "Jean-u00c9tienne": "[email protected]"
    },
    "social_media_url": "http://twitter.com/jeanetienne",
    "screenshots": [
        "https://raw.githubusercontent.com/jeanetienne/rippl/master/impact.gif",
        "https://raw.githubusercontent.com/jeanetienne/rippl/master/gain.gif"
    ],
    "source": {
        "git": "https://github.com/jeanetienne/Rippl.git",
        "tag": "0.0.3"
    },
    "source_files": "Rippl-iOS/Rippl.swift",
    "frameworks": "UIKit",
    "platforms": {
        "ios": "8.0"
    },
    "pushed_with_swift_version": "3.0"
}

Pin It on Pinterest

Share This