https://github.com/kgellci/Shift

Animate gradient changes with time or motion for iOS Swift
https://github.com/kgellci/Shift

gradient ios ios-animation swift-3 swift-framework swift3

Last synced: 3 months ago
JSON representation

Animate gradient changes with time or motion for iOS Swift

• Host: GitHub
• URL: https://github.com/kgellci/Shift
• Owner: kgellci
• License: mit
• Created: 2017-05-20T08:00:54.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2019-03-29T11:03:52.000Z (over 5 years ago)
• Last Synced: 2024-03-26T18:47:41.081Z (4 months ago)
• Topics: gradient, ios, ios-animation, swift-3, swift-framework, swift3
• Language: Swift
• Size: 3.21 MB
• Stars: 181
• Watchers: 4
• Forks: 19
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-cocoa - Shift
• awesome-gradient - Shift - Animate gradient changes with time or motion for iOS. (Swift)

README

        
# Shift

![Swift](https://img.shields.io/badge/Swift-3.0-orange.svg)

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

[![CI Status](http://img.shields.io/travis/kgellci/Shift.svg?style=flat)](https://travis-ci.org/kgellci/Shift)

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

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

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

![Shift_gif.gif](README/Shift_gif.gif)

![handle_logo_gradient.gif](README/handle_logo_gradient.gif)

Inspired by Pastel: https://github.com/cruisediary/Pastel

Shift allows you to do gradient color animations on your UI using either a timed animation or the device tilting motion.

You can also easily mask the gradient animation to images or text.  Couple this with the motion based animation and 

you will get an effect similar to the Robinhood app.

## Example

To run the example project, clone the repo, and run `pod install` from the Example directory first.

```swift

let view = ShiftView()

// set colors

view.setColors([UIColor.orange,

UIColor.red,

UIColor.blue,

UIColor.purple])

// set animation duration

view.animationDuration(3.0)

// start animation

view.startTimedAnimation()

```

You can also start a motion based animation. The device accelerometer is used to shift the color as the device is tilted.

Note that accelerometers are not available is the simulator.

```swift

view.startMotionAnimation()

```

You can instantate a Button and animate the gradient color on the text only

This is similar to the gold reflection animations in the Robinhood app

![shift_gold_gif.gif](README/shift_gold_gif.gif)

```swift

let button = ShiftButton()

button.setTitle("Hello!", for: .normal)

// Custom gradient direction

button.start(shiftPoint: .topLeft)

button.end(shiftPoint: .bottomRight)

// Show the gradient on the text only

button.maskToText = true

button.startMotionAnimation()

```

Here is a list of available UI Classes

```swift

ShiftView()

// maskable to text or image

ShiftButton()

ShiftLabel()

// Maskable to text

ShiftMaskableLabel()

ShiftTextfield()

ShiftTextView()

// Maskable to image

ShiftImageView()

```

Each UI class has an Objective-C equivalent, just add _Objc to the class name, ShiftView_Objc

## Requirements

Swift 4.0, iOS 8.  Compatible with Obj-c

## Installation

Shift is available through [CocoaPods](http://cocoapods.org). To install

it, simply add the following line to your Podfile:

```ruby

pod "Shift"

```

## Author

kgellci, [email protected], @kgellci

## License

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