How to use ImageTransition with a UICollectionView?

Conform both source and destination view controllers to ImageTransitionable, setting imageViewForTransition to the tapped cell's image view. For push/pop transitions, assign ImageTransitionDelegate.shared as the UINavigationController's delegate, as per the README.

Can ImageTransition work with SwiftUI?

No, ImageTransition is built for UIKit and does not natively support SwiftUI. To use it in a SwiftUI project, you'd need to wrap UIKit view controllers in UIViewControllerRepresentable, which adds complexity.

How to change the animation speed in ImageTransition?

Customize the duration properties like presentDuration or dismissDuration on ImageTransitionDelegate.shared, as shown in the README's customization section, to adjust animation timing for different transition types.

ImageTransition vs Hero: which is better for iOS?

ImageTransition is specialized for simple, Photos-like image zoom transitions with minimal setup, while Hero is a general-purpose library for complex animations. Choose ImageTransition for focused image effects and Hero for broader animation needs.

Why isn't my ImageTransition animation working in a navigation controller?

Ensure ImageTransitionDelegate.shared is set as the delegate of the UINavigationController, not just the view controller, and that both source and destination conform to ImageTransitionable with correct imageView assignments.

Does ImageTransition support multiple images or async loading?

No, it's designed for single image transitions between two view controllers. For multiple images or async loading, you must preload images or implement custom logic, as the library relies on the UIImageView's image property.

Open-Awesome

ImageTransition

MITSwift0.5.2

A Swift library for smooth zooming animations of images during view controller transitions, inspired by iOS Photos and Pinterest.

GitHub

221 stars15 forks0 contributors

What is ImageTransition?

ImageTransition is a Swift library that provides smooth zooming animations for images during view controller transitions in iOS apps. It solves the problem of creating visually engaging transitions between image views, similar to the effects seen in the iOS Photos app and Pinterest. The library simplifies the implementation of these animations with a protocol-oriented design.

Target Audience

iOS developers building apps with image galleries, product catalogs, or any interface requiring polished transitions between image views. It's particularly useful for those aiming to replicate the smooth zoom animations found in popular iOS applications.

Value Proposition

Developers choose ImageTransition for its ease of use, customizable animation parameters, and ability to create professional-grade transitions with minimal code. Its protocol-oriented approach aligns with modern Swift best practices, making it a lightweight and efficient solution.

Overview

Library for smooth animation of images during transitions.

Use Cases

Best For

Implementing Pinterest-style zoom transitions in image galleries
Creating smooth image animations between view controllers in iOS apps
Building photo viewer apps with iOS Photos-like transition effects
Animating corner radius changes during image transitions
Adding polished visual feedback when tapping on images in UICollectionView or UITableView
Customizing animation timing and curves for image-based transitions

Not Ideal For

Apps requiring complex, multi-element animations beyond simple image zooming
Projects targeting iOS versions below 14.0 that need backward compatibility
Teams seeking a drag-and-drop animation library with no code integration or UIKit dependencies

Pros & Cons

Pros

Protocol-Oriented Design

Built with Swift's protocol-oriented programming, offering a clean, Swifty API that aligns with modern iOS development best practices, as highlighted in the README.

Easy Integration

Requires only conforming to the ImageTransitionable protocol and setting a delegate, enabling transitions with minimal code, as demonstrated in the usage examples.

Customizable Animations

Allows adjustment of animation duration and UIView.AnimationOptions for present, dismiss, push, and pop transitions, providing fine control over timing and effects.

Corner Radius Animation

Supports animating changes in image corner radius, such as from round to square, adding polish to transitions, a feature specifically listed in the key features.

Cons

iOS Version Limitation

Requires iOS 14.0 or later, excluding support for older devices and apps that must maintain compatibility with earlier iOS versions.

Limited to Image Transitions

Focuses solely on image-based zoom animations, making it unsuitable for projects needing transitions involving other UI elements or more complex animations.

Manual Delegate Setup

Requires setting the transitioningDelegate or navigationController delegate manually, which can add boilerplate code and potential for errors if not configured correctly.

Frequently Asked Questions

Related Projects

Hero

Elegant transition library for iOS & tvOS

Stars22,488

Forks1,727

Last commit1 year ago

Cards

Awesome iOS 11 appstore cards in swift 5.

Stars4,201

Forks270

Last commit3 years ago

StarWars.iOS

This component implements transition animation to crumble view-controller into tiny pieces.

Stars3,760

Forks356