Ecosyste.ms: Awesome

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

https://github.com/mergesort/TableFlip

A simpler way to do cool UITableView animations! (╯°□°）╯︵ ┻━┻
https://github.com/mergesort/TableFlip

animation ios uitableview

Last synced: about 2 months ago
JSON representation

A simpler way to do cool UITableView animations! (╯°□°）╯︵ ┻━┻

Lists

README 

        
# TableFlip



### (╯°□°）╯︵ ┻━┻



### ┬──┬ ノ( ゜-゜ノ)

---



[![Pod Version](https://img.shields.io/badge/Pod-1.1-6193DF.svg)](https://cocoapods.org/)

![Swift Version](https://img.shields.io/badge/Swift-4.2-brightgreen.svg)

![License MIT](https://img.shields.io/badge/License-MIT-lightgrey.svg) 

![Plaform](https://img.shields.io/badge/Platform-iOS-lightgrey.svg)



### Animations are cool. UITableView isn't. So why not make animating UITableView cool?



---



##### The entire API for TableFlip consists of an animation, and a call to animate. It's as simple as that.



##### TableFlip takes the annoying nature of reloading UITableViews, maintaining state, and anminating, and minimizes it to two lines of code.



##### If you want to animate every cell consecutively, the code will look like this.



```swift

self.tableView.reloadData()

self.tableView.animate(animation: myCoolCellAnimation)

```



##### And if you want to animate the entire table view at once, the code will look like this: 



```swift

self.tableView.reloadData()

self.tableView.animate(animation: myCoolTableAnimation)

```



Animations are completely customizable and configurable. TableFlip provides a few built-in defaults that work nicely out the box, if you don't want to make your own.



## Let's look at some examples



### Animating from the left with a nice staggered effect:



```swift

TableViewAnimation.Cell.left(duration: 0.5)

```



![](gifs/left.gif)



### Pushing from the top can make a nice initial loading effect:



```swift

TableViewAnimation.Table.top(duration: 0.8)

```



![](gifs/top.gif)



### A simple fade is always elegant:



```swift

TableViewAnimation.Cell.fade(duration: 1.0)

```



![](gifs/fade.gif)



### And you can make your own transform, as fun or weird as you want by using CGAffineTransform:



```swift

let degrees = sin(90.0 * CGFloat.pi/180.0)

let rotationTransform = CGAffineTransform(rotationAngle: degrees)

let flipTransform = CGAffineTransform(scaleX: -1, y: -1)

let customTransform = rotationTransform.concatenating(flipTransform)



let customAnimation = TableViewAnimation.Cell.custom(duration: 0.6, transform: customTransform, options: .curveEaseInOut)

                

self.tableView.animate(animation: customAnimation, completion: nil)

```



![](gifs/custom.gif)



## Requirements



- iOS 8.0+

- Xcode 10.0+

- Swift 4.2



## Installation

You can use [CocoaPods](http://cocoapods.org/) to install `TableFlip` by adding it to your `Podfile`:



```ruby

platform :ios, '8.0'

use_frameworks!



pod 'TableFlip'

```



Or install it manually by downloading `UITableView+Animations.swift` and dropping it in your project.



## About me



Hi, I'm [Joe](http://fabisevi.ch) everywhere on the web, but especially on [Twitter](https://twitter.com/mergesort).



## License



See the [license](LICENSE) for more information about how you can use TableFlip.



## P.S.



If all you liked was the kitty, that's my baby Gif. Feel free to follow her on the [Instagram](https://www.instagram.com/gifthecat).