Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/shtnkgm/ImageTransition

Library for smooth animation of images during transitions.
https://github.com/shtnkgm/ImageTransition

animation imagetransition ios swift

Last synced: about 1 month ago
JSON representation

Library for smooth animation of images during transitions.

Host: GitHub
URL: https://github.com/shtnkgm/ImageTransition
Owner: shtnkgm
License: mit
Archived: true
Created: 2018-09-19T11:08:27.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2022-09-18T15:51:38.000Z (over 2 years ago)
Last Synced: 2024-12-08T14:02:38.863Z (about 1 month ago)
Topics: animation, imagetransition, ios, swift
Language: Swift
Homepage:
Size: 26 MB
Stars: 220
Watchers: 7
Forks: 16
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-ios - ImageTransition - ImageTransition is a library for smooth animation of images during transitions. (UI / Transition)
awesome-swift - ImageTransition - ImageTransition is a library for smooth animation of images during transitions. (Libs / UI)
awesome-swift - ImageTransition - ImageTransition is a library for smooth animation of images during transitions. (Libs / UI)
awesome-ios-star - ImageTransition - ImageTransition is a library for smooth animation of images during transitions. (UI / Transition)
fucking-awesome-swift - ImageTransition - ImageTransition is a library for smooth animation of images during transitions. (Libs / UI)
awesome-swift - ImageTransition - Library for smooth animation of images during transitions. ` 📝 4 months ago` (UI [🔝](#readme))

README

        # ImageTransition

[![Cocoapods](https://img.shields.io/cocoapods/v/ImageTransition.svg)](https://github.com/shtnkgm/ImageTransition)

[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

[![Swift Version](https://img.shields.io/badge/Swift-5.5-F16D39.svg)](https://developer.apple.com/swift)

[![GitHub](https://img.shields.io/github/license/shtnkgm/ImageTransition.svg)](https://github.com/shtnkgm/ImageTransition/blob/master/LICENSE)

**ImageTransition** is a library for smooth animation of images during transitions.

Something looks like below:

|e.g. UIImageView|e.g. UIImageView in UICollectionView|

|:---:|:---:|

| | |

## Feature

 - [x] Transition zooming animation like the iOS Photos app and the "Pinterest", and so on

 - [x] Easy to use (conform to `ImageTransitionable` protocol)

 - [x] Swifty (protocol-oriented)

 - [x] Animation configuration customizable (animation duration, UIView.AnimationOptions)

 - [x] CornerRadius animation (e.g. from a round image to a square Image)

## Installation

 - Swift Package Manager: `https://github.com/shtnkgm/ImageTransition.git`

 - Carthage: `github "shtnkgm/ImageTransition"` 

 - CocoaPods: `pod "ImageTransition"`

## Usage

 - Confirm `ImageTransitionable` protocol

```swift

// Source UIViewController

import ImageTransition

extension SourceViewController: ImageTransitionable {

    var imageViewForTransition: UIImageView? {

        return imageView

    }

}

// Destination UIViewController

import ImageTransition

extension DestinationViewController: ImageTransitionable {

    var imageViewForTransition: UIImageView? {

        return imageView

    }

}

```

 - Set Delegate

```swift

    // present / dismiss transition

    @objc private func imageViewDidTapped() {

        let destinationViewController = DestinationViewController.make()

        destinationViewController.transitioningDelegate = ImageTransitionDelegate.shared

        present(destinationViewController, animated: true, completion: nil)

    }

    // push / pop transition

    @objc private func imageViewDidTapped() {

        let destinationViewController = DestinationViewController.make()

        // Set ImageTransitionDelegate.shared to `delegate` property of UINavigationContoller

        navigationController?.delegate = ImageTransitionDelegate.shared

        navigationController?.pushViewController(destinationViewController, animated: true)

    }

```

## Customize

You can customize the configuration of animation.

```swift

ImageTransitionDelegate.shared.presentDuration = 0.5

ImageTransitionDelegate.shared.dismissDuration = 0.5

ImageTransitionDelegate.shared.pushDuration = 0.5

ImageTransitionDelegate.shared.popDuration = 0.5

ImageTransitionDelegate.shared.presentAnimationOptions = [.curveLinear]

ImageTransitionDelegate.shared.dismissAnimationOptions = [.curveEaseIn]

ImageTransitionDelegate.shared.pushAnimationOptions = [.curveLinear]

ImageTransitionDelegate.shared.popAnimationOptions = [.curveEaseIn]

```

## Requirements

 - iOS 14.0 or later

## Contributing

Pull requests and stars are always welcome.

For bugs and feature requests, please create an issue.

1. Fork it!

2. Create your feature branch: git checkout -b my-new-feature

3. Commit your changes: git commit -am 'Add some feature'

4. Push to the branch: git push origin my-new-feature

5. Submit a pull request :D

## Author

 - [@shtnkgm](https://github.com/shtnkgm) / Shota Nakagami [![Twitter](https://img.shields.io/twitter/follow/shtnkgm?style=social)](https://twitter.com/shtnkgm)

## License

ImageTransition is released under the MIT license. See [LICENSE](https://github.com/shtnkgm/ImageTransition/blob/master/LICENSE) for details.