Awesome
TransitionableTab
TransitionableTab makes it easy to animate when switching between tab .
<table> <tr> <td width="25%"> <center>Move</center> </td> <td width="25%"> <center>Scale</center> </td> <td width="25%"> <center>Fade</center> </td> <td width="25%"> <center>Custom</center> </td> </tr> <tr> <td width="25%"> <img src="Resource/move.gif"></img> </td> <td width="25%"> <img src="Resource/scale.gif"></img> </td> <td width="25%"> <img src="Resource/fade.gif"></img> </td> <td width="25%"> <img src="Resource/custom.gif"></img> </td> </tr> </table>Contents
Requirements
- iOS 8.0+
- Xcode 9.0+
- Swift 4.2 (use version 0.1.3 for Swift 4.0)
Installation
CocoaPods
CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:
$ gem install cocoapods
CocoaPods 1.1+ is required to build TransitionableTab 4.2+.
To integrate TransitionableTab into your Xcode project using CocoaPods, specify it in your Podfile
:
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!
target '<Your Target Name>' do
pod 'TransitionableTab', '~> 0.2.0'
end
Then, run the following command:
$ pod install
Carthage
Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.
You can install Carthage with Homebrew using the following command:
$ brew update
$ brew install carthage
To integrate TransitionableTab into your Xcode project using Carthage, specify it in your Cartfile
:
github "Interactive-Studio/TransitionableTab" ~> 0.2.0
Run carthage update
to build the framework and drag the built TransitionableTab.framework
into your Xcode project.
Manually
If you prefer not to use either of the aforementioned dependency managers, you can integrate TransitionableTab into your project manually.
Preview
<img src="Resource/all.gif" width="300">Usage
The usage of TransitionableTab is very simple
import TransitionableTab
class TabBarController: UITabBarController {
override func viewDidLoad() {
super.viewDidLoad()
self.delegate = self
}
}
extension TabBarController: TransitionableTab {
func tabBarController(_ tabBarController: UITabBarController, shouldSelect viewController: UIViewController) -> Bool {
return animateTransition(tabBarController, shouldSelect: viewController)
}
}
Custom
public protocol TransitionableTab: UITabBarControllerDelegate {
func transitionTimingFunction() -> CAMediaTimingFunction
func transitionDuration() -> CFTimeInterval
func fromTransitionAnimation(layer: CALayer, direction: Direction) -> CAAnimation
func toTransitionAnimation(layer: CALayer, direction: Direction) -> CAAnimation
}
If you want to know more detailed usage, please refer to Example.
Communication
- If you found a bug, open an issue.
- If you have a feature request, open an issue.
- If you want to contribute, submit a pull request.
Credits
- GwangBeom Park (@gwangbeom)
License
TransitionableTab is released under the MIT license. See LICENSE for details.