How do I chain animations with delays in JHChainableAnimations?

Use the 'thenAfter(t)' method to sequence animations and 'wait(t)' or 'delay(t)' for pauses within a chain. For example, animator.moveX(50).thenAfter(1.0).rotateZ(90).animate(0.5) chains a move and rotate with a delay.

Can JHChainableAnimations be used with SwiftUI?

No, JHChainableAnimations is built for UIKit and tvOS apps, not SwiftUI. It relies on UIView-based animations and does not integrate with SwiftUI's declarative framework.

What's better for complex animations: JHChainableAnimations or Core Animation?

JHChainableAnimations simplifies complex sequences with a readable chainable syntax, while Core Animation offers lower-level control. Choose JHChainableAnimations for maintainability but be aware it adds abstraction over Core Animation.

How to animate a view along a bezier path?

Create a UIBezierPath, add points or curves, and use the 'moveOnPath(path)' chainable property. Note that animation effects like spring cannot be applied to these path movements.

Is JHChainableAnimations compatible with Auto Layout?

Yes, but with limitations. Use the transform-specific properties (e.g., transformX) for Auto Layout views, and avoid mixing them with other animations to prevent issues, as warned in the README.

How do I repeat an animation multiple times?

Use the 'repeat(time, count)' method in the chain or 'animateWithRepeat(time, count)' for the last part. For instance, animator.makeScale(2.0).repeat(0.5, 3) repeats the scale animation three times.

What easing functions are available?

The library includes various easing functions like spring, bounce, easeIn, and easeOut, based on jQuery easing. These can be applied to most animations except bezier path movements.

Open-Awesome

JHChainableAnimations

MITObjective-C

A library for creating easy-to-read and write chainable animations in Objective-C and Swift for iOS/tvOS.

GitHub

3.2k stars303 forks0 contributors

What is JHChainableAnimations?

JHChainableAnimations is an iOS/tvOS animation library that provides a chainable API for creating complex, multi-step animations with a clean, readable syntax. It solves the problem of verbose and nested animation code in Objective-C and Swift by allowing developers to combine movements, transforms, and effects into a single fluent chain.

Target Audience

iOS and tvOS developers who need to create sophisticated, sequenced animations in their apps and want a more maintainable alternative to Core Animation or UIView animation blocks.

Value Proposition

Developers choose JHChainableAnimations for its intuitive chainable syntax that drastically reduces code complexity, its support for advanced features like easing effects and bezier paths, and its seamless compatibility with both Objective-C and Swift projects.

Overview

Easy to read and write chainable animations in Objective-C and Swift

Use Cases

Best For

Creating complex, multi-step animations with a clean syntax
Adding spring, bounce, or custom easing effects to UIView animations
Animating views along bezier paths in iOS apps
Building animations that require pausing, resuming, or repeating
Improving readability of animation code in Objective-C or Swift projects
Animating Auto Layout-constrained views with transform properties

Not Ideal For

Projects requiring spring or bounce effects on bezier path animations
Apps where Auto Layout constraints need mixed transform and non-transform animations in a single chain
Teams developing for macOS or cross-platform beyond iOS/tvOS
Developers seeking a single, unified framework for both Objective-C and Swift without separate setups

Pros & Cons

Pros

Clean Chainable Syntax

Transforms verbose, nested animation blocks into a single, readable line of code, as shown in the README comparison reducing multiple UIView animations to one chain.

Dual Language Support

Provides native frameworks for both Objective-C and Swift, with a separate Swift framework offering a more idiomatic syntax for smoother integration.

Advanced Animation Control

Includes pause/resume functionality, repeat animations with counts, and pre/post-animation hooks, allowing fine-grained timing and execution management.

Auto Layout Transform Properties

Offers specific chainable properties like transformX and transformScale that are designed to work correctly with Auto Layout-constrained views, as noted in the usage section.

Cons

Bezier Path Effect Limitations

The README explicitly states that animation effects such as spring or easeIn do not work on bezier path movements, restricting stylistic options for path-based animations.

Auto Layout Usage Restrictions

Developers must use separate transform properties and avoid mixing them with other chainable animations for Auto Layout views, which can lead to confusion and potential bugs.

Separate Framework Management

Requires handling two distinct frameworks (JHChainableAnimations for Objective-C and ChainableAnimations for Swift), adding overhead to dependency setup and maintenance.

Frequently Asked Questions

Related Projects

Lottie

An iOS library to natively render After Effects vector animations

Stars26,766

Forks3,834

Last commit29 days ago

ViewAnimator

ViewAnimator brings your UI to life with just one line

Stars7,326

Forks487

Last commit2 years ago

AnimatedCollectionViewLayout

A UICollectionViewLayout subclass that adds custom transitions/animations to the UICollectionView without effecting your existing code.

Stars4,861

Forks347

Last commit5 years ago

Advance

Physics-based animations for iOS, tvOS, and macOS.

Stars4,473

Forks204

Last commit4 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub