TheAnimation
TheAnimation is Type-safe CAAnimation wrapper.
Introduction
For example, if you want to animate backgroundColor with CABasicAnimation, you need to consider type because fromValue property and so on are Any?.
If you use BasicAnimation of TheAnimation, you can animate backgroundColor without considering type! (AnimationKeyPaths.backgroundColor is AnimationKeyPath<CGColor> type.)
Usage
The way of making an animation is almost similar CAAnimation. But you need to use animation.animate(in:) method instead of using layer.add(_:forKey:).
let view = UIView()
let animation = BasicAnimation(keyPath: .opacity)
animation.fromValue = 0
animation.toValue = 1
animation.duration = 1
animation.animate(in: view)
animation.animate(in:) returns AnimaitonCanceller. You can cancel an animation with it.
let canceller = animation.animate(in: view)
canceller.cancelAnimation()
Example
To run the example project, clone the repo, and open Example directory.
Correspondence Table
| CAAnimation | TheAnimation |
|---|---|
| CAPropertyAnimation | PropertyAnimation |
| CABasicAnimation | BasicAnimation |
| CAKeyframeAnimation | KeyframeAnimation |
| CASpringAnimation | SpringAnimation |
| CATransition | TransitionAnimation |
| CAAnimationGroup | AnimationGroup |
Add new AnimationKeyPath
You can add AnimationKeyPath like this.
extension AnimationKeyPaths {
static let newKeyPath = AnimationKeyPath<CGFloat>(keyPath: "abcd")
}
Handle animation did Start / Stop
You can handle animation did Start with func setAnimationDidStart(handler:). In addition, you can handle animation did Stop with func setAnimationDidStop(handler:).
let view = UIView()
let animation = BasicAnimation(keyPath: .opacity)
animation.fromValue = 0
animation.toValue = 1
animation.duration = 1
animation.setAnimationDidStart {
// do something
}
animation.setAnimationDidStop { finished in
// do something
}
animation.animate(in: view)
Requirements
- Xcode 9.3
- iOS 9 or greater
- tvOS 9 or greater
- macOS 10.11 or greater
- Swift 4.2 (since 0.3.0)
Installation
Carthage
If you’re using Carthage, simply add TheAnimation to your Cartfile:
github "marty-suzuki/TheAnimation"
CocoaPods
TheAnimation is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod 'TheAnimation'
Author
marty-suzuki, [email protected]
License
TheAnimation is available under the MIT license. See the LICENSE file for more info.
112 Jun 17, 2022
361 Oct 12, 2022
352 Jan 3, 2023
1.9k Dec 30, 2022
25 Apr 28, 2022
2k Dec 31, 2022
74 Nov 24, 2022
708 Jun 29, 2022
632 Dec 7, 2022
147 Nov 24, 2022
2 Jun 3, 2022
11 Dec 27, 2022
9 Nov 23, 2022
2 Jun 29, 2022
3 Dec 18, 2022
3.1k Dec 28, 2022
3 Nov 4, 2022
3.1k Dec 28, 2022
0 Jan 18, 2022
118 Dec 3, 2022
36 Nov 20, 2022
31 Nov 3, 2022
36 Nov 20, 2022
1.2k Jan 8, 2023
38 Jan 3, 2023
0 Jan 23, 2022
3 Jan 31, 2022
64 Sep 2, 2022