https://github.com/brownsoo/valueanimator

Value transition swift utility
https://github.com/brownsoo/valueanimator

animation animator cocoapods easing-effects ios swift translation valueanimator

Last synced: about 2 months ago
JSON representation

Value transition swift utility

• Host: GitHub
• URL: https://github.com/brownsoo/valueanimator
• Owner: brownsoo
• License: mit
• Created: 2018-03-13T05:37:11.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2024-12-10T14:49:54.000Z (6 months ago)
• Last Synced: 2025-04-12T01:39:14.178Z (about 2 months ago)
• Topics: animation, animator, cocoapods, easing-effects, ios, swift, translation, valueanimator
• Language: Swift
• Homepage:
• Size: 10.6 MB
• Stars: 19
• Watchers: 1
• Forks: 7
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# ValueAnimator

[![Version](https://img.shields.io/cocoapods/v/ValueAnimator.svg?style=flat)](http://cocoapods.org/pods/ValueAnimator)

[![License](https://img.shields.io/cocoapods/l/ValueAnimator.svg?style=flat)](http://cocoapods.org/pods/ValueAnimator)

[![Platform](https://img.shields.io/cocoapods/p/ValueAnimator.svg?style=flat)](http://cocoapods.org/pods/ValueAnimator)

[![codebeat badge](https://codebeat.co/badges/ffe86bc0-24d9-4c1d-993c-274d8f803eb5)](https://codebeat.co/projects/github-com-brownsoo-valueanimator-master)

![actions workflow](https://github.com/brownsoo/ValueAnimator/actions/workflows/swift.yml/badge.svg)

- [ ] Multiple properties in funcion 'onChanged'

## Demo

![Demo for UIView animation](value-animator-example.gif)

## Usage

ValueAnimator makes the transition from initial value to target value using easing functions.

#### Simple animation

```swift

let animator = ValueAnimator.animate("some", from: 0, to: 360, duration: 1.0,

    onChanged: { p, v in 

        print("property \(p): \(v.value)")

    },

    easing: EaseCircular.easeIn())

animator.resume()

```

#### Yoyo annimation with 2 values

```swift

let yoyoAni = ValueAnimator.animate(

    props: ["h", "w"], 

    from: [20, 30], 

    to: [5, 150], 

    duration: 1.4, 

    easing: EaseSine.easeInOut(), 

    onChanged: { p, v in

        if p == "h" {

            let width = self.rect1.bounds.width

            self.rect1.frame = CGRect(x: 24, y: 140, width: width, height:v.cg)

        } else {

            let height = self.rect1.bounds.height

            self.rect1.frame = CGRect(x: 24, y: 140, width:v.cg, height: height)

        }

    }, 

    option: ValueAnimator.OptionBuilder()

        .setYoyo(true)

        .build())

yoyoAni.resume()

```

#### Thread

ValueAnimator uses its own work-thread. But the callback `changeCallback`, `endCallback` is called in main-thread. if you wanna it called in work-thread, you just set the 'callbackOnMainThread' property is false.

```swift

let someView: UIView!

let animator = ValueAnimator.animate("some", from: 0, to: 1, duration: 1.0,

    onChanged: { p, v in 

        // called in ValueAnimator's work-thread

    },

    easing: EaseCircular.easeIn())

animator.callbackOnMainThread = false

animator.resume()

```

## Example

To run the example project, clone the repo, and run **open ValueAnimator.xcworkspace**. 

You can see ValueAnimatorExample project.

## Installation

### [Swift Package Manager](https://swift.org/package-manager/)

* Open Xcode

* Go to File > Swift Packages > Add Package Dependency...

* Paste this Github Repo URL (https://github.com/brownsoo/ValueAnimator) into the search bar.

* Select the ValueAnimator repo from the search results.

### [CocoaPods](http://cocoapods.org)

Simply add the following line to your Podfile:

```ruby

pod 'ValueAnimator'

```

## Author

brownsoo, [@medium](https://medium.com/@brownsoo)

## License

ValueAnimator is available under the MIT license. See the LICENSE file for more info.