Twitter Travis Carthage compatible CocoaPods CocoaPods CocoaPods codebeat badge


This project is maintained by Ramotion, Inc.
We specialize in the designing and coding of custom UI for Mobile Apps and Websites.

Looking for developers for your project?

StackViewController Example App

The iPhone mockup available here.

Try this UI control in action


  • iOS 9.0+
  • Xcode 8


Preview-transition is released under the MIT license. See LICENSE for details.


Just add the Source folder to your project or use CocoaPods like this:

pod "PreviewTransition", "~> 2.0.1" swift 3

pod "PreviewTransition", "~> 1.1.5" swift 2

or Carthage users can simply add to their Cartfile:

github "Ramotion/preview-transition"


1) import PreviewTransition

2) Create UITableViewController inherit, inheriting from PTTableViewController

3) Add UITableViewDelegate methods

public override func tableView(tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
    return <RowsCount>

public override func tableView(tableView: UITableView, cellForRowAtIndexPath indexPath: NSIndexPath) -> UITableViewCell {
    return tableView.dequeueReusableCellWithIdentifier(<CellIdentifier>, forIndexPath: indexPath)

4) add a ParallaxCell

storyboards: create a cell and inherit from ParallaxCell; don’t forget set the identifier <CellIdentifier>

or programmatically: register a cell in viewDidLoad tableView.registerClass(ParallaxCell, forCellReuseIdentifier:<CellIdentifier>)

5) set cell height

6) create image names (image sizes must be equal to screen size or bigger)

let images = [image_name, image_name, image_name, image_name, image_name] // image names

7) set image and text for ParallaxCell

public override func tableView(tableView: UITableView, willDisplayCell cell: UITableViewCell, forRowAtIndexPath indexPath: NSIndexPath) {

    guard let cell = cell as? ParallaxCell else {

    let imageName = images[indexPath.row]

    if let image = UIImage(named: imageName) {
      cell.setImage(image, title: <SetText>)

your tableViewController should look like DemoTableViewController

Method public override func tableView(tableView: didSelectRowAtIndexPath indexPath:) we will add later. (step 10)

8) Create UIViewController, inheriting from PTDetailViewController

9) Add action for backButton and call popViewController()

func backButtonHandler() {

10) Push this UIViewController in UITableViewController. Add method

public override func tableView(tableView: UITableView, didSelectRowAtIndexPath indexPath: NSIndexPath) {

  // create viewController
  let <YourViewController> = storyboard?.instantiateViewControllerWithIdentifier(<identifier>)
  if case let viewController as <YourViewController> = viewController {

11) Configure UINavigationBar

// transparent background
UINavigationBar.appearance().setBackgroundImage(UIImage(), forBarMetrics: .Default)
UINavigationBar.appearance().shadowImage = UIImage()
UINavigationBar.appearance().translucent = true
UINavigationBar.appearance().tintColor = .whiteColor()

// set font
if let font = UIFont(name: <Font name> , size: 18) {
      UINavigationBar.appearance().titleTextAttributes = [
        NSForegroundColorAttributeName : UIColor.whiteColor(),
        NSFontAttributeName : font

Follow us

Twitter URL Twitter Follow

Related Repositories



PreviewTransition is a simple preview gallery controller ...

Top Contributors

ober01 Juriv aleksei1000000 BasThomas RamotionRussell


-   1.1.5 zip tar
-   1.1.4 zip tar
-   1.1.3 zip tar
-   0.1.2 zip tar
-   0.1.1 zip tar
-   0.1.0 zip tar
-   0.0.5 zip tar
-   0.0.4 zip tar
-   0.0.3 zip tar
-   0.0.2 zip tar
-   0.0.1 zip tar